A.T.Edit - Another Tcl/Tk based text editor Copyright(C) 2004 Shinji Morino 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, or (at your option) any later version. 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 GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. For more details see the file COPYING. ---------------------------------------------------------------------------- Index 1. What's A.T.Edit 1.1 Features 1.2 Environment 1.3 Installation 1.4 Starting A.T.Edit 2.Operation Manual 2.0 What you can do with A.T.Edit 2.1 File menu 2.1.1 New 2.1.2 Open 2.1.3 Close and Open 2.1.4 Open at cursor 2.1.5 Save 2.1.6 Save as 2.1.7 Print 2.1.8 Quit 2.2 Edit menu 2.2.1 Undo 2.2.2 Cut 2.2.3 Copy 2.2.4 Paste 2.2.5 Find 2.2.6 Replace 2.2.7 Select All 2.2.8 Go to line 2.3 Translation menu 2.3.1 English to Japanese 2.3.2 Japanese to English 2.3.3 Dictionary 2.4 Insert menu 2.4.1 Date 2.4.2 Time 2.5 Option menu 2.5.1 Configuration 2.5.1.1 Appearance tab 2.5.1.2 Extension tab 2.5.1.3 Command tab 2.6 Help menu 2.6.1 About 2.7 Mark (Toolbar only) 2.7.1 Set mark 2.7.2 Goto mark 3. Restriction 3.1 Undo 3.2 Printing and translation 4. Misc 5. Feed back 6. Thanks ---------------------------------------------------------------------------- 1. What's A.T.Edit A.T.Edit is a text editor worked on X Window System and Microsoft Windows. It is developed by Tcl/Tk and distributed under the GNU General Public License Version 2. Note: BWidget is NOT a part of A.T.Edit and is NOT distributed under the GPL. I re-distribute BWidget with A.T.Edit under the license of BWidget itself. See also BWidget's home page. BWidget 1.1 Features o Common operation on both X Window system and Microsoft Windows. o Works as a front-end of IBM Japanese-English translation software. You can invoke external programs and commands for your translation. Note: You need a translation software. o Easy install You can install A.T.Edit easily by the Tcl/Tk based GUI installer. 1.2 Environment A.T.Edit is developed under the following environments. o Slackware 9.1 + Tcl/Tk 8.4.5 (+ IBM Japanese-English translation software for Linux) o Windows2000 Professional + ActiveTcl 8.4.5 o Windows XP Professional Edition + Tcl/Tk 8.3.1 1.3 Install A.T.Edit requires Tcl/Tk 8.3 or later (8.4 or later is recommended). If you use Linux,Tcl/Tk 8.3 may be already installed. If you use Windows, you may need to download the latest Tcl/Tk from http://www.scriptics.com/ and install it. Tcl/Tk 8.4 or later is required to use "Undo" feature of A.T.Edit. [Install Unzip atedit-x.y.zip. A direcotry 'atedit-x.y' will be created, then excute atedit-x.y/setup/(en|ja|it)/setup.tcl. [Windows] Double click setup.tcl, and the installer will start. [Unix] As user 'root', input as follows on your shell. # wish ./setup.tcl +---- Important ----------------------------------------------------- | [Windows] | All A.T.Edit users must have read/write permission to the | directory which configuration files will be put in. | [Unix] | Configuration files will be put in $HOME/.atedit. +-------------------------------------------------------------------- 1.4 Starting A.T.Edit [Windows] Exexute the file 'atedit.bat' (It is in the directory which A.T.Edit is installed). Or make a short-cut to 'atedit.bat' and double click it. [Unix] Input as follows on your shell: $ {PATH to installed directory}/atedit If you set the PATH to the directory which A.T.Edit is installed, you can start A.T.Edit only input: $ atedit Note: To set the PATH, add a line to your /.bashrc. # Imagine you installed A.T.Edit in /usr/local/lib/atedit. $ PATH = $PATH:/usr/local/lib/atedit The format is: # You can omit arguments braced with []. # A.T.Edit will be started as same number as specified files. atedit [options] [file file ..] ex) $ atedit $ atedit -width 80 -height 35 -king hoge.txt ==> Open the file 'hoge.txt' with the translation feature. A.T.Edit has 80 columns and 35 rows. Options are: o -lang (en|ja|it) Set the language of messages. ex) -lang en You can only specify 'en'(English), 'ja'(Japanese) and 'it'(Italian). o -width chars Set the columns. ex¡Ë-width 100 Default width is 80 chars. o -height rows Set the rows. ex¡Ë-height 30 Default height is 25 rows. o -tab tab width Set the tab width. ex) -tab 8 Default tab width is 4 chars. o -king Turn on the translataion feature. This option is valid on only Unix. o -noking Turn off the translataion feature. This option is valid on only Unix. ---------------------------------------------------------------------------- 2.Operation Manual 2.0 What you can do with A.T.Edit A.T.Edit has features as same as ordinally text editor, and does not have peculiar operations. 2.1 File menu 2.1.1 New Open a new window. 2.1.2 Open Open the specified file. If another file is already opened, then a new window will be open. 2.1.3 Close and Open Close the current file and open the new file. NOT open a new window. 2.1.4 Open at cursor Read the specified file after the cursor position. 2.1.5 Save Overwrite the current file. 2.1.6 Save as Save the current file with new file name. 2.1.7 Print Print out the current file. You need to set the print command. -- see also 2.5 Configuration. Default is: Windows ... Using notepad. (notepad.exe /p %s) Unix ... Using lpr command. (lpr %s) Note: A.T.Edit create a temporary file at first, then pass the file name to hte print command. 2.1.8 Quit Quit the A.T.Edit. 2.2 Edit menu 2.2.1 Undo Undo the previous operation. This feature requires Tcl/Tk 8.4 or later. 2.2.2 Cut Copy the selected text to the clipboard, and delete it from text area. You can paste the cut text using 2.2.4 Paste menu. 2.2.3 Copy Copy the selected text to the clipboard. You can paste the copied text using 2.2.4 Paste menu. 2.2.4 Paste Insert cut/copied text after the cursor position. 2.2.5 Find Serch strings from the current file. 2.2.6 Replace Replace strings in the current file. 2.2.7 Select All Set the full text selected. 2.2.8 Go to line Move the cursor spcified line. 2.3 Translation menu 2.3.1 English to Japanese Translate the selected text from Einglish to Japanese. A new windows will be opened to show the results. You need to set the translation command. -- see also 2.5 Configuration. 2.3.2 Japanese to English Translate the selected text from Japanese to Einglish. A new windows will be opened to show the results. You need to set the translation command. -- see also 2.5 Configuration. 2.3.3 Dictionary Look up the selected word. You need to set the look up command. -- see also 2.5 Configuration. A dialog will be raised to show the results. 2.4 Insert menu 2.4.1 Date Insert current date at the cursor. 2.4.2 Time Insert current time at the cursor. 2.5 Option menu 2.5.1 Configuration 2.5.1.1 Appearance tab You can configure: o Width and Height o Tab with o Background color, foreground color, cursor line's color, highlight color o Default language for menu and messages. 2.5.1.2 Extension tab You can register extensions as a filter of the file select dialog. 2.5.1.3 Command tab You can set: o Print command o Translation command (Unix only) o Look up command (Unix only) Note: o By 10th word are valid, after 11th word will be ignored. o '%s' in the command string will be replaced with the temporary file name which contains the target text. -- See alos 3.2 Printing and translation. ex) "notepad.exe /p %s" as print command: '%s' will be replaced temporary file name. ex) "cat %s | sed -e 's/hoge/foo/' | sort | lpr -P myPrinter" as print command: "cat %s | sed -e 's/hoge/foo/' | sort | lpr" is valid. '-P myPrinter' will be ignored. 2.6 Help menu 2.6.1 About Show the version information. 2.7 Mark (Toolbar only) You can set maximum 32 marks. If you set more than 32 marks, the oldest mark will be deleted. 2.7.1 Set mark Set a mark on the current cursor position. 2.7.2 Goto mark Move the cursor to the marked position. ---------------------------------------------------------------------------- 3. Restriction 3.1 Undo A.T.Edit uses 'Undo' function embedded the Tk widget (8.4 or later). You can't use 'Undo' feature under Tcl/Tk 8.3.x. 3.2 Printing and translation A.T.Edit write a temporary file which contains the selected text, and then pass the temporary file name to the specified command. The reason is: I remember that there is a restriction to the length of command line. (I don't know the correct length, but it may be 2048 chars on unix.) ---------------------------------------------------------------------------- 4. Misc You can get more information about A.T.Edit from the following URL. http://atedit.sourceforge.net/ http://www.asahi-net.or.jp/~wp7s-mrn/atedit.html (Japanese) ---------------------------------------------------------------------------- 5. Feed back Suggestions and bug reports are large welcome. Shinji Morino ---------------------------------------------------------------------------- 6. Thanks o Tcl/Tk developers o BWidget developers o GNOME and KDE developers -- A.T.Edit uses some icons. o Luca Francesconi - Translated to Italian language and added some features. o Everyone who is using, used, or interesting in A.T.Edit. ---------------------------------------------------------------------------- Shinji Morino