readme.htm

是TCL的另外一个编译（解释）器

the "use folder name" option, thus the subdirectories will be created 
accordingly. I recommend </span><span lang="EN-GB" style="mso-ansi-language:EN-GB"><a href="http://www.powerarchiever.com/">Power 
Archiever 2000</a></span><span lang="EN-GB" style="mso-ansi-language:EN-GB"> 
or Winzip. To start ASED double click the file ased.tcl. During the first start 
ASED will install a config file &quot;ased.cfg&quot; in your Home Directory, 
which will hold your chosen options.<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Linux (Unix):<br>
Unpack the tar.gz file to a directory of your choice. To run ASED you have to 
start the ased file.<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">After unpacking 
the downloaded file your installation-directory (i.e. ~/ASED) should contain 
two subdirectories: (~/ASED/BWidget-1.2.1 and ~/ASED/images.<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Short Introduction: 
<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Sorry, but 
I still haven&acute;t got the time to write a documentation, so in the following 
I&acute;ll give you a short introduction to some parts. Though I tried to make 
ASED very intuitive and easy to use, some remarks may help to better understand, 
how ASED works. <o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB"><a name="test">1. 
Testing Code </a></span><span lang="EN-GB" style="mso-ansi-language:EN-GB"><br>
If you press the TEST button, ASED executes always the content of the current 
editor window (not the opened file!). This enables you to make changes and test 
it without the need of storing before or making backups. On the other hand, 
if you save the content of an editor window to a file, the current file will 
be copied to a *~ file before the content of the editor window is stored to 
that file. This enables you, to restore always the latest version of a file. 
By pressing the TEST-Button, ASED either starts a slave interpreter to execute 
the code or if you have activated the option &quot;use eval server&quot; in 
the TEST menu an eval-server will be started and your code will run within a 
separate wish instance. This is the preferred method for unstable code, cause 
ASED itself can&acute;t crash this way. You can choose the wish, the server 
should run via the TEST Menu. In addition it always automatically loads Tk. 
It is possible to start several applications at the same time. The running application 
could be terminated via the STOP-Button, even if you see the &quot;watch&quot;-cursor. 
However, this may fail, if your application runs in some kind of an infinite 
loop and never returns to the eventloop of tcl. So if you run your code via 
the server, you could simply kill the hanging app by the operating system (ie. 
kill command) and ASED will still work. By pressing the STOP-Button the slave 
interpreter of the current editor window will be destroyed. <o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">You can also 
edit and test extensions without the need to load the main application into 
an editor window by associating a startfile to that extension file or to define 
a default startfile via the test menu. If you have defined a startfile and press 
the TEST-Button, this startfile will be executed (instead of starting the content 
of the current editor window). Though in this case also the content of the editor 
window will be executed. <o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">If you run 
your programs via the eval server, there will be an additional page in the Bottom 
Window, which will show you the output of your program. In addition you can 
enter any valid command at runtime, which then will be executed within your 
app. IE. typing &quot;info vars&quot; will show you all vars of your app (from 
a global scope). You can also set vars or overwrite procs from within that window, 
while your app is running. This might be quite helpful for debugging.<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">To start 
your program with additional args you can key in additional args in the right 
combobox within the toolbar.<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">&nbsp;<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB"><a name="console">2. 
Console</a></span><span lang="EN-GB" style="mso-ansi-language:EN-GB"><br>
Since there is typically no console available under windows, the output of &quot;puts&quot; 
commands is redirected to ASED&acute;s console window. So this can be used for 
easy debugging via including &quot;puts&quot; commands in the code, like it 
is possible under UNIX. But this currently doesn&acute;t work for slave interpreters.<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB"><a name="sourcecode">3. 
Sourcecode Navigation </a></span><span lang="EN-GB" style="mso-ansi-language:
EN-GB"><br>
To enable fast sourcecode navigation there are included: <o></o></span>
<ul type="disc" class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l8 level1 lfo1;tab-stops:list 36.0pt">
    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l8 level1 lfo1;tab-stops:list 36.0pt"><div
     align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Code Browser 
    Window<br> this shows you all the procs, namespaces, classes methods and 
    so on in a tree structure. Clicking on a node will bring you at once to 
    the corespondent code line. <o></o></span> </div>
    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l8 level1 lfo1;tab-stops:list 36.0pt"><div
     align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">History 
    Buttons (at the bottom of the Code Browser)<br> By clicking &quot;Next&quot; 
    or &quot;Prev&quot; arrow, ASED will bring you to the previous edited code 
    lines. But the history will always store only one position per proc. <o></o></span> 
    </div>
    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l8 level1 lfo1;tab-stops:list 36.0pt"><div
     align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Goto Line 
    Combobox<br> This will always show the current line. By pressing the button 
    right from the line entry field, ASED stores this value in the line history. 
    You can also enter a line number and press that button to go to a code line. 
    To jump back open the history, chose a line and press the button. ASED 2.0 
    allows now also entering relative line numbers like &quot;+10&quot;. <o></o></span> 
    </div>
    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l8 level1 lfo1;tab-stops:list 36.0pt"><div
     align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Quick Search<br> 
    To search in an opened file just enter a string in the left combobox of 
    the toolbar and press ENTER. Clicking on the arrows will search (again) 
    forwards or backwards. For an extended search use the Find-Button within 
    the toolbar. <o></o></span> </div>
</ul>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB"><a name="popup">4. 
Popup Menus</a></span><span lang="EN-GB" style="mso-ansi-language:EN-GB"><o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Just try 
clicking the right mouse button in the editor or the code browser window and 
have a look at these menus.<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Note: When 
clicking the &quot;Auto indent selection&quot; without having selected anything, 
this will autoindent the whole file. During Autoindention all tabs are replaced 
by 4 spaces.<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB"><a name="highlight">5. 
Highlighting correspondent braces, parenthesis and brackets</a></span><span lang="EN-GB"
 style="mso-ansi-language:EN-GB"><o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">To highlight 
a correspondent brace, parenthesis or bracket click just before that char and 
the correspondent one will be highlighted.<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB"><a name="grep">6. 
Using the graphical &quot;grep&quot;</a></span><span lang="EN-GB" style="mso-ansi-language:
EN-GB"><o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Choosing 
&quot;Search in files..&quot; in the Edit menu will open a dialog window where 
you can enter settings for searching complete directories for code. The founded 
lines are shown in a result window. A single click on an entry in the result 
window will open the file (if not already opened) and bring you immediately 
to that line in the code.<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB"><a name="cursor">7. 
Reset &quot;watch cursor&quot;</a></span><span lang="EN-GB" style="mso-ansi-language:
EN-GB"><o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">If an error 
occures through testing of a piece of code, sometimes the cursor remains as 
a &quot;watch cursor&quot;. You can &quot;reset&quot; the cursor to the normal 
arrow via clicking on the STOP Button.<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB"><a name="eval">8. 
evalClient and evalServer</a></span><span lang="EN-GB" style="mso-ansi-language:EN-GB"><o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">evalClient.tcl 
and evalServer.tcl can be run as a standalone application , thus providing a 
framework for a client server application. When you start evalClient.tcl, it 
will start the evalServer too. EvalClient.tcl provides a simple terminal, through 
which you can eval commands or even run tcl-applications. If you run an application, 
you should see it&acute;s output in the terminal. The code is sent to the server, 
which executes every command sent by the terminal. By this mean you can key 
in any command while your application runs. After pressing RETURN it will be 
executed in the scope of your application. So you might want to examine variables 
(i.e. info vars), call a specific proc or set a specific variable in your application 
at runtime.<o></o></span></p>
<h4 align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB"><a name="hotkeys">9. 
Hotkeys</a></span><span lang="EN-GB" style="mso-ansi-language:EN-GB"><o></o></span></h4>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Ctrl-c: copy<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Ctrl-x: cut<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Ctrl-v: paste<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Ctrl-y: delete 
current line<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Ctrl-l: repeat 
last search (please note, that this doesn&acute;t work with the Quick-Search 
combo in the toolbar, but if using the find dialog (via toolbar button)<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Note: If 
the focus is on an entry field, you can simply hit the RETURN-key to activate 
the function (i.e. Quicksearch)<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">&nbsp;<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">&nbsp;<o></o></span></p>
<p align="center"><hr> </p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB"><a name="disclaimer">DISCLAIMER 
and License Issues</a></span><span lang="EN-GB" style="mso-ansi-language:EN-GB"><o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">ASED Tcl/Tk 
- IDE is copyrighted by Andreas Sievers <o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">This program 
is free software; you can redistribute it and/or modify it under the terms of 
the GNU General Public License as published by the Free Software Foundation; 
either version 2 of the License, or (at your option) any later version.<o></o></span></p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">This program 
is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; 
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
PURPOSE. See the </span><span lang="EN-GB" style="mso-ansi-language:EN-GB"><a href="gpl.htm">GNU 
General Public License</a></span><span lang="EN-GB" style="mso-ansi-language:
EN-GB"> 
for more details.<o></o></span></p>
<p align="center"><hr> </p>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB"><a name="changes">CHANGES</a></span><span
 lang="EN-GB" style="mso-ansi-language:EN-GB"><o></o></span></p>
<p>Version 2.0.9.7 dated 11/10/02 
<ul type="disc">
    <li>Bugfix: Communicationproblem between evalClient and evalServer fixed. 
    
    <li>Added italian language file 
</ul>
<p>Version 2.0.9.6 dated 08/14/02 
<ul type="disc">
    <li>Bugfix: restarting applications within ASED. 
</ul>
<p>Version 2.0.9.5 dated 06/30/02 
<ul type="disc">
    <li>Added cls command for the Consolewindow to clear it 
    <li>Bugfix: throws errors again when USE EVAL SERVER is unchecked. 
    <li>Added Template directory with Application Framework. Additional Templates 
    will come soon 
    <li>Support of Bwidget 1.4.0 
</ul>
<p align="left"><span lang="EN-GB" style="mso-ansi-language:EN-GB">Version 2.0.9 
dated 03/24/02<o></o></span></p>
<p align="left" style="text-indent:-18pt; margin-left:36pt; mso-list:l6 level1 lfo11;
tab-stops:list 36.0pt"><![if><span
 lang="EN-GB" style="font-family:
Symbol;mso-ansi-language:EN-GB">&middot;</span><span
 style='font:7.0pt &quot;Times New Roman&quot;'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
</span><![endif]><span lang="EN-GB" style="mso-ansi-language:EN-GB">Added native 
language support<o></o></span></p>
<p align="left" style="text-indent:-18pt; margin-left:36pt; mso-list:l6 level1 lfo11;
tab-stops:list 36.0pt"><![if><span
 lang="EN-GB" style="font-family:
Symbol;mso-ansi-language:EN-GB">&middot;</span><span
 style='font:7.0pt &quot;Times New Roman&quot;'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
</span><![endif]><span lang="EN-GB" style="mso-ansi-language:EN-GB">Bugfix for 
opening several new (untitled) files. Untitled files are now numbered.<o></o></span></p>
<p align="left" style="text-indent:-18pt; margin-left:36pt; mso-list:l6 level1 lfo11;
tab-stops:list 36.0pt"><![if><span
 lang="EN-GB" style="font-family:
Symbol;mso-ansi-language:EN-GB">&middot;</span><span
 style='font:7.0pt &quot;Times New Roman&quot;'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
</span><![endif]><span lang="EN-GB" style="mso-ansi-language:EN-GB">Session 
Save &amp; Restore<o></o></span></p>
<p align="left" style="text-indent:-18pt; margin-left:36pt; mso-list:l6 level1 lfo11;
tab-stops:list 36.0pt"><![if><span
 lang="EN-GB" style="font-family:
Symbol;mso-ansi-language:EN-GB">&middot;</span><span
 style='font:7.0pt &quot;Times New Roman&quot;'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
</span><![endif]><span lang="EN-GB" style="mso-ansi-language:EN-GB">Support 
of Bwidget 1.3.1<o></o></span></p>
<p align="left">Version 2.0.8 dated 02/27/01