home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / demon / amstrad / id.arc / IDED.DOC < prev   
Encoding:
Text File  |  1994-03-14  |  4.3 KB  |  100 lines
  1. IDED v1.00                                            John Elliott, August 1993.
  2. ================================================================================
  3.  
  4.   IDED is a companion program to ID.COM. It edits the identities of LocoScript
  5. files. While LocoScript itself can edit the identities of only documents,
  6. datafiles, phrases, settings or user dictionaries, IDED can edit the identity
  7. of any LocoScript file. It also works from CP/M, saving the long and tedious
  8. rebooting process.
  9.  
  10.   Syntax is:
  11.  
  12.      IDED d:filename.ext {n}
  13.  
  14.   The filename is the one whose identity you are editing; the number n is
  15. optional, but if it is present it specifies which group to use. If the file
  16. exists and is a suitable (ie LocoScript) file, the screen will clear, the
  17. identity will be displayed and the editor will be entered.
  18.  
  19.   Unlike LocoScript's own identity editor, this editor works in "overstrike"
  20. mode; if you type a character, it replaces the character under the cursor,
  21. and characters do not move to left or right. There are just two exceptions to
  22. this rule (marked with *).
  23.  
  24. Valid keys are:
  25.  
  26. Cursor keys:     Move the cursor.
  27. RETURN or ENTER: Go to start of next line.
  28. <-DEL  (DELETE): Replace character to the left of the cursor with a space.
  29. LINE/EOL   (^B): Go to start of line.
  30. STOP       (^C): Abandon edit.
  31. ALT+DOWN   (^E): As RETURN.
  32. DEL->      (^G):*Delete character under the cursor, and shift all characters to
  33.                  the right of the cursor to the left by one.
  34. CAN        (^H): As <-DEL.
  35. ALT+DEL->  (^K): Delete to end of line.
  36. CUT        (^U): Delete line.
  37. [+]        (^V):*Insert a space under the cursor, and shift all characters
  38.                  under or to the right of the cursor to the right by one.
  39. ALT+<-DEL  (^X): Delete to start of line.
  40. EXIT   (ESCAPE): Finish edit normally - save identity.
  41. [-]        (^\): As ALT+DEL->.
  42.  
  43.   When you press EXIT to finish, the program ends.
  44.  
  45.   PCW, CPC and Spectrum +3 users need not read beyond here.
  46. ________________________________________________________________________________
  47.  
  48. Modification for non-Amstrad computers:
  49.  
  50.   As supplied, the program will run on CP/M+ computers with Z80 processors and
  51. VT52 terminals (ie Amstrad CPC/PCW/Spectrum +3). The first two requirements
  52. remain unchangeable, but the display code can be changed for different
  53. terminals; the cursor key codes can also be altered.
  54.   SID or similar must be used to make the changes. Here is how:
  55.  
  56.   At 0103h in the program file, there are two jump instructions:
  57.  
  58.   JP CLS
  59.   JP MOVCUR
  60.  
  61.   The address in the first jump points to a 20h (32) byte area in the program
  62. file which should contain a routine to clear the screen (homing the cursor is
  63. not necessary). CLS may corrupt all registers. After CLS, there is a 12-byte
  64. data area. The first 8 bytes are for graphic characters:
  65.  
  66.        ORG CLS+32
  67.        DB  TLC,TL,TRC,LL,RL,BLC,BL,BRC
  68.  
  69. In order, these are Top Left Corner, Top Line, Top Right Corner, Left Line,
  70. Right Line, Bottom Left Corner, Bottom Line, Bottom Right Corner (see diagram
  71. below).
  72.  
  73.              TLC            TL               TRC
  74.               +------------------------------+
  75.               |                              |
  76.             LL|                              |RL
  77.               |                              |
  78.               +------------------------------+
  79.              BLC            BL               BRC
  80.  
  81. Then there are 4 bytes for the codes returned by the cursor keys:
  82.  
  83.        DB UP,DN,LT,RT
  84.  
  85.   After the data area is the MOVCUR routine (you can also find MOVCUR by
  86. looking at the word in 107h-108h). MOVCUR can occupy up to 40h (64) bytes. Its
  87. job is to move the text cursor to the coordinates specified in DE. D is the
  88. y-coordinate and E is the X-coordinate, counting from the top of the screen.
  89. The coordinates are zero based.
  90.   After MOVCUR are two helpful routines:
  91.  
  92.   CHAR is at MOVCUR+40h. It prints the character in E to the screen. AF BC DE HL
  93. are preserved; other registers are undefined.
  94.   STRING is at MOVCUR+4Eh. It prints the string at (DE) to the screen. The
  95. string should be terminated with $. AF BC DE HL are preserved; other registers
  96. are undefined.
  97.  
  98. _______________________________________________________________________________
  99.  
  100.