First version: 15 January 2003
Last updated for version 1.06: 20 December
2008
1.0 What is jText?
jText is a small freeware text editor written
in Personal Java. It will enable you to view and edit small text
files on your UIQ2 or UIQ3 phone. The latest version of the program
will always be available from http://www.freepoc.org.
1.1 Why use jText?
jText is free :-)) It provides an alternative to the in-built Jotter and Quickword applications. jText reads and writes standard ASCII text files.
1.2 Installing jText
Select the correct SIS file for your device (either UIQ2 or UIQ3) and follow your normal installation procedures.
1.3 Using jText
Select jText from the Applications list. Within jText, available menu options are:
File > Open. This will bring up a file selector and you can choose the text file to open. You can then edit the file using the keyboard or handwriting recognition as for the built-in applications.
File > Open (UIQ3). This will bring up a custom file selector and you can choose the text file to open. This option is provided because the standard File>Open routine on UIQ3 devices doesn't find non-text files, for example password-protected files.
File > Save. Saves the current file, using the same filename.
File > Save As. Allows you to save the current file with a different name.
File > Close. Closes the application. If the file has been edited, the program will prompt you to save it first.
The last four files edited in jText will also be shown at the bottom of the File menu
Edit > Cut. Cuts the selected text to the Clipboard.
Edit > Copy. Copies the selected text to the Clipboard
Edit > Paste. Pastes the contents of the Clipboard at the current position.
Edit > Select All. Selects all the current text.
Tools > Update. By default this is set to Yes. You can change it to No.
Tools > Word Wrap. By default this is set to Yes. You can change it to No.
Tools>Unicode. By default this is set to No. You can change it to Yes, in which case files will be saved in Unicode format.
Tools > Set password > Sets a document password - see below.
Tools > Preferences > Font type. By default this is set to Normal. You can change it to Bold.
Tools > Preferences > Line Terminator. By default this is set to Windows-style CRLF delimiters. You can change it to Linux/Unix-style LF delimiters.
Tools > Preferences > Large File Warning. Warns if you try to open a large file in jText. By default this is set to Yes.
Tools > Preferences > Large File Size.
Gives the size at which the warning occurs. By default this is set
to 10000.
1.4 Password protection
jText enables you to password-protect your
text files, using the same RC4 algorithm that is found in FreEPOC's jRC4
program. jText files which have been password-protected will always
have a name that ends in the character "#", for example "myfile.txt#".
It will also open encrypted files ending with the character "£".
You can set a password using the Tools>Set password option. Setting
a blank password removes the password protection. Text files which
have been password-protected in jText can be decrypted by jRC4 and vice
versa.
1.5 Known bugs
There is a bug in Symbian's UIQ2 Java implementation which causes a crash when the File Selector is used and the Browse button is tapped. This impacts jText's File>Open option. The workaround is to change the current directory using the directory drop-down and avoid using the Browse button altogether.
There is a bug in the UIQ3 Java implementation which prevents non-text files being displayed in the File>Open dialog. Use the File>Open(UIQ3) dialog instead.
On UIQ3 devices, the cursor can sometimes
end up in the wrong position after a Find or Replace.
Important note: jText works best
on small text files. Anything under 20K should be fine. Larger
sizes will work, but might be too slow to be satisfactory.
Malcolm Bryant
malcolm@freepoc.org