Garbo

home *** CD-ROM | disk | FTP | other *** search

/ Garbo / Garbo.cdr / pc / editor / easy225.lzh / EASYMAN.TXT < prev next >

Wrap

Text File | 1989-06-01 | 178KB | 4,216 lines

@op EASYEDIT II User Manual V2.25 (C) The AsEditCo Warren Cottage Warren Lane Elmswell Suffolk IP30 9DT England Tel: 0359 41601 @pa @pg @tc0Introduction Introduction ------------ What is EasyEdit ? 1. EasyEdit is a text editor. This means that it can create readable text files using just the normal ASCII character set. Unlike full-blown word processors, files created or amended with EasyEdit can be read directly by DOS (the TYPE command) or by most other text readers and word processors. 2. EasyEdit is a limited word processor. It has many of the features of true word processors but without a lot of the overheads. The list of what it can do is almost endless. 3. EasyEdit is easy to use. It has been designed so that anyone can install it and use it with a minimum of fuss. Of course, you can customise it to your own personal preferences. 4. EasyEdit runs on IBM PC/XT/AT computers and all true compatible. It has been tested under DOS V3.3 but should work on all versions greater that 2.0. It requires about 256Kb of memory but will use up to 640Kb. It will only edit files 'in memory' and does not spool to disk so there is a finite limit on file size. This was done deliberately for SPEED. @tc1Features Features -------- Well, where do you start ? Editing Full customisable mouse support (Microsoft mouse compatible) Read in Read-only files. Works on MS-NET compatible networks - tested in Digital Equipment's PCSA environment. Windows: Can edit up to 6 files at once or the same file 6 times. Specify wild cards as a filename and search for the correct file. Cut and paste between windows or within windows. Zoom or shrink windows. Printing: Print files from within EasyEdit and continue editing (background printing). Use print enhancements such as bold, superscript etc Customisable printer definition tables and character translation tables. Print to a file or any DOS device (LPT1-3, COM1-2). Print to a network printer. Automatic or manual pagination commands Headers and footers with page numbering and date/time stamping. Window display of print status on demand. Print Table of Contents with many formatting options @pa On-screen formatting: Centreing. Paragraph or block formatting Temporary margins Right Justification Case changes Search Find text - case sensitive or not Globally or within a block Whole word search Search forwards or backwards Find the nth occurrence of text. Include control characters in search Find next Find and replace Find text and then execute a macro Block Mark blocks Copy, move, delete blocks Read or write blocks. Tabs Set tabs to any fixed size Set tabs anywhere Set 'smart tabs' to match the current line of text Turn tab display off Expand tabs to spaces on loading or saving Turn auto-indent on or off Display Get 43 line display on EGA systems Get 50 line display on VGA systems Modify colours of all parts of the display. Save them to a colour file for later use. Line or block cursor (useful for LCD displays). Margins Set left, right, top and bottom margins Set page length. Data saved with each file (but not IN the file). Macros Load, save or edit macros Enter macros as you are typing Include macro substitution. Context sensitive help. Over 200 pages of help available at the press of a button @pa Configuration file for editing defaults and mouse commands. Options can be made environment variables Abbreviations expansion from user configurable files. Perform DOS commands while still editing. Edit last file you were editing + go to last edited row and column Undelete lines or blocks of text Automatic backups while editing - user configurable Automatically load and run macros on entry if required. Uses overlays for maximum free memory Can import and export binary files for transport via a mail system. Keyboard Has 'Wordstar' like commands built in as default. Has predefined usage of function keys. All function, control and Alt keys fully customisable using the keyboard installation program. ..................and much much more................... @pa @tc0The Shareware concept The Shareware concept. ---------------------- EasyEdit II is a shareware product if you received a copy either from a friend or from any network or bulletin board (or indeed if you obtained a copy in any other 'free' way). What this means is that I grant you a license to try it out for a limited period of ONE MONTH . After that, I expect you to register with me and pay a license fee for its continued use. In return, I will send you a further update free of charge. Existing commercial users, please contact your dealer for update information. I will also send you, when it is completed, an EasyEdit technical reference manual. This will contains details such as the internal data structures used, the format of the help text files and a lot of other useful information. After the free upgrade, you may register for maintenance upgrades at half the registration price. This will entitle you to the next three major upgrades. A major upgrade is where the version number changes its 'tenths' number. (eg 1.74 to 1.80). You may also wish to suggest ideas to incorporate into future versions of EasyEdit. If your idea is accepted, you will be given a free upgrade which includes that suggestion. After registration, you may use EasyEdit II on as many computers as you wish, as long as you own them. Companies, please see below for site or company licenses. If you no longer wish to use the software, please destroy ALL copies, including any backups you may have made. If you wish to give the software away, you may do so as long as you give it away in its entirety. This means all the programs, manuals and supporting files. @pa @tc1Prices Prices ------ Individuals ----------- Within Europe or outside the U.S.A., the cost is £20.00 sterling (sorry, I can't accept foreign currency) and the address to send it to is at the front of this manual. Within the U.S.A, the cost is $30.00 and the address to send it to is: c/o... H Dieter Heinzer 4720 Oz Court Colorado Springs CO 80922 Please make cheques out to 'The AsEditCo'. Companies --------- For individual use, the cost is as above with the restriction that each user may only use EasyEdit II on his or her 'own' (ie the one purchased for use by that individual) machine, or a designated backup. You may also wish to register your 'site' and distribute copies yourself. In this case, the costs are as follows: Up to Europe U.S.A. 10 licenses: £160 $240 (Breakeven 8) 20 licenses: £300 $450 (Breakeven 15) 50 licenses: £600 $900 (Breakeven 30) 100 licenses: £1100 $1650 (Breakeven 55) 200 licenses: £2000 $3000 (Breakeven 100) Unlimited £2800 $4200 (Breakeven 140) You can order a mixture of the above. For instance, if your site has between 50 and 70 PC's, you would order one '50' license and one '20' license for a total saving of £500 or $750. A site is defined as being a building, or set of buildings which can all be reached by walking (typically within a radius of half a mile). For details on company-wide licenses, please contact me. I can provide a limited amount of telephone support via the phone number at the front of the manual. However, please remember that I do have a 'real' job and would appreciate phone calls in the evenings UK time, or at weekends. I will NOT return calls unless it is really urgent (I define that criteria), since this is not a commercial venture and I pay my own phone bills. @pa @tc0Installation Installation and customisation ------------------------------ You will get this package in one of three ways: either as a diskette, in which case, follow step A or as a .ARC file off a network, in which case, follow step B or as a pre-installed program, in which case, do nothing. STEP A ------ Follow the instructions in the file INSTALL.MAN which is on the installation diskette. STEP B ------ If you received the kit from a network, all necessary files will be in the archive. Use any commercial de-archiver which supports the 'squashing' method to unpack the files into a subdirectory. Then, if you wish the support file path to be stored inside the EasyEdit program file, type in the following: EE /E- /L:INIT.MAC /M:1 [RET] Otherwise, set an environment variable, EEPATH, to point to the support file directory from DOS as follows: C:> SET EEPATH=C:\EE [RET] Note that the environment variable EEPATH takes precedence over the support file path. After that, set the PATH command to point to the EasyEdit home directory and you may start editing any file anywhere. NOTE WELL: ---------- If you received the kit over the network, please remember that EasyEdit II is SHAREWARE. Your registration is vital if I am to continue to maintain this product. @pa @tc0Keyboard customisation Keyboard Customisation ---------------------- One of the really nice things about EasyEdit is that you can customise the keyboard so that all the function keys will act how you expect them to. This goes a long way to making EasyEdit one of the nicest editors around and is a feature well worth having. There is a program KBD_INST supplied which does it all for you. To run it, type in KBD_INST [RET] The program will load and ask you if you wish to restore the key mappings from the file EEKEYF.ILE. Answer 'Y' or 'N' as appropriate. The file EEKEYF.ILE contains a binary copy of the mapping of function keys to EasyEdit commands and can be useful when you get a new version of EasyEdit. You will then be presented with a full screen display of all the available commands and the keys which are currently used to access them. You will notice that there are two key sequences for each command. You may enter a primary and secondary keystroke for each command. However, all keystrokes must be unique. Note that the MOUSE commands all use the primary keystrokes so please be careful about modifying those. To modify a command, move the cursor to the command in question using the arrow keys and press [RET]. You can then press the key sequence you want plus [RET] and that will be stored against that command. Note that some commands are interpreted as 'control' commands (eg 'C' to clear the display). If you wish then to be included in the command, press the 'SCROLLOCK' key first and then the command. Press the 'SCROLLOCK' key again to resume normal operations. The list of control commands are: C Clear the current keystrokes R Restore to the default on entry. [RET] Accept the command Ctrl-H Delete the previous character <ESC> Finish editing keystrokes When you are finished, press the <ESC> key. This will bring up a message on the top line, asking if you wish for a keyboard map file to be produced. Press 'P' to produce the file EEKEY.MAP or press 'C' to continue. The file EEKEY.MAP is a text file with all the commands plus the primary and secondary keys needed to invoke them. This file may then be edited in any way and saved for your further reference. @pa Another message will be presented asking if you wish to save the key mapping in EE.EXE plus updating the help file EE.HLP to reflect the new change. Press 'W' to save the data or 'Q' to quit without saving. If you have modified any keys and choose the 'Q' option, you will be asked to confirm that you wish to quit. If you chose 'W', the keystrokes are saved in EE.EXE, the file EEKEYF.ILE is updated and the help text (EE.HLP) is updated to reflect the new changes. Be patient, there are over 2500 lines to write here. It takes about 15 seconds on my machine. Please note that the file EE.HLP is created by the keyboard installation program (a default one is supplied) from the keyboard mappings and the file EE.TXT. Please do not change that file or the results will be unpredictable. The EasyEdit technical reference manual will have details on the help file formats. Hint ---- Play with the program before diving into the KBD_INST routines. Get to know what all the commands mean. Look at the defaults that have been set up; a long time was spent thinking about the best way to use the function keys and it works well. @pa @tc0Files used File Used and EasyEdit defaults. -------------------------------- @tc1EELASTF.ILE EELASTF.ILE - Stored in the home directory as defined with the <F10>OLH command. This contains the last file which was edited (in any directory). This file is created by EasyEdit. @tc1EE.CFG EE.CFG - Stored in the home or current directory as defined with the <F10>OLH command. This contains lines to set/bypass some defaults. Each line contains a keyword followed by an action, normally ON or OFF. Each keyword and action is described below. You may use any editor (EasyEdit ?) to create or amend this file. Note that the keywords can be in either upper or lower case but they MUST start in column 1. Any line starting with a ';' is treated as a comment and will be ignored (see the file EE.CFG for an example). @tc2Environment variables Environment variables Any parameter starting with a '%' will be treated as an environment variable and the environment table will be searched to obtain the true value. This can have great benefits in networks. eg, if the file EE.CFG contains the line 'SEARCHINIT %SEAR', and the environment has been set up with SEAR=UG, then the SEARCHINIT parameter will be 'UG'. You can also enclose environment variables within a pair of '%' and the information outside them will be unchanged. eg if the file EE.CFG contains the line LOADMACRO %mac%.MAC and the environment has been set with MAC=INIT, then the expansion will be to LOADMACRO INIT.MAC. You may also enclose the complete line within '%'s and replace them by environment variables. eg if the EE.CFG file contains: %var1% %var2% and the environment contains: var1=EMS OFF var2=EDLAST ON then I think you can see the results. It opens up all sorts of possibilities. If the parameter is not found in the environment table (ie, it has not been set), then that option is set to null (''). It is YOUR responsibility to check this. The (D) is the default if that line is not in the file. @pa @tc2Keywords Keywords READROW OFF - Bypasses the 'read last row/col/margins'. READROW ON (D) - Enables the 'read last row/col/margins'. WRITER_C OFF - Do NOT write the .R_C file. This will also turn OFF reading of the .R_C file and setting the row/column to its last known position WRITER_C ON (D) Write out the .R_C file whatever the status of the READROW option. EDLAST OFF - Bypasses the 'edit last file' option EDLAST ON (D) - Enables the 'edit last file' option. ENDHOME ON - If this feature is ON, the second and all subsequent presses of the <HOME> and<END> keys will move the cursor to the previous or next line as long as no other keys have been pressed in between. ENDHOME OFF (D) - Disables the feature. FORMATCHAR character - This option enables you to change the format character (default '@') to any single character you wish. Thus, for compatibility with Wordstar (R), you may wish to make the format character a '.' (a period character). SEARCHINIT characters This option enables you to set default options to the FIND command. Thus, if you always want to find upper and lower case, set the characters to 'U'. See the file EE.CFG for an example. AUTOSAVE OFF (D) - Do not autosave. AUTOSAVE ON - Save the file to a .SAV extension every 'SAVETIME' minutes. This option will back up the file every few minutes (specified by the SAVETIME option), to a file with the name of the file being edited and an extension of .SAV. It does not affect the original file or the backup (.BAK) file. If you abort the edit, the original file is preserved. The autosave will back up all files being edited as long as they have been modified. It does NOT back up linked files (editing the same file in two windows) more than once. It does not change the status of the 'modified' flag (specified by an '*' next to the filename). If the file has been modified, it WILL be saved when you exit from the program. If you abort the edit for any reason, the .SAV file will still remain. This allows you to have an intermediary file with some edits in it for you to access (it all helps). You may delete this file manually or wait for Easyedit to delete it on the next save. @pa SAVETIME number - Number of minutes between autosaves. Default is 10. Can be any number between 1 and 59 (minutes). If a value outside that range is entered, AUTOSAVE is turned off. LEFTUP ON LEFTUP OFF (D) This option changes the action of the left arrow key when it reaches the left margin. If ON, the cursor will go to the last character of the previous line. If OFF, the cursor will stay at the left margin. RIGHTDOWN ON RIGHTDOWN OFF (D) This option changes the action of the right arrow key when it reaches the last character on the line. If ON, the cursor will go to the first character of the next line. If OFF, the cursor will continue on the same line. LOADMACRO Macrofilename - Load in the macro file named rather than EE.MAC from the default (home) directory. You will need to put in the name and extension but NOT the directory specification. If the file does not exist, you will get an error message and the program will continue. If you wish to test macros in the current directory, use the '/L:' command line parameter. Then, when you are satisfied, move the macro file to the home directory and change the LOADMACRO filename. RUNMACRO Macronumber - Run the specified macro number (0-9) in the file specified above (or EE.MAC). The default is NOT to run a macro. If this option is enabled but there is no macro file loaded, or if you enter a number for which there is no macro, then the RUNMACRO option is ignored MOUSE ON (D) MOUSE OFF This option controls whether to use the mouse or not. If set ON, EasyEdit checks for the presence of a Microsoft compatible mouse and reads in the EEMOUSE.CFG (see below) to set up the mouse key press assignments. If set OFF, the mouse will not be used, even if it is present. @pa TOCSEPARATOR char (Default is '.') This option changes the default character used to connect a Table of Contents line with its page number. eg, if the separator is a '.', then a line could look like: 1 Top level - should have chapter heading........... 1 The '....' is the separator. TOCCHAPTER ON (D) TOCCHAPTER OFF This option controls whether the level 0 TOC line has the word 'Chapter' before it. TOCLENGTH n (Default 70) This option controls the position (column number) of the page number in a Table of Contents listing. TOCNUMBERS ON (D) TOCNUMBERS OFF This option controls whether to print numbers when a table of contents listing is produced. For example: 1 Top level - should have chapter heading.................. 1 1.1 This is one level down................................. 1 1.2 One level down......................................... 1 1.2.1 This is level 2...................................... 1 TOCINDENT ON (D) TOCINDENT OFF This option controls whether to indent each different level or not. In the example above, TOCINDENT is OFF. In this example, TOCINDENT is ON. 1 Top level - should have chapter heading.................. 1 1.1 This is one level down............................... 1 1.2 One level down..................................... 1 1.2.1 This is level 2................................ 1 FINDSTART ON FINDSTART OFF (D) This option controls where the cursor is positioned after a search text command is completed. If ON, the cursor is positioned at the beginning of the string; if OFF, it is positioned at the end of the string. @pa ABRMEM filename (default EEMEM.ABR) Set ABRMEM to the name of a local Abbreviation file which remains in memory all the time. ABRFILE filename (Default EEFILE.ABR) Set ABRFILE to the name of the abbreviation file which is searched if the abbreviation is not found in the ABRMEM file COLFILE filename (Default - take colour map from EE.EXE). Set COLFILE to the name of a file where the color map is stored. EMS ON (D) EMS OFF Enable or disable EasyEdit attempting to put the overlay file into EMS memory for faster access to the overlay file. I have found that when running under DESQVIEW (tm) with the LOADHI area completely full, that attempting to move the overlay file into EMS memory can cause the system to hang. BCHALT ON BCHALT OFF (D) If you start Easyedit with the /BC option, then it checks the file for a binary attachment. The BCHALT option determines whether or not editing will continue if no binary file is found. If BCHALT is ON, then editing is stopped if no binary attachment is found. If BCHALT is OFF, then editing continues. @pa @tc1EEMOUSE.CFG EEMOUSE.CFG If a mouse is to be used and there is a microsoft compatible one present in the computer, the file EEMOUSE.CFG is read in to set up the assignment of mouse keys to EasyEdit commands. Each command has a number (see the table below) and each type of mouse press can be assigned a different number. The rules governing the layout of the EEMOUSE.CFG file are the same as the EE.CFG rules above. Each mouse button can be pressed alone, with the Alt, Control or Shift keys or any combination of the above. Most of the presses can be assigned to EasyEdit commands. The exceptions are detailed at the end of the following table, which explains the default actions. @TC2Mouse button table Key Pressed Left Mouse Right Mouse Both Mouse Button Button Buttons ----------------------------------------------------------------------- None See below See below Help summary Alt Move Block Copy Block Nothing Ctrl Nothing Hide Block Nothing Left_Shift Help summary Abort action Nothing Right_Shift Help summary Abort action Nothing Alt-Left_Shift Delete line Undelete line Nothing Ctrl-Left_Shift Nothing Nothing Nothing Alt-Ctrl Nothing Nothing Nothing Alt-Ctrl-L_Shift Delete block Insert undo buffer Nothing ----------------------------------------------------------------------- With the Left Mouse button alone, a press defines the beginning of a marked block and a release defines the end of a marked block. With the Right Mouse button alone, pressing it while editing will bring up the menu system. Pressing it while in the menu system will take you back up menu levels until the menu system is exited. Once into the menu system, mouse movement down, or the left mouse button will select a lower menu level. At the lowest level, the left mouse button selects that option. When the help screen is displayed, pressing the left button will select the menu item and pressing the right button will cancel that selection. Moving the mouse up or down will invoke the previous or next page if appropriate. The mouse movement is translated into cursor movement. @pa @tc1Mouse key defaults All the options can be modified by editing the file EEMOUSE.CFG. The commands are detailed below with the default option shown. There is also a separate file COMMANDS.LST in the distribution kit which details the valid commands. LEFTALT 57 Left Mouse button plus ALT key RIGHTALT 56 Right Mouse button plus ALT key LEFTCTRL 113 Left Mouse button plus Control key RIGHTCTRL 59 Right mouse button plus Control key LSHIFTLEFT 174 Left mouse button plus Left Shift key LSHIFTRIGHT 192 Right mouse button plus Left Shift key RSHIFTLEFT 174 Left mouse button plus Right Shift key RSHIFTRIGHT 192 Right mouse button plus Right Shift key LSHIFTALTLEFT 32 Left mouse button plus Left Shift and Alt keys LSHIFTALTRIGHT 22 Right mouse button plus Left Shift and Alt keys LSHIFTCTRLLEFT 193 Left mouse button plus Left Shift and Ctrl keys LSHIFTCTRLRIGHT 193 Right mouse button plus Left Shift and Ctrl keys ALTCTRLLEFT 193 Left mouse button plus Alt and Ctrl keys ALTCTRLRIGHT 193 Right mouse button plus Alt and Ctrl keys ALLLEFT 58 Left mouse button plus Alt,Ctrl and Left shift keys ALLRIGHT 116 Right mouse button plus Alt,Ctrl and Left shift keys ALONEBOTH 174 Both mouse buttons alone RSHIFTBOTH 193 Both mouse buttons plus Right shift key LSHIFTBOTH 193 Both mouse buttons plus Left shift key BOTHCTRL 193 Both mouse buttons plus the Control key LSHIFTCTRLBOTH 193 Both mouse buttons plus Left Shift and Ctrl keys BOTHALT 193 Both mouse buttons plus the Alt key LSHIFTALTBOTH 193 Both mouse buttons plus Left shift and Alt keys ALTCTRLBOTH 193 Both mouse buttons plus Alt and Ctrl keys ALLBOTH 193 Both mouse buttons plus Alt,Ctrland Left Shift keys @tc1Mouse configuration options In addition to all the above, the movement of the mouse can be controlled by options in the configuration file. HMICKEY number (default 8) VMICKEY number (default 8) These are divisors to the basic cursor movement to slow down the speed of moving the mouse. HMICKEY is for horizontal movement and VMICKEY is for vertical movement. SLOWMENU number (default 3) This option slows down the cursor movement even more when in the menu system. This is because EasyEdit is doing no background processing and thus looking for keystrokes more frequently. BOTHDELAY number of milliseconds (default 20) This option is the allowable delay when pressing both buttons before EasyEdit will assume that only one button has been pressed. For those with 3 button mice for which the middle button emulates pressing both, this can be set to zero. @pa @tc1Easyedit Commands list EasyEdit Commands list EasyEdit commands are as follows: Command Description number of command 0. Left one character 1. Right one character 2. Left one word 3. Right one word 4. Up one line 5. Down one line 6. Scroll up 7. Scroll down 8. Down one page (window length) 9. Up one page (window length) 10. Top of window 11. Bottom of window 12. Cursor to left side (home) 13. Cursor to right side (end) 14. Top of screen 15. Bottom of screen 16. Move to previous BEGIN line 17. Move to previous END line 18. Goto line n 19. Goto column n 20. Goto window n 21. Previous cursor position 22. Undo last deletion 23. Restore line as on entry 24. Tab, either fixed or "smart" 25. Insert control character into text 26. New line in text buffer 27. Insert line 28. Delete current character 29. Delete left character 30. Delete right word 31. Delete line right of cursor 32. Delete line 33. Delete line, no undo 34. Find pattern 35. Find and replace 36. Search and apply macro at position 37. Find next 38. Invoke a DOS shell 39. Backward tab 40. Edit a new file in current window 41. Abandon file 42. Read file into window 43. Save file 44. Write block to file, not appending 45. Save file and exit 46. Add second window with same or different file 47. Resize current window 48. Save current file, and get a new one 49. Switch windows 50. Put up a help summary 51. Make the current window fill the screen (zoom) 52. Begin block 53. End block 54. Top of block 55. Bottom of block 56. Copy block 57. Move block 58. Delete block 59. Hide/display toggle block 60. Mark current word as block 61. Toggle text marker display 62. Set marker 0 63. Set marker 1 64. Set marker 2 65. Set marker 3 66. Set marker 4 67. Set marker 5 68. Set marker 6 69. Set marker 7 70. Set marker 8 71. Set marker 9 72. Jump to marker 0 73. Jump to marker 1 74. Jump to marker 2 75. Jump to marker 3 76. Jump to marker 4 77. Jump to marker 5 78. Jump to marker 6 79. Jump to marker 7 80. Jump to marker 8 81. Jump to marker 9 82. Load a set of macros from disk 83. Write current macros to disk 84. Toggle macro recording 85. Insert Macro 1 once 86. Insert Macro 2 once 87. Insert Macro 3 once 88. Insert Macro 4 once 89. Insert Macro 5 once 90. Insert Macro 6 once 91. Insert Macro 7 once 92. Insert Macro 8 once 93. Insert Macro 9 once 94. Insert scrap macro n times (prompted) 95. Insert scrap macro once 96. Insert scrap macro twice 97. Insert scrap macro 3 times 98. Insert scrap macro 4 times 99. Insert scrap macro 5 times 100. Insert scrap macro 6 times 101. Insert scrap macro 7 times 102. Insert scrap macro 8 times 103. Insert scrap macro 9 times 104. Show system information 105. Show available memory 106. Toggle insert mode 107. Toggle autoindent mode 108. Toggle case of character(s) 109. Lower case character(s) 110. Upper case character or block 111. Set the right margin for word wrap and reformat 112. Reformat the current paragraph 113. Toggle word wrap on or off 114. Set the left margin for word wrap 115. Toggle tab line display on or off 116. Insert undo buffer at cursor 117. Toggle right justification 118. Toggle Pagination display 119. Toggle on-screen attribute display 120. Center the current line in margins 121. Set editor colors 122. Save colors, toggles, etc for new time (save defaults) 123. Print a file 124. Flush undo buffer 125. Draw a box 126. Toggle line drawing 127. Log drive or path 128. Show directory 129. Go to specified page 130. Set default top margin 131. Set default bottom margin 132. Set default page length 133. Set default undo limit 134. Toggle tab expansion on read-in 135. Get a new default file extension 136. Set the tabs 137. Set default tab size 138. Write current tab line into text 139. Interactively edit the tabs 140. Set temporary margin for word wrap 141. Reformat marked block 142. Close window, on last one, enter menus 143. Prompt for a marker number to set 144. Prompt for a marker to jump to 145. Prompt for a macro to insert 146. Toggle between fixed and "smart" tabs 147. Set temporary margin at current column 148. Set the path to all the support files 149. Toggle high bit stripping on read-in 150. Edit a macro 151. Save current window to another file 152. Toggle display of keyboard help in menu system 153. Move to previous window 154. Next sentence 155. Previous sentence 156. Restore to default (even) tabs 157. What font is cursor on 158. Insert Bold toggle 159. Insert Doublestrike toggle 160. Insert Underscore toggle 161. Insert Superscript toggle 162. Insert Subscript toggle 163. Insert Compressed font toggle 164. Insert Italic font toggle 165. Toggle snow checking 166. Toggle block cursor mode 167. Toggle EGA 43 line mode 168. Set margin release 169. Not used 170. Not used 171. Toggle tabs written to compress output 172. Toggle compression prior to wrap 173. Toggle default zoom state 174. Help summary menu 175. Help regarding help system 176. Help on cursor movement 177. Help on quick movement 178. Help on insert and delete 179. Help on Search and replace 180. Help on files 181. Help on window commands 182. Help on Block commands 183. Help on text commands 184. Help on tab commands 185. Help on utilities 186. Help on settings 187. Help on line and box drawing 188. Help on macros 189. Help on printing 190. Function key listing 191. Activate the menu system 192. Abort current operation 193. No operation indicated 194. No op - used by menu system 195. Set high bit stripping on read in 196. Unset high bit stripping on read in 197. Expand previous abbreviation. 198. Append a binary file to the current window and exit. Only exits if current window has been modified. 199. Display a count of the number of words in the current window. 200. Extract a binary file from the file in the current window @pa @tc0Overriding options with switches Overriding options from the command line (switches). ---------------------------------------------------- Most of the options specified above can be overriden by switches from the command line. A switch is a '/' character followed by a letter and, optionally, an extra parameter. The switch can be in either upper or lower case. The following are valid switches: /R+ /R- Turn on or off reading .R_C file /E+ /E- Turn on or off reading in last edited file /L:macrofile Load a named macrofile. /M:x Run macro number 'x'. /A+ /A- Turn autosaves on or off. /I+ /I- Start off in insert or overstrike modes /T+ /T- Write tabs on output or spaces /W+ /W- Start off with wordwrap on or off /J+ /J- Start off with right justify on or off /P+ /P- Start off in 'page mode' or not. /T:n Set tab size to 'n' /BC Check the file for the inclusion of a binary file. /AB When exiting, automatically ask for a binary file to add if window (file) has been modified @tc1Switch descriptions Descriptions of each switch follow: a) You can temporarily override the READROW option by adding onto the command line either /R- or /R+ to disable/enable that option for the current editing session. eg EE AFILE.DAT /R+ will read in AFILE.DAT and, if the .R_C file is found, will set the row, column and margins. EE AFILE.DAT /R- will read in AFILE.DAT and ignore any .R_C file. b) You can ask EasyEdit to temporarily override the EDLAST option by adding onto the command line either /E- or /E+ to disable/enable that option for the current editing session. You can stop it reading in the last file edited by adding a /E- when starting up the editor. In this case, you will be editing a new file and will be asked for a filename when it is saved. eg EE /E- You can force EasyEdit to read in the last edited file with the /E+ option. eg EE /E+ Note that the file EELASTF.ILE is created whichever option is in effect. @pa c) You can specify a macro file to be read in to override the default by using the '/L:filename' switch. The filename must be the FULL file specification including the disk, directory and file extensions. eg EE EASYEDIT.TXT /L:B:\INIT2.MAC d) You can specify a macro number to run with the /M:x option (x=1-9). eg EE /M:2 will run macro number 2 from the loaded macro file. e) You can stop the autosave temporarily by adding a /A- on the command line. You may want to do this, for instance, if you are editing a file on a floppy drive and don't want the extra file. eg EE EASYEDIT.TXT /A- You can start the Autosave option by adding a '/A+' to the command line. eg EE EASYEDIT.TXT /A+ f) You can start off in Insert mode, whatever the default is set to by adding the /I+ option to the command line. eg EE filename /I+ You can start off in Overstrike mode, whatever the default is set to, by adding the /I- option to the command line. eg EE filename /I- g) You can set tabs to be written on output, rather than multiple spaces, by adding the /T+ option to the command line. eg EE filename /T+ You can set spaces to be written on output, rather than tabs, by adding the /T- option to the command line. h) You can start off with word wrap enabled, whatever the default is set to, by adding the /W+ option to the command line. eg EE filename /W+ You can start off with word wrap disabled, whatever the default is set to, by adding the /W- option to the command line. eg EE filename /W- @pa i) You can start off with right justification enabled, whatever the default is set to, by adding the /J+ option to the command line. eg EE filename /J+ You can start off with right justification disabled, whatever the default is set to, by adding the /J- option to the command line. eg EE filename /J- j) You can start off with page breaks displayed, whatever the default is set to, by adding the /P+ option to the command line. eg EE filename /P+ You can start off with page breaks hidden, whatever the default is set to, by adding the /P- option to the command line. eg EE filename /P- k) You can set the tab size default to any value (between 1 and 9) using the /T:n option where n is a number between 1 and 9. If you wish to set tabs outside this range (eg 15), you must use the menu to set it ( <F10>OTT ). eg EE filename /T:5 sets the tab size to 5 characters. l) When reading in a file, you can get EasyEdit to check for the inclusion of a binary file (such as a spreadsheet) and extract it automatically by adding '/BC' to the command line. You will be asked to confirm the filename before it is written (see later). m) To automatically get EasyEdit to append a binary file to the text, add the '/AB' switch to the command line. This option can also be invoked from the 'File' menu option. If the file has not been modified, then EE exits as normal. Note that the options from (f) to (k) can be made permanent by invoking the 'Save Defaults' in the options menu. You can combine the switches. eg EE file /R- /M3 The options and switches can be either upper or lower case. If a switch is entered more than once, then the LAST one will be executed, the others will be ignored. eg EE /E- /E+ /R- [RET] The first '/E-' will be ignored and the other two switches executed. @pa @tc0Invoking EasyEdit Invoking EasyEdit. ------------------ The main file is EE.EXE. You call it as follows: EE filename (filename2 3 4 5 6) switches [RET] 'filename' is the name of the file you want to edit. 'filename2 3 4 5 6' are optionally other files you can load in at the same time. Although you may edit up to 6 files at once, you can put more files on the command line. In this case, you will get an error message and only the first 6 files will be read in. Do NOT enter the brackets '()' on the command line. They are there for display in this manual only. 'switches' are optional switches as described above. In summary, you have: /R+ /R- Turn on or off reading .R_C file /E+ /E- Turn on or off reading in last edited file /M:x Run macro number 'x'. /A+ /A- Turn autosaves on or off. /L:macrofile Load a named macrofile. /I+ /I- Start off in insert or overstrike modes /T+ /T- Write tabs on output or spaces /W+ /W- Start off with wordwrap on or off /J+ /J- Start off with right justify on or off /P+ /P- Start off in 'page mode' or not. /T:n Set tab size to 'n' /BC Check the file for the inclusion of a binary file. /AB When exiting, automatically ask for a binary file to add if the file has been modified. You may invoke EasyEdit using wildcards (* and ?) in place of a filename. In this case, you will be presented with a listing of all files which match your specification and you may choose one using the arrow keys to select. eg EE *.PAS will open a window containing all files with a .PAS extension. Choose one by moving the highlight using the cursor keys or pressing enough letters to make it unique and then press [RET]. Please note that, in this case, all switches on the command line will still be obeyed EXCEPT the /M:n switch. @pa @tc1Initialisation sequence Initialisation sequence ----------------------- When you start up EasyEdit II, it first looks for a file called EE.CFG in the current directory. If it is not there, it looks in the home directory (where EasyEdit is stored or where the environment variable EEPATH looks at). This file contains the default settings as described above. If a mouse is present and is to be used, then the default options stored in EEMOUSE.CFG are read in. Any abbreviations are read in and set up. If a colour map file exists, it is read in. If the help file can be found, it is opened ready for use. The program then attempts to load the default macro file EE.MAC or one named by the LOADMACRO option above. Then, the default printer definition table and character translation table (if present) are read in. If there is no filename present on the command line, the program then looks for a file EELASTF.ILE in the home directory, if requested by the EDLAST option, and then attempts to open the filename found within that file. The program then attempts to open a file called 'filename'.R_C in the CURRENT directory. This contains the following: Last column edited Last row edited Current Left margin Current Right Margin Current Top Margin Current Bottom Margin Current Page Length Current Page number (if in page mode) for the 'filename' being edited. Note that, for the current window, if the page number is found, the window will be set to display pages whatever the status of the default. It also overrides the '/P+' option. If the page number is not found, then the page display will be disabled, whatever the default or command line (/P-) options. This information is saved whenever the file is saved. After that, the file requested is read in, if it exists, and you may start editing. @pa @tc0Editing principles Editing Principles ------------------ This section discusses the best way to utilize EasyEdit to its full advantage. It is assumed that the user is familiar with the PC keyboard and the layout of the function keys. @tc1Entering information into windows Entering information into Window boxes -------------------------------------- At various times through the editing session, you may have to enter information (such as filename to print) into special windows. The following editing information applies here: 1. If you start typing, any previous information is erased. 2. If you use the arrow keys, you can edit previous information. 3. At any time, you can use the arrow keys to go back and forwards editing the information entered. The <INS> key can toggle between Insert and Overstrike modes although the status line will not change. @tc1The status line The Status Line --------------- At the top of each window is a status line with information about that window. 0-2 An indicator >Z< to show if the window is zoomed. 3 An '*' to show if the file has been modified 4-16 Filename 17-21 How far through the file (percent) 22-32 Current line number 33-40 Current column number 41-49 Current page number (if page formatting is ON) 50-56 Insert/Overwrite indicator 57-63 Auto Indent indicator 64-68 Word wrap or margin release indicator 69-73 Justification ON/OFF indicator 74-75 Line Drawing indicator (<>) 77-79 Printing >P< or Macro recording >R< or the current attribute under the cursor. @pa @tc1Line and box drawing Line and Box Drawing -------------------- EasyEdit has the facility to draw lines and boxes using the IBM extended character set. It uses the single line characters only. @tc2Drawing Lines Drawing Lines. -------------- I call this the 'pen-down' method. Its as though you put the pen down on the paper when you toggle the appropriate key. This is done using the cursor keys in much the same way as you would enter text. There are two main stages: 1. Toggle the line drawing option ON using the <Alt-F4> key. An indicator will appear in the top left of the current window status line. 2. Use the cursor keys to move the cursor which will 'pull' lines after itself. Any connections with other lines will result in the appropriate character being drawn. Note that all lines are drawn in OVERSTRIKE mode; i.e. any characters under the cursor are replaced by the lines. However, remember that you may still be in INSERT mode when entering normal text which could lead to misalignment of lines. When you are finished drawing lines, turn OFF the option using the <Alt-F4> key again. Please note that the line isn't drawn until the cursor moves. Thus, the line appears to be one character behind the cursor. This is the same as typing normal characters but looks strange when moving up, down and backwards. One of the useful things you can do with this is to have the line drawing option enabled in one window and disabled in another window (both onto the same file). In this way, you can write the text in one window and then draw boxes around it. @pa @tc2Drawing boxes Drawing Boxes. -------------- This option allows you a quick way of drawing a rectangular box on the screen. Once again, there are two stages to go through: 1. Mark one corner of the box using the <Alt-F5> key. A marker will be displayed at that point (':'). 2. Move the cursor to the opposite corner of the area you want 'boxed' and press <Alt-F5> again. A box will be drawn and the marker removed. This second mark can be above, below, left or right of the first mark. If you decide you do not want a box, move the cursor over the marker and press <Alt-F5>. The marker will be cancelled. You may not draw a box where the columns or rows are the same. If you try this, the second <Alt-F5> will be ignored. If you want single lines, use the Line Drawing as described above. If you 'lose' the position of the first mark, you may use the menu system marker option to move the cursor to it. It will be the marker displayed on the goto marker menu ( <F10>GM ) which is shown with a ':' Note that all lines are drawn in OVERSTRIKE mode; i.e. any characters under the cursor are replaced by the lines. However, remember that you may still be in INSERT mode when entering normal text which could lead to misalignment of lines. Note that you can use the macro facility to automate the drawing of lines and boxes. If you wish to print double line characters, use the character translation facility (see the appendix for details). @pa @tc1Printing Printing -------- EasyEdit has the capability to print files whilest still editing. In addition, it can print to many different printers or print to a disk file for later printing. While printing, it will initialise the printer using a user defined print string, do character translation based on a translation table and has several built in formatting commands including headers and footers and table of contents. Formatting commands all start with a '@' in column 1 followed by a 2 character code and optionally some extra information. The format character can be overridden by a parameter in the EE.CFG file. @tc2Formatting characters Formatting commands are as follows: @PO n Offset the page to the right by 'n' columns @PA Start a new page @CP n Start new page if fewer than 'n' lines remain @PN n Set page number to 'n' @OP Turn page numbers OFF @PG Turn page numbers ON @PC n Print page numbers in Column 'n' @PL n Set page length to 'n' lines @MT n Set top margin to 'n' lines @MB n Set bottom margin to 'n' lines @HM n Set header margin to 'n' lines @FM n Set footer margin to 'n' lines @HE string USe 'string' as a header on each page @FO string Use 'string' as a footer on each page @TCltext Print the text to a Table of Contents file (see below) Within the header and footer string, the following codes are valid # Insert current page number % Insert current date & Insert current time <Ctrl-K> Ignore trailing spaces on even pages \ Take the next character literally Headers and footers will NOT be printed if the top and bottom margins are set to 0. This includes page numbers. eg @FOThis line is printed on page # at % will print as a header at the top of each page as This line is printed on page 12 at 01-Mar-1987 @pa @tc2Table of contents Table of Contents. When EasyEdit prints a file, it creates a new file with the name the same as the file to be printed but with an extension of 'TOC'. This file will contain any information entered by the @TC command above. The command structure is as follows: '@TCltext' where: [Note: no spaces] @TC is the command (always starting in column 1) l is a level number from 0 to 9. text is the text to be printed. So, for example, if within your text file, you had several lines as follows: @tc0Top level - should have chapter heading @tc1This is one level down @tc1One level down @tc2This is level 2 @tc0Back to a chapter @tc1Last line @tc3Level 3 line The output might look like: Chapter 1 Top level - should have chapter heading........... 1 1.1 This is one level down.......................... 1 1.2 One level down.................................. 1 1.2.1 This is level 2............................... 1 Chapter 2 Back to a chapter................................. 1 2.1 Last line....................................... 1 2.1.0.1 Level 3 line................................ 1 The exact look of the output depends on the options specified in the EE.CFG file. The .TOC file is only created if there are some @TC commands in the print file (see hint 12 below). If you are printing the .TOC file, then a temporary .TC2 file is created. @pa @tc1Abbreviations expansion Abbreviations expansion ----------------------- @tc2Explanation Explanation EasyEdit has the ability to expand abbreviations based on a user supplied list. An abbreviation can be from 1 to 3 characters followed be a space. The expansion will be any set of up to 25 characters including spaces. There are two files involved here: a Memory file and a File file. The Memory file contains up to 50 abbreviations and their expansions which are loaded into memory when EasyEdit is invoked. The File file contains any number of abbreviations and their expansions. The filenames are controlled by the options in the EE.CFG file but the defaults are EEMEM.ABR for the Memory file and EEFILE.ABR for the File file. When the expansion is invoked (Default ALT-T), EasyEdit searches its memory list. If the abbreviation is found, the expansion is put in its place. If not, the File file is searched for the abbreviation. Expansions can be added to the File file and they will be immediately effective. Expansions can be added to the Memory file but will not be effective until the next time EasyEdit is invoked. Note that the abbreviations are case sensitive; that is, 'CAD' is not the same as 'cad'. @tc2File Structure File Structure Both file types have the same structure: Each abbreviation and expansion must be on the same line and there can only be one per line The abbreviation starts in column 1 and can be up to 3 characters. The expansion follows after 1 space and can be up to 25 characters long including spaces. eg CED Synonyms for C.E.D. CAD Computer Aided Display DP Data Processing @pa @tc0Notes on Binary files Notes on Binary files --------------------- EasyEdit (from version 2.2) has the ability to include binary files in its text as 'encoded text'. This gives the user the ability to send the file to another user via a text-only mail system and have the file unencoded at the other end back to its original form. The file format is UUENCODE and UUDECODE which are public domain algorithms. The format has been extended to be compatible with other mail programs. The text file contains the following header which EasyEdit searches for when extracting the file: <Ctrl-B><Ctrl-B><Ctrl-B>+++Binary Attachment: Filename Begin 777 Filename If you wish to change the filename before it extracted, change the FIRST one. Please be warned that if you attempt to alter the first part of the line (as shown above), the extraction may not work. @tc1Encoding a file Encoding a file To include a file for encoding (such as a Lotus spreadsheet), enter your introductory text as normal. (This could be some explanation of what the file is etc). Then, when exiting, use the <F10>FA option rather than <F10>FE option. You will be asked for the file to encode. Enter any legal filename. If the file does not exist, you are given the opportunity to re-enter it or exit without encoding. If the file does exits, a message is displayed at the top of the screen (so you know something is happening) and the binary file will then be appended to any text you may have entered. Alternatively, if on the command line, you add the switch '/AB', then the first file save will result in a binary file append. Note that, if you have multiple files open, then the binary file will be appended to the first one saved. Also, note that if the text file has not been modified, then no appending takes place. If the <F10>FA option was used, then editing continues if the current window has not been modified. @pa @tc1Decoding a file Decoding a file Decoding (or extracting) of a binary file takes place either if you add the switch '/BC' to the command line when invoking EasyEdit eg EE TEST.BIN /BC [RET] or if you edit the file and use the <F10>WE option to extract the file. Note that this option only works if the cursor is in the window with the binary data. If the file contains an encoded binary file, it will be extracted. You will be given the chance to change the file name or directory before it is written. Also, you will be given the opportunity to abort or continue if a file of the same name already exists. After the extraction, EasyEdit exits, if you used the '/BC' option, since it is assumed you do not want to view the encoded data. If you DO wish to view the file, just edit it as normal. Please do NOT attempt to change the data. I have put in rudimentary checking but it is easily fooled. You have been warned...... @pa @tc0Command Summary Command Summary --------------- This section outlines the DEFAULT keyboard layout. If you have used KBD_INST to modify any keys, then the keymapping to commands in this section could be invalid. The command list is in the same order as shown in the KBD_INST program. Command name Default keystroke Description ------------ ----------------- ----------- Left Character <Left-arrow> Move the cursor one character left. If you are at the left most column (Col 1) and the LEFTUP option is ON, then the cursor wraps back to the end of the previous line. Right character <Right-arrow> Move the cursor one character right. You may extend beyond the apparent end of the line without fear of wrapping round to the beginning of the next line. Left one word <Ctrl-Left-arrow> Move the cursor to the beginning of the previous word. A word delimitor is any character that is NOT an alpha-numeric one. Right one word <Ctrl-Right-arrow> Move the cursor to the beginning of the next word. A word delimitor is any character that is NOT an alpha-numeric one. Up one line <Up-arrow> Move the cursor up one line in the same column. Down one line <Down arrow> Move the cursor down one line in the same column. You may not go beyond the last line in the file. Scroll up <Ctrl-Z> Scroll the display one line up, keeping the cursor at it's current location. If the cursor reaches the top of the screen, it will be moved down one line. Scroll down <Ctrl-W> Scroll the display one line down, keeping the cursor at it's current location. If the cursor reaches the bottom of the screen, it will be moved up one line. @pa Down page <Pg-Down> Move the cursor to display the next screen. The number of lines moved depends on the window size. Up Page <Pg-Up> Move the cursor to display the previous screen. The number of lines moved depends on the window size. Top of file <Ctrl-Pg-up> Move the cursor to the beginning of the file. Bottom of file <Ctrl-Pg-Down> Move the cursor to the end of the file. Left of Line <Home> Move the cursor to column one of the current line. Right of line <End> Move the cursor to the last character on the current line. Top of screen <Ctrl-Home> Move the cursor to the top of the screen in the current column. Bottom of screen <Ctrl-End> Move the cursor to the bottom of the screen in the current column. Go to line 'n' <Ctrl-J L> Move to line number 'n'. A window will open with the current line number in it. Enter the line to go to. A '+' or '-' in front of the number indicates the number is relative to the current line. Go to column 'n' <Ctrl-J C> Move to column 'n' on the current line. A window will open with the current column in it and you may enter the new one. A '+' or '-' in front of the number indicates the number is relative to the current position. Go to Page 'n' <Ctrl-J P> Move to page 'n' if pagination is ON. Displays an error if pagination is OFF. Goto Window 'n' <Ctrl-J W> Go to window 'n'. A list of available windows will be shown; choose one in the normal way. Goto top block <Ctrl-Q B> Go to the start of a marked block. Goto end block <Ctrl-Q K> Go to the end of a marked block. Jump to marker <Ctrl-Q n> Jump to marker 'n'. 'n' must be between 0 and 9 and previously set @pa Set marker <Ctrl-K n> Set marker 'n'. A highlight will be displayed at the current cursor position and you can use the Jump to Marker command to return to it. Cancel it by setting the same position again. Previous position <Ctrl-Q P> Move the cursor to its previous position. Up equal indent <Ctrl-J B> Move up to the next line whose first character is at the same column as the current line. Down equal indent <Ctrl-J E> Move down to the next line whose first character is in the same column as the current line. Next Sentence <Ctrl-Q Z> Move to the beginning of the next sentence. Prev Sentence <Ctrl-Q W> Move to the beginning of the previous sentence. New Line <Ctrl-M> Insert a line break before the current cursor position. If indent is ON, position according to the previous line Insert Line <Ctrl-N> Insert a line break after the current cursor position. If indent is ON, position according to the previous line Insert Ctrl char <Ctrl-P> The next character typed after the <Ctrl-P> will be inserted into the text and not interpreted in any way. Very useful for inserting escape sequences into text. Delete char <Del> Delete the character underneath the cursor and move characters to close the gap. Delete prev char <Backspace> Delete the character to the left of the cursor position. If the cursor is at column 1, join the current line to the previous line. Delete word right <Ctrl-T> Delete the word to the right of the current cursor position. Delete to EOL <Ctrl-Q Y> Delete all characters from the current cursor position to the end of the line. @pa Delete line <Ctrl-Y> Delete the current line and move it to the delete buffer. Delete line no undo <Ctrl-Q T> Delete the current line but do not move it to the delete buffer. Find <F3> Find text. See the menu text for further description. Find and replace <Ctrl-F3> Find text and replace with other text. See the menu text for further description. Search and apply macro <Ctrl-Q M> Search for text, and if found, playback the selected macro. See the menu text for further descriptions. Find Next <F4> Continue the search using the previous text string. See the menu text for further descriptions. Edit New file <Ctrl-F2> Edit another file in the current window. You will be given the option to save the current file if it has been modified. Abandon file <Shift-F2> Clear the current window. If the file has been modified, you are given an opportunity to save it first. Press <ESC> to continue editing. Read file <Shift-F8> Read a file into the current window merging it with the current text immediately before the cursor. See the menu option for more details on this. Write block <Shift-F7> Write the currently marked and highlighted block to a file. See the menu option for more details on this. Save file <Ctrl-F10> Save the current window to a file and continue editing. Save/edit new <Shift-F10> Save the current file if modified and open a new file in the current window. Save/exit <Alt-F10> Save the current file, if modified and exit to DOS. Save to name <Ctrl-K N> Save the current window to another file. @pa Open new file <F2> Open a new or existing file into a new window on the screen. If the filename is the same as an existing edit, the windows will be 'linked' and any actions in one will be repeated in another. Close file <Alt-F2> Close the current window. If the file has been modified, you will be given an opportunity to save it. Next window <F6> Move the cursor into the next window. If zoom is ON, the next window will appear full screen otherwise, the cursor will appear at the other window. Row and column positions are preserved between windows. Previous Window <Alt-F6> Go to the previous window. Counterpart to the <F6> command above. Resize window <Ctrl-O S> Resize the current window. See the menu option for more details. Toggle window zoom <F5> Zoom the current window to full screen if not zoomed or, return to the previous state if the window is zoomed. An indicator on the status line will show if the window is zoomed. Set Block begin <F7> Mark the beginning of a block of text. It must be before the end of block marker for block actions to take place. When both top and bottom positions have been marked, the text is highlighted. Set Block end <F8> Mark the end of a block of text. It must be after the begin block marker for block actions to take place. Copy Block <Alt-F8> Copy the currently marked and visible block to immediately before the cursor. Move Block <Alt-F7> Move the currently marked and visible block to immediately before the cursor. Delete Block <Ctrl-F7> Delete the currently marked and visible block. See the menu option for more details on this. @pa Toggle block display <Ctrl-F8> Toggle the block highlight ON or OFF. Many block commands are only executed when the block is highlighted (visible). Mark current word <Ctrl-K T> Make the current word a visible block. Macro record <Ctrl-J T> Toggle macro recording ON or OFF. See the menu option for more details of this. Insert scrap (prompt) <Ctrl-J I> Insert the scrap macro 'n' times. You will be prompted for the number of times to insert (play back) the macro. See below for size limits. Insert scrap 'n' times <Ctrl-J n> Insert the scrap macro 'n' times See below for size limits Insert Macro 'n' <Alt-n> Insert (playback) macro 'n'. 'n' must be between 1 and 9. Note that the size of the macro will affect how many times it can be played back. The total number of characters that can be played back at once is 255. If a macro is greater than half that, it can only be played back once. If less than half, then the number of times is the size relative to the maximum. See the menu option for more details. Insert Macro (prompted) Insert (playback) a macro. A window will open with the existing macros listed. Choose one in the normal way. If you have macro substitution characters, the relevant onces will be inserted. See the menu option for full details. Edit Macro Edit a macro. See the menu option for more details. Load a macro file Load in a new macro file. See the menu option for more details. Save a macro file Save a set of macros to a file. See the menu option for more details. Toggle Insert <INS> Toggle between Insert and Overstrike mode for the current window. This option can be saved with the <F10>OS command. @pa Toggle Autoindent <Ctrl-Q I> Toggle autoindent mode for the current window. When ON, all new or wrapped lines will have the left margin set to the same as the previous line. when OFF, the left margin will be set to the menu item ( <F10>OML ). Toggle Word Wrap <Ctrl-O W> Toggle the wordwrap mode for the current window. When ON, any text written beyond the right margin is automatically wrapped to the next line. When OFF, editing can continue up to column 999. Toggle Justification <Ctrl-O J> Toggle right justification. Text will be evenly divided along the current line between the left and right margin to give an even look to the text. The 'current margin' is defined as the text between the right margin and either, the left margin or, if AUTOINDENT is ON, the left margin of the line above. Toggle compression Toggles space compression before wrapping text. Normally all extraneous spaces are removed before a line is wrapped. By turning this option OFF, columns of text will be preserved. However, justification will be turned OFF by this. Set left margin <Ctrl-O L> Set the left margin for the current window. See the menu option for more details. Set right margin <Ctrl-O R> Set the right margin for the current window. See the menu option for more details. Set temp margin <Ctrl-O G> Set a temporary margin at the first character of the current line. The margin is removed when a [RET] is pressed. The tab display is modified to show the status. Set Margin at cursor <Alt-F3> Set the left margin to the cursor position. This stays in effect until the next [RET] is pressed. Very useful for indenting text. The tab display is modified to show the status. @pa Set margin release <Ctrl-O X> Release the right margin to allow typing to continue without word wrap. The right margin is restored when a [RET] is pressed. The status line is updated to show this. Centre line <Ctrl-O C> Centre the current line between the left and right margins. Toggle case <Ctrl-O O> Toggle the case of either, the character under the cursor or, if a block is marked, visible and the cursor is within it, the block. Lower case <Ctrl-O V> Set the case to lower of either, the character under the cursor or, if a block is marked, visible and the cursor is within it, the block. Upper case <Ctrl-O U> Set the case to upper of either, the character under the cursor or, if a block is marked, visible and the cursor is within it, the block. Reformat <Ctrl-B> Reformat the current paragraph so it fits within the current left and right margins. Autoindent and compression are accounted for. Reformat block <Ctrl-K F> Reformat the marked and visible block as above. Blank lines are taken as paragraph markers. Toggle tab display <Ctrl-O T> Toggle the display of tab characters at the top of the screen. It only affects the display, not the tabs. Toggle mark display <Ctrl-K M> Toggle the display of text markers Toggle page display <Ctrl-O B> Toggle the display of pages on the screen. Toggle attribute display <Ctrl-O D> Toggle the display of attributes as colours or control characters. See the menu option for more details. Toggle help display <Ctrl-J K> Toggle the display of short-cut keystrokes when in the menu system Invoke DOS shell <Shift-F6> Execute a DOS command. Press [RET] for a DOS shell. See the menu option for more details on this. @pa Change dir <Ctrl-J D> Change to a new drive or directory See the menu option for more details. Get Info <Ctrl-F1> Get info on current file. See the menu option for more details on this. Show memory <Shift-F1> Show the available free memory. Directory Get a directory listing of the current or any other directory. See the menu option for more details. The following are all menu commands with no default keystroke. See the menu option for further descriptions. Set undo limit Set Path Set extension Set colours Toggle Snow control Toggle block cursor Toggle 43/50 line mode Toggle Tab expansion on read Toggle Tab writing Toggle high-bit stripping on read Set High bit stripping on read These two options set or Unset high bit stripping on read unset the action no matter what the state of the toggle Toggle default zoom state Save all defaults Tab <TAB> Move the cursor to the next tab stop (either fixed or smart) inserting spaces or tab characters if appropriate. Back-Tab <Shift-Tab> Move the cursor to the previous tab stop (fixed only). Toggle fixed tabs <Ctrl-O T> Toggle between using fixed tabs and 'smart' tabs. When smart tabs are ON, the tab settings are taken from the first character in each word on the line above the current one. Thus, the tab display is irrelevant and is toggled OFF. Edit tabs <Ctrl-O F> Edit the tabs interactively. See then menu option for more details. @pa Set tabs <Ctrl-O I> Set the tab stops according to the word spacing on the current line. Write tabs Write a representation of the tab settings into the text. This can be used later to set the tabs (see above). Set tab size Set the fixed tab spacing. Restore fixed tabs Restore tab settings to the even spacing. Print a file <F9> Print a text file in the background. If printing is already taking place, a status window will display the file, the output device and the page being printed. Otherwise, a menu will appear and you may choose various options for printing. See the menu option for more details on this. The following are all menu commands with no default keystroke. See the menu option for further descriptions. Set top margin Set bottom margin Set page length The following are all attributes which can be set for the text. When the file is printed by EasyEdit, any attribute will be converted to the appropriate print command string using the printer definition table. Set Bold <Alt-B> If a block is marked and visible, it will be set bold. Otherwise, a pair of 'bold' markers will be inserted in the text and the cursor positioned between them. Any text entered there will have the bold attribute Set DoubleStrike <Alt-D> As above but for doublestrike. Set Underline <Alt-S> As above but for underline. Set Superscript <Alt-H> As above but for superscript. Set Subscript <Alt-L> As above but for subscript. Set Compressed <Alt-C> As above but for compressed mode. Which font <Ctrl-J F> If the cursor is positioned over an attribute marker (shown in top right of status line), a description of the attribute will be shown at the top of the screen. @pa Help <F1> When editing, displays a window with the help topics in. Choose one using the arrow keys and press [RET]. When actioning a menu item, or entering information into window boxes, the help will relate to that specific item - known as context-sensitive help. Help summary <Ctrl-J H> Display a summary of how to use the help system. Key Help <Shift-F5> Display help on the function keys Other help is accessed through the Main help display. Menu <F10> Activate the menu system. Abort command <Ctrl-U> Abort any incomplete command. Undo last deletion <Ctrl-Q U> The last 20 lines deleted are saved in a delete buffer. This command restores the last line deleted and removes it from the delete buffer. Restore Line <Ctrl-Q L> Restores the line to its state when the cursor first entered it. If you move the cursor off the line, this command has no effect. Insert undo buffer <Ctrl-Q V> Insert the entire undo buffer at the cursor. Flush undo buffer <Ctrl-Q J> Clear out the undo buffer. Draw box <Alt-F5> Toggle box drawing ON or OFF. See the text above for more details on this. Toggle line drawing <Alt-F4> Toggle line drawing ON or OFF. An indicator appears on the status line to show if line drawing is ON. See the text above for more details on this. Expand abbreviations <Alt-T> Expand the previous 1-3 characters based on the abbreviations file. See above for details. @pa Check Spelling Perform a spelling check if Turbo Lightning is installed. See the menu option for further details. Append a binary file Append a binary file to the text. See above for further details. Word count current buffer Display a window containing the number of words in the current buffer. Extract a binary file Check for and, if found, extract a binary file from the file currently being edited. @pa @tc0Function key summary @tc1Alone Function Key Summary -------------------- This section summarises the action of each of the function keys. Obviously, if you have changed these with the KBD_INST program, please ignore this section. Key Name Description --- ---- ----------- F1 Help When editing, displays a window with the help topics in. Choose one using the arrow keys and press [RET]. When actioning a menu item, or entering information into window boxes, the help will relate to that specific item - known as context-sensitive help. F2 Add Window Open a new or existing file into a new window on the screen. If the filename is the same as an existing edit, the windows will be 'linked' and any actions in one will be repeated in another. F3 Find Find the occurrence of text. See the menu option for more details on this. F4 Find Next Find the next occurrence of text. See the menu option for more details on this. F5 Zoom Zoom the current window to full screen if not zoomed or, return to the previous state if the window is zoomed. An indicator on the status line will show if the window is zoomed. F6 Next window Move the cursor into the next window. If zoom is ON, the next window will appear full screen otherwise, the cursor will appear at the other window. Row and column positions are preserved between windows. F7 Mark block begin Mark the beginning of a block of text. It must be before the end of block marker for block actions to take place F8 Mark block end Mark the end of a block of text. It must be after the begin block marker for block actions to take place. F9 Print Print a text file in the background. If printing is already taking place, a status window will display the file, the output device and the page being printed. Otherwise, a menu will appear and you may choose various options for printing. See the menu option for more details on this. F10 menu Invoke the main menu system. See the menu option for more details on this. @tc1Alt Key Name Description --- ---- ----------- Alt-F1 Spare Use as you wish Alt-F2 Close window Close the current window. If the file has been modified, you will be given an opportunity to save it. Alt-F3 Margin to cursor Set the left margin to the cursor position. This stays in effect until the next [RET] is pressed. Very useful for indenting text. The tab display is modified to show the status. Alt-F4 Line drawing Toggle line drawing ON or OFF. An indicator appears on the status line to show if line drawing is ON. See the text above for more details on this. Alt-F5 Box Drawing Toggle box drawing ON or OFF. See the text above for more details on this. Alt-F6 Previous Window Go to the previous window. Counterpart to the <F6> command above. Alt-F7 Move block Move the currently marked and visible block to immediately before the cursor. Alt-F8 Copy block Copy the currently marked and visible block to immediately before the cursor. Alt-F9 Spare Use as you wish Alt-F10 Save and exit Save all modified windows and exit to DOS @pa @tc1Ctrl Key Name Description --- ---- ----------- Ctrl-F1 Get info Get info on current file. See the menu option for more details on this. Ctrl-F2 Edit new file Edit another file in the current window. You will be given the option to save the current file if it has been modified. Ctrl-F3 Find & replace Find the next occurrence of text and replace with other text. See the menu option for more details on this. Ctrl-F4 Spare Use as you wish Ctrl-F5 Spare Use as you wish Ctrl-F6 Spare Use as you wish Ctrl-F7 Delete block Delete the currently marked and visible block. See the menu option for more details on this. Ctrl-F8 Toggle block Toggle the block highlight ON or OFF. Many block commands are only executed when the block is highlighted (visible). Ctrl-F10 Save/continue Save the current window to a file and continue editing. @pa @tc1Shift Key Name Description --- ---- ----------- Shft-F1 Show free mem Show the amount of free memory. Shft-F2 Abandon edit Clear the current window. If the file has been modified, you are given an opportunity to save it first. Press <ESC> to continue editing. Shft-F3 Spare Use as you wish Shft-F4 Spare Use as you wish Shft-F5 Key help Quick help for the actions of the function keys. Shft-F6 Dos command Execute a DOS command. Press [RET] for a DOS shell. See the menu option for more details on this. Shft-F7 File block Write the currently marked and highlighted block to a file. See the menu option for more details on this. Shft-F8 Read file Read a file into the current window merging it with the current text immediately before the cursor. See the menu option for more details on this. Shft-F9 Spare Use as you wish Shft-F10 Save/switch Save the current file if modified and open a new file in the current window. @pa @tc0Menu summary @tc1Description Menu Summary ------------ This section explains each menu choice activated by the <F10> command. Each menu choice is followed by the 'accelerator key'; the shortcut way to choose that option. This shortcut key may have changed if you have modified the defaults using KBD_INST. The Menu System is where the power of EasyEdit lies. By using the options available here, editing files is made very easy. The menu system is activated by pressing the <F10> function key. If you have modified this using KBD_INST, the new keystroke will be displayed in the top right of your screen. The top of the screen will change to show the top-level menu system, with the last option selected being highlighted. You get out of any menu item by pressing the <ESC> key. An example is displayed below ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └──────────────────────────────────────────────────────────────────────────────┘ To select a menu option either: Move the highlight to the item using the arrow keys and press [RET] (the highlight will 'wrap around' if you press it too many times) or Press the letter corresponding to the first letter of the menu item (usually highlighted) NOTE ---- a. If there are no open windows on the screen, the menu choice is restricted to those items which are relevant. b. When you select an option from the main menu, a submenu will appear. Choose an item in exactly the same way. c. If you are choosing an option for the second or subsequent time, EasyEdit 'remembers' your last choice and positions the highlight at that entry. @pa @tc1File menu FILE menu --------- This controls a lot of the file routines. ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └┬─────────────────┬───────────────────────────────────────────────────────────┘ │ Open.. │ │ Close │ │ Save │ │ Write to.. │ │ Print.. │ │ Get info │ │ Exit │ │ Add Binary/exit │ │ Quit │ └─────────────────┘ @tc2Open A) Open <F2> This option allows you to read a file into a NEW window. It will prompt you for a filename, read in the file and position the cursor according to the .R_C file (if found). If the previous window was Zoomed, then the new window will be zoomed. @tc2Close B) Close <Alt-F2> This option will close the current window. If the file had been modified, you will be given an opportunity to save it first. If it is the last window on the screen, you will be returned to the menu system. @tc2Save C) Save <Ctrl-F10> This option allows you to save your current editing and continue working. The .R_C file is also updated at this time. @tc2Write to.. D) Write to ... <Ctrl-K N> This option allows you to write the current file to a new filename. You will be asked for a new filename. If it already exists, you will be asked to confirm that it is OK to overwrite it. The .R_C file is updated at this time and the current editing window will show the new filename. @pa @tc2Print E) Print <F9> A window will be presented similar to the one below. You need to set all the items correctly and then press 'P' or select the 'Print file now' option to start printing. If you are printing the file being edited, it MUST be saved first (<Ctrl-F10>). An error message will be displayed if the file is not saved first. Look at the modified flag '*' at the top of the screen to verify if it needs saving first. Printing takes place in the background so you may continue editing after starting the print off. A symbol <P> at the top right of the screen indicates that printing is taking place. To abort printing, choose the print option again and answer 'Y' to the 'Abort ?' command. ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └┬─────────────┬───────────────────────────────────────────────────────────────┘ │ Open.. │ │ Close │ │ Save │ │ Write ┌─────────────────────────── Print Setup ───────────────────────────┐ │ Print.│ Print file now │ │ Get in├───────────────────────────────────────────────────────────────────┤ │ Quit │ Name of file │ └───────│ Auto formatting ON │ │ First page 1 │ │ Last page 4095 │ ├───────────────────────────────────────────────────────────────────┤ │ Which printer PLAIN.PDF │ │ Device LPT1 │ │ Manual paper feed OFF │ │ Use formfeeds OFF │ │ Edit printer codes │ │ Save printer setup │ └───────────────────────────────────────────────────────────────────┘ @tc3Print a) Print file now Select this option when all the other options are correct and the file has been saved. @tc3Name b) Name of file The default is the first file read in. If you wish to change it, you will be presented with a window in which to enter the new file name. The usual editing rules apply here. @tc3AutoFormatting c) Auto Formatting This is a toggle which you change by pressing [RET]. It allows you to print files 'as is' or with page formatting. @tc3First Page d) First page Enter the first page you want to print. It must be less than or equal to the last page. @pa @tc3LastPage e) Last page Enter the last page to be printed. There is a maximum of 4095 pages allowed in one file and you will not be allowed to exceed that. @tc3Printer type f) Which printer. EasyEdit can print to a variety of printers controlled by a printer definition file (.PDF extension). This option allows you to choose which printer codes will be sent to the printer. The name of the .PDF file is saved with the <F10>OS option. At the same time the .PDF file is chosen, a character translation table file will be opened if present. See the appendix for more details. @tc3Device g) Device. EasyEdit can print to any Dos device (LPT1-3, COM1-2) or to a file. You select which one here. You will be presented with a menu choice. Use the arrow keys to select the correct option and press [RET]. If you choose a file, you will be asked for the output filename. All printer codes will be converted according to the printer type. @tc3Paper feed h) Manual paper feed This is a toggle - If YES, you will be asked to insert the next sheet of paper after each page - if NO, printing will not stop. Press [RET] to toggle the option. @tc3Form feed i) Use form feeds This is a toggle - if YES, the print routine will send a form feed character to the printer (^L) to move to a new page - if NO, then the paper will be advanced by multiple line feeds. Press [RET] to toggle the option. This option is saved in the .PDF file. @pa @tc3Edit printer codes j) Edit printer codes. This option allows you to edit the printer codes associated with an attribute (eg Bold) for the particular printer. Each attribute will have two codes: one to turn it ON and another to turn it OFF. You will be presented with a menu selection as follows: ┌─ Printer Strings ─┐ │ Initialization │ │ Reset │ │ Bold text ON │ │ Bold text OFF │ │ Doublestrike ON │ │ Doublestrike OFF │ │ Underscore ON │ │ Underscore OFF │ │ Superscript ON │ │ Superscript OFF │ │ Subscript ON │ │ Subscript OFF │ │ Compressed ON │ │ Compressed OFF │ │ Italic ON │ │ Italic OFF │ └───────────────────┘ For each option, a window will open and you may enter the text string associated with each attribute. The 'Initialisation' and 'reset' options take effect on starting and stopping printing. To enter 'special' text such as the <ESC> key, press the SCROLLOCK key first, then the <ESC> key, then SCROLLOCK again to revert to normal. Press [RET] when finished or <ESC> to abort the edit. @tc3Save printer setup k) Save printer setup. This option allows you to save the printer codes to a new file. This is the mechanism whereby new printer files (.PDF) are created. @tc2Get info F) Get info <Ctrl-F1> This option displays information about the current file being edited, some environment information and the name and address of the licensee. Press <ESC> to continue working. @tc2Exit G) Exit <Alt-F10> This option saves any files which have been modified and exits back to DOS. @pa @tc2Add Binary/exit Add Binary/exit This option asks for a binary file to append, encodes it to the current buffer (if modified) and then exits. See above for more information. Note that if the current window has not been modified, then this option has no effect. @tc2Quit I) Quit <Shift-F2> This option allows you to quit from the editor. If any files in any window have been modified, you are given an opportunity to save before exiting. @pa @tc1Window menu Window menu ----------- This controls the display and sizing of windows on the screen ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └─────────┬───────────────┬─────────────────────────────────────────────────────────┘ │ Go to.. │ │ Zoom OFF │ │ Previous │ │ Next │ │ Resize │ │ Extract Binary│ └───────────────┘ @tc2Goto A) Goto <Ctrl-J W> This option allows you to select a window from those displayed on the screen. If only one window is open, nothing happens. Otherwise, a menu appears with the filename of each window. Select one by using the arrow keys to move the highlight and press [RET] or by pressing the number associated with the window. @tc2Zoom B) Zoom <F5> This is a 'toggle' option. It allows you to expand the current window to full size, thus hiding all other windows, and return it to its previous size. An indicator at the top left of the status screen tells you if the window is 'zoomed'. @tc2Previous C) Previous <Alt-F6> Make the previous window current. The cursor will move into the previous window and you may continue editing there. @tc2Next D) Next <F6> Make the next window current. The cursor will move into the previous window and you may continue editing there. @tc2Resize E) Resize <Ctrl-O S> This allows you to adjust the size (number of rows) of a window in a multi-window display. Use the up and down arrows to adjust the size and press [RET] when you are ready to continue editing. [Works great with the mouse]. F) Extract Binary This option will check for, and extract if it finds it, an encoded binary file from the file in the window you are currently editing. It looks at the file on disk and ignores any changes you may have made since you last edited the file. Before writing the file, the name is presented on the screen. You may change it to another one at this point. After that, the filname is checked to see if there is one of the same name already in existance, in which case, you are given the chance to overwrite it, and the file is extracted. @pa @tc1Text menu Text Menu --------- ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └─────────────────┬──────────────────┬─────────────────────────────────────────┘ │ Format paragraph │ │ Temporary margin │ │ Margin release │ │ Attribute.. │ │ Center line │ │ Set marker.. │ │ Restore line │ │ Undelete │ └──────────────────┘ @tc2Format paragraph A) Format paragraph <Ctrl-B> This option will format the text from the current cursor position to the end of the paragraph to make it fit between the left and right margins. If right justification is ON, the text will be adjusted by inserting spaces so the right margin is even and not ragged. If word wrap is OFF, this command will have no effect (no right margin !). @tc2Temporary margin B) Temporary margin <Ctrl-O G> This option moves the current left margin one tab stop to the right and remains in force until you finish the current paragraph (press [RET]). @tc2Margin release C) Margin release <Ctrl-O X> This option allows you to type beyond the current left and right margins. It is indicated by the words 'Marg Release' on the status line. You turn it off by selecting that option again. @tc2Attribute D) Attribute This leads to a further sub-menu where you can select a text attribute to be applied to the current marked block (if selected) or, if no block is selected, a pair of attribute markers will be entered into the text and the cursor placed between them. See the appendix on attributes for a description of this process. @tc2Centre line E) Centre line <Ctrl-O C> This will centre the current line between the left and right margins if wordwrap is ON. @pa @tc2Set marker F) Set Marker <Ctrl-Kn> This option will set a marker at the current cursor position. You can have up to 10 of these in the text. When you set a marker, a highlighted number will appear to overwrite the text; however, it has not deleted anything. You delete markers by selecting the same marker again at the same place. If you use the menu system to set a marker, you will be presented with a list of current markers in use. Select one by pressing the number associated with the option you require. If you use the shortcut keys and use existing markers, the old markers will be deleted automatically. @tc2Restore line G) Restore line <Ctrl-Q L> This option will restore the current line to its original state when you started modifying it. It will NOT work if you have moved the cursor to a new line. @tc2Undelete H) Undelete <Ctrl-Q U> When complete lines of text are deleted <Ctrl-Y>, they are placed on an 'undelete buffer'. You can restore these lines one at a time with this command. @pa @tc1 Block menu Block commands -------------- These commands control actions that can be done with blocks of data. Most of the commands are duplicated with function keys which is a much quicker way of operating the block commands. ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └─────────────────────────────┬─────────┬──────────────────────────────────────┘ │ Begin │ │ End │ │ Hide │ │ Copy │ │ Move │ │ Delete │ │ Write.. │ │ Read.. │ │ Format │ └─────────┘ @tc2Begin A) Begin <F7> Set the beginning of a marked block where the cursor lies. If an 'end block' has already been set and it is below the 'begin block', the block will be highlighted. @tc2End B) End <F8> Set the end of a marked block where the cursor lies. If a 'begin block' has already been set and it is above the 'end block', the block will be highlighted. @tc2Hide C) Hide <Ctrl-F8> This is toggle to alternately turn the block highlight on and off. It does NOT hide the text, only the highlight. @tc2Copy D) Copy <Alt-F9> Copy the current marked block to immediately BEFORE the cursor position. The new text becomes the marked block. @tc2Move E) Move <Alt-F7> Move the current marked block to immediately BEFORE the cursor position. @tc2Delete F) Delete <Ctrl-F7> Delete the current marked block. The last 20 lines (default) of the text are actually moved into the delete buffer so it is possible to restore them. @tc2Write G) Write <Shift-F7> Write the marked block to a text file. You will be prompted for a filename and the text will be written out. @pa @tc2Read H) Read <Shift-F8> Read in a text file (block of text) to immediately BEFORE the current cursor position. You will be prompted for a filename; enter '*.*' if you want to choose from a list; and the text will be read in. @tc2Format I) Format <Ctrl-K F> Format the current marked block. The block must be highlighted and the cursor must be positioned inside it or an error message will result. @pa @tc1 Goto menu Goto Commands ------------- These commands are all concerned with positioning the cursor at a suitable point in the file. ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └───────────────────────────────────┬─────────────────┬────────────────────────┘ │ Page number.. │ │ Line number.. │ │ Column number.. │ │ Top of file │ │ Bottom of file │ │ Marker.. │ │ Start of block │ │ End of block │ └─────────────────┘ @tc2Page A) Page Number <Ctrl-J P> If page numbering is ON, you will be presented with a window in which to enter the page number you wish to go to. Valid answers are between 1 and 4095. If page numbering is OFF, an error message will appear on the screen. Press <ESC> to continue.If you enter a '+' or a '-' before the number, the cursor will be moved by that amount in the relevant direction. @tc2Line B) Line number <Ctrl-J L> You will be presented with a window in which to enter the line number. This is always relative to the top of the file whether page numbering is ON or OFF.If you enter a '+' or a '-' before the number, the cursor will be moved by that amount in the relevant direction. @tc2Column C) Column number <Ctrl-J C> You will be presented with a window in which to enter the column number. Valid answers are between 1 and 999. If you enter a '+' or a '-' before the number, the cursor will be moved by that amount in the relevant direction. @pa @tc2Top of file D) Top of file <Ctrl-PgUp> The cursor will be moved to the top of the file. @tc2Bottom of file E) Bottom of file <Ctrl-PgDn> The cursor will be moved to the bottom of the file. @tc2Marker F) Marker <Ctrl-Q n> Jump to a previously set marker. If you invoke this from the menu system, a menu of previously set markers will appear and you can select one of them in the normal way. You may also use this option to goto a previously set box marker. This will be the LAST marker displayed in the menu system. @tc2Start of block G) Start of block <Ctrl-Q B> Jump to the start of a block of data (set with the <F7> key). The block does not need to be visible. @tc2End of block H) End of block <Ctrl-Q K> Jump to the end of a block of data (set with the <F8> key. The block does not need to be visible Hint - The above two commands give you two extra markers to use. @pa @tc1Search menu Search menu ----------- These commands are concerned with find/replace text options. ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └──────────────────────────────────────────────┬─────────────┬─────────────────┘ │ Find.. │ │ Replace.. │ │ Use macro.. │ │ Again │ └─────────────┘ @tc2Find A) Find <F3> This allows you to search through the text for a specified word or phrase. Control characters can be included by preceding them with <Ctrl-P>. You can search for an end-of-line by including <Ctrl-P><Ctrl-M><Ctrl-P><Ctrl-J>. You may NOT search for phrases that span lines. After you have entered the search string, you will be asked for a letter, or combination of letters, from the list below to modify the search action. After that, the string will be searched for and, if found, highlighted until the next character is pressed. The options available are: U Ignore case. Thus, 'EasyEdit' is the same as 'easyedit'. B Search backwards from the current cursor position. The default is to search forwards towards the end of the file W Search whole words only for the search string. Thus, if the string is 'Easy' then it will NOT be found in 'EasyEdit'. G Search globally throughout the file starting at the beginning, no matter where the cursor is. L Search locally, only within the current marked block. n Find the nth occurrence of the text. 'n' is an integer. Note that the default options can be set using the SEARCHINIT option in EE.CFG. @pa @tc2Replace B) Replace <Ctrl-F3> This allows you to search through the file for a string of letters and replace it with another. Control characters can be included by preceding them with <Ctrl-P>. You can search for an end-of-line by including <Ctrl-P><Ctrl-M><Ctrl-P><Ctrl-J>. You may NOT search for, or replace, phrases that span lines. After you have entered the search string and the replace string,, you will be asked for a letter, or combination of letters, from the list above to modify the search action. After that, the string will be searched for and, if found, a window displayed with the text highlighted and 4 options for you to make: Y - Make the change N - Do not make the change but continue on to the next change A - Make the change and then all further changes. Q - Do not make the change and quit further searching. There is one extra search option and one changed option: N Do not prompt for confirmation as above. n Make the changes 'n' times - 'n' is an integer. @tc2Use macro C) Use macro <Ctrl-Q Enter> This option will search for a specified string and, if found, will apply a specified macro to it. This can be very useful for doing more extensive search/replace functions than is possible with the standard one. The modifiers are all as above. @tc2Find next D) Find next <F4> This will use the previous search string and locate the next one in the same direction as before. It will use the options as outlined above, except for the 'G' option; find-next will continue from the current find. If a Find-replace option was the last one executed, then this command will repeat that. If a 'Find and execute Macro' command was the last one executed then this command will repeat that. If any of the find or find/replace options are repeated, the text string last used will be displayed. If you wish to use it or modify it, use the arrow keys to position the cursor. Any other key will destroy the text to allow new information to be entered. @pa @tc1Option menu Option menu ----------- This menu allows you to change the layout and display of the Easyedit system. Most of these options can be saved using the 'Save Setup' menu item. ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └────────────────────────────────────────────────────┬─────────────────────┬───┘ │ Margins.. │ │ Format options.. │ │ Tabs.. │ │ Load file options.. │ │ Display options.. │ │ Colours.. │ │ Save setup │ └─────────────────────┘ @tc2Margins a) Margins.. ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └────────────────────────────────────────────────────┬─────────────────────┬───┘ │ Margins.. │ │ Format options.. │ │ Tabs.. │ │ Load file options.. │ ┌──────────────────┐tions.. │ │ Left 1 │ │ │ Right 70 │ │ │ Top 3 │──────────┘ │ Bottom 3 │ │ Page length 66 │ └──────────────────┘ This leads to a sub menu where you can change the left, right, top and bottom margins plus the page length (in lines). You will be presented with a window with a default value (usually the old value). Enter the new value followed by [RET]. To exit from the menu system, press <ESC>. @pa @tc2Format b) Format options.. ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └────────────────────────────────────────────────────┬─────────────────────┬───┘ │ Margins.. │ │ Format options.. │ │ Tabs.. │ │ Load file options.. │ ┌────────────────────┐ons.. │ │ Justify ON │ │ │ Word wrap ON │ │ │ Autoindent ON │────────┘ │ Insert mode ON │ │ Page breaks OFF │ │ Compress wrap ON │ └────────────────────┘ This leads to a sub menu where you can change the following: @tc3Justify a) Justify <Ctrl-O J> This is toggle ON or OFF. Press [RET] to change it. When ON, all text will be right and left justified between the current margins by adding spaces between words. WordWrap must be ON. The 'current margin' is defined as the text between the right margin and either, the left margin or, if AUTOINDENT is ON, the left margin of the line above. @tc3Wordwrap b) WordWrap <Ctrl-O W> This is a toggle ON or OFF. Press [RET] to change it. When ON, all text will be wrapped at the right margin. When OFF, text entered will continue up to column 999 if necessary. [See hint 10. at the end of this manual] @tc3Autoindent c) Autoindent <Ctrl-Q I> This is a toggle ON or OFF. Press [RET] to change it. When ON, the left margin of a new line will be set to the first character of the line above. When OFF, the left margin of a new line will be set to the left margin as defined by the margins menu. @tc3Insert d) Insert <INS> This is a toggle ON or OFF. Press [RET] to change it. When ON, all text is inserted, pushing other characters to the right. when OFF, all text will overwrite other characters. This does not affect block moves which operate in insert mode regardless of the status of this toggle. @tc3Page Breaks e) Page Breaks <Ctrl-O B> This is a toggle ON or OFF. Press [RET] to change it. When ON, the page breaks will be displayed in a column at the left of the screen and constantly updated in background mode. All text is pushed one character to the right. When OFF, page breaks are not displayed or calculated. @pa @tc3Compress wrap f) Compress Wrap This is a toggle ON or OFF. Press [RET] to change it. When ON, all extra spaces on a line between the left and right margins will be removed before word wrap takes place. When OFF, this will not happen. This can be very useful for preserving columns of figures for example. @pa @tc2Tabs c) Tabs ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └────────────────────────────────────────────────────┬─────────────────────┬───┘ │ Margins.. │ │ Format options.. │ │ Tabs.. │ │ Load file options.. │ ┌───────────────────┐ions.. │ │ Set tabs │ │ │ Put tabs │ │ │ Restore even │─────────┘ │ Edit tabs │ │ Display tabs ON │ │ Fixed ON │ │ Tab size 4 │ └───────────────────┘ This option leads to a submenu where tabs can be adjusted. This is very powerful and can aid enormously in the layout of a document. There can be a maximum of 40 tab stops on the line. @tc3Set tabs a) Set Tabs <Ctrl-O I> The tabs will be initialised based on the words on the current line of text. This can be very useful for columns of figures etc. Used in conjunction with 'Put Tabs', different tab settings can be stored and used within one document. @tc3Put tabs b) Put Tabs The current tab settings are stored within the document as a line of text. Tab settings can thus be restored using the 'Set Tabs' option above. Since the line begins with an '@' symbol, it will not be printed using the Print menu. However, it is normal ASCII text and can be used as such. @tc3Restore even c) Restore even Tab settings will be restored to an even spacing depending on the tab size. @tc3Edit tabs d) Edit Tabs <Ctrl-O E> This option allows you to manually enter the tab stops using the left and right cursor keys to position the cursor and the space bar to toggle the tabs ON or OFF. In addition, pressing the <INS> key will add a new tab and pressing the <DEL> key will delete a tab. Press [RET] when finished or <ESC> to abort. @tc3Display tabs e) Display tabs <Ctrl-O T> This option toggles the display of tab characters at the top of the window. It does not affect the use of the tab key. Press [RET] to toggle between ON and OFF. @pa @tc3Fixed tabs f) Fixed Tabs <Ctrl-O F> This is a toggle ON or OFF. Press [RET] to change it. When ON, tab settings are taken from the display at the top of the page. When OFF, tab settings are taken from the contents of the line above the current one. @tc3Tab size g) Tab Size This option allows you to set the fixed tab spacing. Enter any size less than the current work area size (right-left margin). The tabs will be updated in the current window when you use the 'restore even' option. @pa @tc2Load file options d) Load file options ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └────────────────────────────────────────────────────┬─────────────────────┬───┘ │ Margins.. │ │ Format options.. │ │ Tabs.. │ │ Load file options.. │ ┌───────────────────────────────┐ns.. │ │ Home directory F:\TP\EE\ │ │ │ File extension │ │ │ Expand tabs ON │───────┘ │ Write tabs OFF │ │ Strip hi-bit OFF │ │ Undo limit 20 │ └───────────────────────────────┘ This option leads to a sub menu concerned with options regarding file loading and saving. @tc3Home directory a) Home directory This is the directory where EasyEdit expects to find its initialisation files, printer definition files and macro files. When you select this option, a window opens with the current directory specification displayed. Edit or enter a new one and press [RET] to accept it. The option is saved using the 'Save Setup' item (see below) so this only needs to be done once. @tc3File extension b) File extension. If you regularly work with the same type of file, you can enter a default extension here (just the letters) and it will be added to any file specification when opening new or existing files. @tc3Tab expansion c) Tab expansion This is a toggle ON or OFF. Press [RET] to change it. When ON, any tabs entered from the keyboard will be expanded to the equivalent number of spaces. When OFF, they will be left as <TAB> characters. @tc3Write tabs d) Write tabs This is a toggle ON or OFF. Press [RET] to change it. When ON, all sequences of spaces will be translated to tabs according to the fixed spacing defined by the tab size. When off, spaces are written out as normal. Note that any spaces within single (') or double (") quotes will NOT be translated to tabs. This is for writing program code. @pa @tc3Strip hi-bit e) Strip Hi-Bit This is a toggle ON or OFF. Press [RET] to change it. When ON, any character with the high bit set will have it stripped off when the file is read in. This is to be able to read in 'wordstar' compatible files. Note that it will also affect the IBM line drawing characters. When OFF, this option is disabled. Also any wordstar 'dot' commands will be converted to Easyedit '@' commands. @tc3Undo limit f) Undo limit This is the maximum number of lines which will be saved when a line is deleted from the main body of your text using the 'delete line' or 'delete block' commands. Further deletions will remove the oldest deleted line from the delete buffer. @tc2Display options e) Display options ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └────────────────────────────────────────────────────┬─────────────────────┬───┘ │ Margins.. │ │ Format options.. │ │ Tabs.. │ │ Load file options.. │ │ Display options.. │ ┌──────────────────┐ │ │ Snow control OFF │ │ │ Block cursor OFF │──────────┘ │ 43/50 line OFF │ │ Font display ON │ │ Key help ON │ │ Zoom state OFF │ └──────────────────┘ This section controls the 'look' of the display. A further sub-menu will appear with the following options: @tc3Snow control a) Snow control If you have a CGA monitor, toggling this option ON will alleviate the 'snow' problem when the display is scrolled. @tc4Block cursor b) Block cursor The normal cursor is a flashing underline. On some monitors, noticably LCD ones, this is very hard to see. Toggle this ON to have the cursor as a non-flashing block. @tc343/50 line display c) 43/50 line This is a toggle for EGA/VGA displays between the normal 25 line display and 43 or 50 line displays. @tc3Font display d) Font display. <Ctrl-O D> This is a toggle to either display the fonts in their colours or to display the control characters which mark the sides of each font type. @pa @tc3Key help e) Key help. <Ctrl-J K> This is a toggle to control the display of the 'keyboard shortcut' keys when a menu option is shown. Only the primary key code is shown. @tc3Zoom state f) Zoom state. This is a toggle which controls the initial Zoom state when files are read in. Toggle it ON to always have full screen windows; toggle it OFF to have tiled windows. The state can be dynamically changed with the <F5> key. @tc2Colours f) Colours.. This leads to a display similar to the one below. The cursor is positioned by the 'colours' window with all the options displayed in the 'choices' window. Move the cursor up and down to select the text type to be modified and press [RET] to select that one. Then, use the arrow keys to move the '*' to the colour you wish and press [RET] to select it. Continue in this fashion until all colours are correct and then press <ESC> to return to the previous menu. The colours are saved as a default. ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └────────────────────────────────────────────────────┬─────────────────────┬───┘ │ Margins.. │ │ Format options.. │ ┌────── Colours──────┐ │ Tabs.. │ │ Normal Text │ │ Load file options.. │ │ Marked Block │ │ Display options.. │ │ Window Status │ ┌─── Choices ────┐ │ Colours.. │ │ Prompt Line │ │ │ │ Save setup │ │ Block Cursor │ │ * │ └─────────────────────┘ │ Menu Text │ │ │ │ Menu Frame │ │ │ │ Menu Select │ │ │ │ Menu Hilite │ │ │ │ Bold text │ │ │ │ Doublestrike │ │ │ │ Underscore │ └────────────────┘ │ Superscript │ │ Subscript │ │ Compressed │ │ Italic │ └────────────────────┘ @tc2Save setup g) Save Setup Most of the options and toggles are saved inside EE.EXE when you select this option. This includes colours, margins, tabs and toggles. The colours are also saved in a colour file. Enter a legal filename when requested or press [RET] to bypass this portion. The file EE.EXE must exist in the 'home directory' or the current directory as defined above. @pa @tc1Utilities menu Utilities menu -------------- This option has all the utility commands and functions. ┌──────────────────────────────────────────────────────────────────────────────┐ │ File Window Text Block Goto Search Options Utilities │ └──────────────────────────────────────────────────────┬──────────────────────┬┘ │ Spelling check │ │ Macros.. │ │ Directory.. │ │ Change directory.. │ │ Operating system.. │ │ Help │ └──────────────────────┘ @tc2Spelling check a) Spelling check <Ctrl-F9> Spell check the document in the current window. The spelling checker is quite unique in the text editing world. This one uses the Borland Turbo Lightning engine to actually do the work. If you don't have Lightning installed, an error message is displayed. If no block is visible, EasyEdit will check the entire document FROM THE CURSOR DOWN. If you wish to check the entire document, position the cursor at the beginning of the document first (Ctrl-PgUp). If a block is marked and visible, EasyEdit will check the spelling only within that block. The cursor does not need to be within the block but it will be positioned at the end of it when the spelling check is finished. At any time, you can press any key to cancel the spell checking. A prompt box will be displayed for you to confirm that you wish to cancel the spell checking. Press <Y> to cancel or <N> to continue. If a word is mis-spelled, the checking will pause and you will be presented with a menu with the following options. Select one in the normal way or press <ESC> to cancel the spell checking. a) Skip once. Move onto the next word, ignoring this one. b) Ignore for this document Assume that the spelling is correct for any other occurrence of this word. @pa c) List Lightning sound-alikes. This lists alternatives in the Lightning dictionary. It includes words that look similar and sound similar. Choose one of the words and it will replace the text in question (or press <ESC> to return to this menu). d) Edit from the keyboard. You will be presented with a window with the current word in it. Edit it as normal (see beginning of manual for instructions). Press [RET] when finished or <ESC> to return to this menu. e) Mark with "~". The word in question will be preceded by a '~' (tilde) character and spell checking will continue. You can then go back and edit the word later by searching for a '~' character. f) Batch mark the rest of the document. All remaining words in question will be preceded by a '~'. More information on the Turbo Lightning spell checker is available when you purchase the product. @pa @tc2Macros b) Macros. One of the good things about EasyEdit is its ability to save and replay keystrokes at your command. This is known as the 'macro' facility. A default macro file can be loaded at startup - see the initialisation file or command line options for more details. There is a maximum of 10 macros allowed - however, macro 0 (also known as the 'scrap' macro) is used whenever a new macro is created. Each macro can have a maximum of 255 keystrokes. You can extend this by having one macro call another (and of course, the last macro can load in a new macro file). @tc3Load macros a) Load macros This option allows you to load in a new set of macros. You will be presented with a window with '*.MAC' as the default filename. Enter the name of the macro file you wish to load or press [RET] to select from the available ones in the current directory. By default, all macro files have an extension of '.MAC'. You do not need to enter the extension to the filename. @tc3Store macros b) Store macros This option allows you to save the macros in memory to a named file. If this is not done, all new macros will be lost on exit from EasyEdit. You will be presented with a window in which to enter the filename. You do not need to enter an extension. @tc3Playback macros c) Playback macros <Alt-n> This option is for playing back previously created macros. A window will open showing the names of all the currently loaded macros. Select one by pressing its number of using the cursor keys to move the highlight and press [RET]. The macro will be executed and you will be returned to editing your document. The 'shortcut' key is ALT-n where 'n' is a number between 0 and 9. @pa @tc3Record macros d) Record <Ctrl-J T> This is a toggle to turn ON and OFF macro recording. When this option is selected, all keystrokes following, until the next time this option is selected, are stored in the scrap macro. When you have finished, you will be asked to enter a number for the macro. The titles of all existing macros, plus blank spaces where no macro exists, will be displayed for reference and you may choose one in the normal way. An editing window is then opened for you to enter a title for that macro. When macro recording is ON, an indicator (>R<) appears at the top right of the status line. @tc3Edit macros e) Edit This option allows you to edit an existing macro. You will be asked to select a macro from the list and then allowed to edit its title. After that, a window will open with the keystrokes displayed. All normal keys are displayed as they are entered - function keys are displayed enclosed in angle brackets '<>' with a representation of the keystroke (eg <Ctrl-F10> or <Alt-8>). You may use the normal cursor movement keys to position the cursor at the editing point and then insert, delete or change as you wish. Press [RET] when editing is complete. Press Ctrl-Backspace to clear the current macro. If you wish to enter any key into the macro that would normally 'do something', press the 'SCROLLOCK' key first. Any further keystrokes will be inserted until you press 'SCROLLOCK' again. Thus, you may enter [RET], arrow keys etc into the macro. Del, Backspace, Ctrl-backspace, Escape and Enter are the keystrokes concerned. @pa @tc3Macro Substitution Macro substitution ------------------ While editing, you can use certain special characters to denote that, when the macro is played back, the characters will be substituted for other things. This facility allows you to tailor the macros to include such things as the current date, or a title input at playback time etc. To invoke the substitution, enter the special character, ASCII 255 followed by one of the following: F - The filename in the window which was current when the macro was started will be put into the macro at that point. D - The current date will be inserted into the macro. T - The current time will be inserted into the macro. S - Get a string from the keyboard at 'playback' time. The 'S' must be followed by a string of characters terminated by ASCII 254. This string will be used as a prompt in an edit window and whatever you type in (max 60 characters) will be inserted into the macro at that point. To get the ASCII characters 255 and 254 into the macro, you must use the MACRO EDIT facility. Hold down the ALT key and type the numbers USING THE NUMERIC KEYPAD. Then, let go of the ALT key. The number will appear in the edit window as <#255>. Note well: There can only be a maximum of 255 characters per macro even after all the substitution has taken place. If substitution takes the macro to larger than 255 characters, then substitution is ignored and the macro is inserted 'as is'. @pa @tc2Directory c) Directory... This option allows you to get a directory listing of the current (or any other) directory. A window will open into which you can enter a directory mask (press [RET] for the whole directory). Wildcards (* or ?) are permitted.You can then browse up and down the listing using the arrow keys, the 'home' and 'end' keys and the 'pg-up' and 'pg-dn' keys. Press <Esc> or [RET] when finished. @tc2Change directory d) Change directory You may change the current directory here. An editing window will open and you can enter the new directory specification. If you enter a wild card specification (eg C:\TP\*), a list of all directories in the C:\TP directory will be displayed and you may choose one in the normal way. Obviously, the directory must exist. @tc2Operating system e) Operating system <Shift-F6> This option allows you to to execute any DOS command (or program) as long as there is sufficient memory. An editing window will open and you may enter the command you wish to execute. Press [RET] to invoke a DOS shell (Type EXIT to return to EasyEdit in that case). @tc2Help e) Help Get help on the EasyEdit system. A window will open and you can use the cursor keys to position the highlight on the option you require help with. You can also press the first (highlighted) letter of the help description to jump straight there. Once the help window is opened, you can use the up and down arrow keys or the <pg-up> and <pg-dn> keys to move between pages. @pa @tc0Appendix Appendix -------- @tc1Character Translation Tables Character Translation Tables ---------------------------- EasyEdit has a unique item amongst text editors (or even most word processors); up to 64 characters can be translated on printing to one or more alternative characters. This can be extremely useful if the printer you wish to use has a different character set for certain special characters. Two examples are a) HP LaserJet uses a different ASCII value for a '£' sign b) DEC printers have a different way of printing box drawing characters. The translation file has the same name as the Printer Definition File but has an extension of .CHT. It can be created with any text editor and has the following format: Col 1 - Character to be translated Col 2 - Ignored. Col 3-66 - String of characters to replace the original (max 64). There can be up to 64 of these translations. It is loaded automatically when EasyEdit is invoked or when you change printers using the Print Setup menu option. Be aware that if you wish to test this, you MUST specify a different name on the Setup menu or the file is not reloaded (done for speed). I have provided an example .CHT file which converts the IBM line and box drawing characters to DEC VT100 special characters. The file is LA75DEC.CHT and is loaded automatically when you specify the LA75DEC printer in the Print Setup menu. There are also other examples provided by users of EasyEdit. @pa @tc1Networking EasyEdit Networking EasyEdit EasyEdit has the facility to work well on a network. All configuration files are opened in Read-Only mode and printing is terminated properly. The only provisor that MUST be made is that the option to edit the last file (EDLAST in EE.CFG) must be turned OFF. @tc2Installing EasyEdit in a network Installing EasyEdit in a network Put all files onto a networked drive. Set all the configuration options up (hint, use the '%parameter%' options for any options which the user might want to change). If EDLAST is ON in EE.CFG and the 'home' directory is a read-only one, then the file EELASTF.ILE may contain an erroneous filename. It is best to turn OFF the EDLAST option. Make all files Read-Only (or make the whole drive Read-Only). At each workstation, set the path and the environment variable EEPATH to point to the networked drive. @pa @tc1Hints and tips Hints and tips -------------- Not in any particular order, just as I think of them. 1. Printing: Printing normally takes place in the background at a leisurely pace whilst other tasks, such as updating the screen, are also being performed. If you wish to speed up printing, at the expense of being able to edit at the same time, just press the <F9> key. A status window will show the current page and another window will ask if you wish to abort. While this window is waiting for your input, the only other activity is printing, so the printing task gets a much greater share of the CPU and so proceeds faster. The current page is updated constantly so you can see how fast it's working. 2. Display Do most of your work with the page display turned OFF. It makes other background tasks (such as printing) work a little faster. It does not affect the foreground editing. 3. Windows Don't work with too many windows. It can get very confusing as to which window you are in. 4. Status line. The status line contains a lot of information. The important stuff is at the left end (Zoom and modified flags, filename) while the less important information is in the middle. With multiple windows, it only takes a quick glance at the top left to work out where you are. 5. Attribute display. With the font display set to ON, its sometimes hard to see where a font starts and ends. As a guide, when the cursor is under a font control character, the cursor shape changes and an indication of which control character it is, is displayed at the top right corner of the status line. 6. Please, please read the manual before asking for help. It should all be in here somewhere. 7. Using the 'initialisation' and 'reset' sequences in the printer definition tables can greatly enhance the quality of your output. It makes printing look very professional. As an example, this manual was printed at 12 pitch with an 8 character offset on a laser printer using the '@' codes at the top of the file. 8. If you run EasyEdit II on a laptop computer, its sometimes hard to see where the cursor is. Use the Display Option to set the cursor to a block and then Save the settings. 9. If you are using a floppy diskette based system, put the EE.EXE program on a RAM drive; it makes program loading a lot faster. @pa 10. If you have word wrap set ON and write a continuous line with no spaces, EasyEdit will appear to run very slow while the cursor is beyond the right margin. This is due to the word wrap checking it is doing and is NOT a bug. If it bothers you, turn word wrap OFF. 11. If, when printing to a slow printer, it seems slow when editing, look at what type of printer you are using. If it is serial, it is possible that the printer is suspending operations until it's buffer is cleared. This affects everything, not just EasyEdit. Please be patient, its not all my fault. 12. When printing, a Table of contents file (extension .TOC) is automatically created. If, at the end of the print, there were no legal '@TC' commands in the print file, this .TOC file is deleted. If your system crashes in the middle of a print, there may be some unexplained .TOC files left. Just delete them. 13. When inserting a macro a number of times, there is a finite limit to the maximum number. The internal type-ahead buffer is 1024 characters and the macro can only be inserted as many times as it takes to fill this buffer. Thus, if your macro is 200 characters (after all translation), then it can only be inserted 5 times even though the manual says 'up to 9'. 14. When printing a .TOC file, EasyEdit creates a temporary .TC2 file which is deleted as normal at the end of the print run. Thus, if you have a normal file which has a .TOC extension, it can be printed. 15. If you are using a portable with an LCD display, set the cursor to a BLOCK type; it makes it much easier to see. 16. Use the '%parameter' in EE.CFG for any option which you may frequently change. Its easier than re-editing EE.CFG each time 17. I have included many macro files and printer tables. Please feel free to use them as templates for further work. 18. To speed up the starting up, have as few options in the .CFG file as possible. Each option takes time to process. @pa @tc1Errors and what to do about them Errors and what to do about them -------------------------------- Possible errors: 1. If you open and close windows, the amount of free memory may not agree with the total available for DOS commands. This is because DOS needs contiguous memory whereas EasyEdit can use non-contiguous memory. The cure is to exit to DOS normally and then run the command 2. Normal EasyEdit errors should be self-explanatory. 3. If you get 'Runtime error ...' its an error I haven't trapped. A common one is error 208 which means Easyedit can't find its overlay file (EE.OVR). If so, please re-check the installation. If you get unexpected errors, please try and document them as best as possible and contact me at the address above. I have tried to make this as foolproof as I can but nothing is perfect. With the use the the AUTOSAVE option and the automatic backups on exit, your work should be safe. @pa @tc1Files included in the distribution Files included in the distribution ---------------------------------- EE.EXE The program EE.OVR The overlay file EE.HLP The help file EE.TXT Source text of the help file KBD_INST.EXE Keyboard and help installation program EEKEY.MAP Keyboard map file (text) EEKEYF.ILE Keyboard map file (binary) EE.CFG Data file - holds initialisation data EEMOUSE.CFG Data file - for mouse setup EEMEM.ABR Data file for memory abbreviations EEFILE.ABR Data file for file abbreviations COMMANDS.LST Easyedit command numbers. *.MAC Keyboard macro files *.PDF Printer Definition files *.CHT Character translation files EASYMAN.TXT This manual - written with EasyEdit. EASYMAN.TOC Table of contents for the manual EASYMAN.ASC The manual, in ASCII format with no '@' commands README.1ST A quick installation guide. RELNOTES.TXT Release notes. @pa @tc1Sample EE.CFG file Sample EE.CFG file ------------------ ; This is EE.CFG - the configuration file for EasyEdit II v2.10 ; Lines starting with a ';' are ignored ; Any parameter starting with a '%' is taken as an environment variable ; and is substituted at run-time ; Set READROW to ON if you wish to set the cursor ; to the last row and column edited READROW ON ; Set WRITER_C to OFF if you want to avoid all those R_C files ; Remember, this will automatically turn OFF the READROW option WRITER_C ON ; Set EDLAST to ON if you wish to edit the last ; file edited EDLAST ON ; Set AUTOSAVE to ON if you wish for timed backups AUTOSAVE ON ; Set the SAVETIME to the backup frequency SAVETIME 10 ; Set LEFTUP to ON if you wish the left arrow to 'wrap' back to the ; previous line LEFTUP OFF ; set RIGHTDOWN to ON if you wish the right arrow to 'wrap' down to the ; next line RIGHTDOWN OFF ; Change the format character from @ to anything to match your favourite ; work processor FORMATCHAR @ ; Set ENDHOME to ON if you wish the double striking of <END> or <HOME> to ; move the cursor down or up the file ENDHOME ON ; ; Set SEARCHINIT to the default search options @pa SEARCHINIT U ; Set ABRMEM to the name of a local Abbreviation file which remains in ; memory all the time ABRMEM EEMEM.ABR ; Set ABRFILE to the name of the abbreviation file which is searched if ; the abbr. is not found in the ABRMEM file ABRFILE EEFILE.ABR ; Set COLFILE to the name of any color files COLFILE EECOLORF.ILE ; Set the LOADMACRO file to be any .MAC file in the 'home' directory ;LOADMACRO INIT.MAC ; Set the macro number to anything between 1 and 9 to automatically run ; that macro on entry into EasyEdit II ;RUNMACRO 1 ; Set the MOUSE to OFF to disable the use of the mouse MOUSE ON ;Set TOCSEPARATOR to the .... at the end - enclose them in '' as below ; so a space will be accepted TOCSEPARATOR '.' ; Do we have 'Chapter' before level 0 ? TOCCHAPTER ON ; Length of TOC line before the pagenumbers TOCLENGTH 60 ; Print TOC numbers ? TOCNUMBERS OFF ; Indent numbers ? TOCINDENT OFF ; Set FINDSTART to ON to position the cursor at the start of the found ; string FINDSTART OFF ; Turn EMS off if you think there may be a conflict EMS OFF @pa @tc1Sample EEMOUSE.CFG file Sample EEMOUSE.CFG ------------------ ; Mouse configuration file ; Set the horizontal & vertical ratio movements (these are divisors) HMICKEY 8 VMICKEY 8 ; Set the SLOWMENU to slowdown the mouse movement when the <F10> menu is ; in operation (its a divisor) SLOWMENU 7 ; Max delay allowable between pressing both buttons (ms) BOTHDELAY 100 ; define all the mouse key movements here - READ THE MANUAL LEFTALT 57 RIGHTALT 56 LEFTCTRL 113 RIGHTCTRL 59 LSHIFTLEFT 174 LSHIFTRIGHT 192 RSHIFTLEFT 174 RSHIFTRIGHT 192 LSHIFTALTLEFT 32 LSHIFTALTRIGHT 22 LSHIFTCTRLLEFT 193 LSHIFTCTRLRIGHT 193 ALTCTRLLEFT 193 ALTCTRLRIGHT 193 ALLLEFT 58 ALLRIGHT 116 ALONEBOTH 174 RSHIFTBOTH 193 LSHIFTBOTH 193 BOTHCTRL 193 LSHIFTCTRLBOTH 193 BOTHALT 193 LSHIFTALTBOTH 193 ALTCTRLBOTH 193 ALLBOTH 193 @pa @tc0Future planned enhancements Future planned enhancements --------------------------- Search for any matching pairs (eg '{}', 'begin end') Sorting blocks of text Printing multiple copies. 'Include' files in printing. Column mode working Programming language sensitive editing (maybe) @tc0Acknowledgements Acknowledgements ---------------- Borland - without their Turbo Editor to get me started, this would never have got off the ground. It's a shame it had a 'few' bugs in.... Paul Medcalf, Chris Lodge and Dieter Heinzer - for giving me ideas The entire DEC community - for 'hassling' me till I got it right. Mitch Lichtenberg - for giving me the idea of including binary files Steph - for being patient. Enjoy it...... Alan Sharkey