-------------------------------------------------------------------------- Full Screen Text Editor T R E D Version 1.11 For PC-E500 / PC-1480U Programed By T.Kobayashi (Ryu) -------------------------------------------------------------------------- *** INTRODUCTION *** KNJSCRN (EXTSCRN) was released by E.Kako. EOLLA SYSTEM (EXTKYBD) was released by Asasora. With these programs I had thought we can write documents in Japanese-Kanji! But I realized that I have no text-editor for Kanji. (Some text-editors for non-Kanji were released.) So, I have developed this text-editor to edit a text file with Kanji and to study assembly language of PC-E500. *** ENVIRONMENT *** MACHINE : SHARP PC-E500 / PC-1480U series. ( Concerned by PC-E500 ROM Version 3 and PC-1490U ROM Version 6 ) RAM : I think 32KB needed for editing the English text file. ( 64KB or more might necessary to edit the Japanese text file. ) *** PREPARATION *** First, 7KB or more must be prepared as the machine language area. But just 7KB, you cannot load the text file to edit. Prepare as large as you can. More you prepared, larger text can be edited. *** STARTING *** (1) Case of using the command-line processor (TY-DOS) SYNOPSIS : TRED [switch] filename Specify a filename you want to edit. SWITCHES : -T space will not be converted into tab when save a text. -R edit the prevent file which is still remaining in memory. (2) Case of using from BASIC You must load the text-editor to your E500 with typing LOADM "TRED" And, to start editing you must type CALL &BE000"[switch] filename *** HOW TO USE *** functions to move the cursor up move the cursor up down move the cursor down left move the cursor left right move the cursor right CTRL + up move the cursor to the top of file CTRL + down move the cursor to the end of file CTRL + left move the cursor to the top of line CTRL + right move the cursor to the end of line functions to input Alphabet, number and other characters are available. Kanji character is available with EOLLA SYSTEM or other FEP. functions to insert and delete INS change mode to insert or overwrite DEL delete a character BS backspace CR input a CR SHIFT + INS insert a space CTRL + CR insert a newline functions to cut and paste This editor has a buffer for paste which is a line (40 characters). It saves a line last deleted. CTRL + DEL delete a line CTRL + BS copy a line to the buffer without deletion CTRL + INS paste other functions CTRL + Q quit CTRL + E quit with saving CTRL + S save CTRL + 0 change mode of click on or off CTRL + 1 change mode of key repeat on or off OFF power off *** THESE ARE NOT BUGS *** In the last line of the text buffer you cannot input when the buffer is full. Because a great change of the program will be needed for reliable checking, I programmed to prevent an error for the time being. When you cannot input, you must save your text and prepare larger machine language area and restart. Beware of becoming too long line, because the editing processing buffer is about 4KB and there are no checks for a long line. Never edit an extremly long line. *** TRICKS *** These are tricks with -R switch. SAVE AS CHANGING FILENAME (1) Start the editor (loading a file). TRED S1:TEST.TXT (2) Edit the file. (3) CTRL-Q to quit. (4) Restart the editor. TRED -R S2:TEST2.TEXT (5) CTRL-S to save the file. WHEN FILE SAVING FAILED There are cases where "file write error" occured in file saving. The reason of this error is mostly the disk full at the drive. The file can be saved, if preparing the RAMCARD which has enough space. (1) "file write error" has occured. (2) Prepare the RAMCARD which has enough space. (3) Restart the editor. TRED -R S2:TEST2.TEXT (4) CTRL-S to save the file. *** CAUTION IN USE *** I checked this software not to hang up or catastrophic error, but it will rarely do in non-gereral use. It is presumed still about the bugs and some points not useful. I want to improve in the future. Backup files and programs before using this software to save your data. The author will not be liable for losing your data. When you find a bug, wound you please report it to me. And if you have the points to improve or the functions you want, please tell me, too. I want to improve as long as the author's ability and time permit. *** FUTURE IMPROVEMENT *** It is expected to improve the function of memu, tab, error checking, string searching, string replacing, deletion and the processing of faster displaying and more efficient memory using, etc. *** TECHNICAL INFORMATION *** When the editor starts, the whole text file is read to the memory and it is converted to the form which the editor easily deals it. The tab code is converted as spaces. (What a bad efficiency of memory.) When data saved, the data is reconverted to original text format. All the convertable spaces are converted to the tab code. However, spaces between single quotes or double quotes are not converted. And the case of specification with the switch they aren't. When editing text, CR,LF are converted into 1Dh, and EOF is converted into 1Fh. Of cource it is reconverted when data saved. The editor is processing a line as the buffer which is 40 characters length. The long line (until CR,LF) within 3000 characters can be processed, but longer lines are disagreeable. The memory map is as follows. (It may be changed in the future.) == The Memory Map == +-----------------------+ $xxxxx top address of the machine code area | | | text buffer | | | +-----------------------+ $be000 start address | | | program | | | +-----------------------+ $bed29 end address | work area | +-----------------------+ $bf800 | TYDOS.SYS | (in case of using TYDOS) +-----------------------+ I'd like to write some about the optimization of displaying in this editor. First, in case of the cursor movement: When the cursor moves vertically, redrawing parts are decreased by using the hardware scroll effectively to speed-up. When the cursor moves horizontally, only the cursor moves. In case of insertion(INS) or deletion(DEL), only parts after the cursor which is changed are redrawn. For the reason, the operations in the lower screen or in the shorter line(few characters after cursor) are processed faster. I don't know so well the efficient usage of the memory and FCS/IOCS. Besides this, please tell me when you have something techinical hint. *** VERIFYING THE EXECUTABLE *** The crc of the executable is 0xA34B4E90. Use CRC32 by N.Kon. *** COPYRIGHT NOTICE *** All right of this program and documents is reserved by T. Kobayashi. You are permitted to copy, to use and to distribute in following terms and conditions. 1. To distribute this program and documents "as is" without any charge. 2. To redistribute all appended files (except source file). 3. To operate on your judgment and risks. This program is no warranty. 4. The author will not be liable to you for any damages in this program. Therefore, you had better to take the backup of files before using. 5. The author will not assume all necessary servicing, repairing or correction in this program and documents. However, assumed to debug and to improve within the range which the author's time and a technological level permit when bugs are found. 6. It is prohibited to upload this software to a BBS which might violate author's copyright. 7. For personal use it is not limited that you modify this program. However, do not violate the copyright, do not change the program name, and the author name, etc. 8. To send me the report before you upload this program to BBS etc. Please inquire of the author about any uncertain points. *** HISTORY *** Ver. 0.xx Test version. ( 19, Apr 1992 - 6, May 1992 ) Some test version is tested in Japanese bbs. Thanks for beta-testers. Ver. 1.00 Formal version. ( 8, May 1992 ) The name is decided "TRED". Taking some bugs in the test version. Reinforcement of checking memory over. Reinforcement of editing function. Ver. 1.01 ( 13, May 1992 ) Removing Katakana inputing function. Taking the bug that the cursor did not move to the first byte of Kanji character when jumping to end of line. Changing of the internal ram addresses of work area and so on. Ver. 1.02 ( 17, May 1992 ) Takeing the bug hanging up when CTRL-Z was inputed. Taking the bug that the cursor moves illegally when the cursor moved up at the top of the line. Extract the explanation part which is needed to use this editor from this document to quick-reference file. Ver. 1.03 ( 24, May 1992 ) Applying the auto power off function. Taking the bug of processing backspace. Taking the bug of cut&paste by the line with EOF. Ver. 1.04 ( 8, Jun 1992 ) Taking the bug of working abnormally when the cursor moved left at the top of text. Ver. 1.10 ( 28, Oct 1992 ) Supporting to deal a larger file than 64Kbytes. Ver. 1.11 ( 29, Oct 1992 ) Taking the bug of voiding of saving function ocurred on Ver 1.10. Erasing key clicks to be quiet when power offs. Fixing the imcorrect behavior when break key pushed. *** AUTHOR'S ADDRESS *** ADDRESS : Tatsuya Kobayashi 2-128-7 Mitsuhashi Ohmiya-shi Saitama 331, JAPAN BBS : Pocket-Tsuushin ID=2215 (Ryu) *** REFERENCES *** 1. PC-E500/PC-1480U katsuyou-kenkyu, 1989, Kougaku-sha Corp. 2. Developing applications in TY-DOS, T.Yamaguchi, PJ 1988 #10. 3. INFO Version 2.31 by TOMCAT 4. KNJSCRN Version 1.2 by E.Kako 5. LED by ALPHA, PJ 1991 #11. 6. VIEW Version 1.71 by Asasora