A.T.Edit - Another Tcl/Tk based text editor
Copyright(C) 2004 Shinji Morino <peace24@blue.email.ne.jp>
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 <http://www.sourceforge.net/projects/tcllib/>
1.1 Features
- Common operation on both X Window system and Microsoft Windows.
- 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.
- 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.
- Slackware 9.1 + Tcl/Tk 8.4.5 (+ IBM Japanese-English translation software for Linux)
- Windows2000 Professional + ActiveTcl 8.4.5
- 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 Danpei 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 <peace24@blue.email.ne.jp>
6. Thanks
- Tcl/Tk developers
- BWidget developers
- GNOME and KDE developers -- A.T.Edit uses some icons.
- Luca Francesconi<luca.francesconi@freesim.it>
- Translated to Italian language and added some features.
- Everyone who is using, used, or interesting in A.T.Edit.
Shinji Morino <peace24@blue.email.ne.jp>