@op EASYEDIT II User Manual V4.5 (C) 1986-1991 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 word processor. It has many of the features of more powerful 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 compatibles. It has been tested under DOS V3.3 but should work on all versions greater that 3.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 most networks - tested in Digital Equipment's PCSA environment and Novell Netware. Will lock files in a network or multi-tasking environment. Pulldown, popup user replaceable menu system. Built in spell checker with over 80,000 words. 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, character translation tables and font file 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 Search for text before/after/between or at columns Block Mark blocks. Copy, move, delete blocks. Read or write blocks. Work in Line mode or Column mode. 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 Can be used as a TSR - either swapping for maximum free memory, or as resident program for speedy response (registered version only) 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. Can find matching 'begin/end' or other programming pairs. Can swap out to your favourite compiler and return displaying any error lines. 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. Can utilise the extra features of an Enhanced keyboard. ..................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 the latest update plus the professional manual. With this update, you will get the additional functionality of being able to let EasyEdit stay as a TSR program and the spell checker. After the free upgrade, you may register for maintenance upgrades at the basic registration price. This will entitle you to the next major upgrade. 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 or use them on a regular basis. 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. The onus is then on the receiver to abide by the terms of the registration. This, of course, does NOT apply to the registered version. @pa @tc1Prices Prices ------ Individuals ----------- The cost is œ35.00 sterling (sorry, I can't accept foreign currency) and the address to send it to is at the front of this manual. This is for basic registration and entitles you to a copy of the professional manual plus the version of EasyEdit which will stay resident as a TSR program. You also get the 80,000 word dictionary. The advanced registration costs œ45.00 and entitles you to a printed copy of the professional manual plus one free upgrade as it becomes available. Please make cheques out to 'The AsEditCo'. @pa 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. Manual 'right to copy' 10 licenses: œ200 $300 œ80 $120 20 licenses: œ380 $550 œ150 $225 50 licenses: œ750 $1125 œ250 $375 100 licenses: œ1300 $1950 œ400 $600 200 licenses: œ2200 $3300 œ600 $900 Unlimited œ3500 $5250 n/a 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 œ1320 or $2080. A site license entitles the company to a years worth of upgrades and a copy of the professional manual. An unlimited site license includes a 'right to copy' license for the professional manual. Extra copies of the professional manual can be ordered at a cost of œ10.00 each (UK) or $20.00 each (USA). The extra USA cost is for postage. 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). However, I am always open to negotiations. 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 or interesting (I define that criteria), since this is not a commercial venture and I pay my own phone bills. Please note that I cannot be help responsible for anything which may result from you using EasyEdit II. @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 .EXE file, 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 README.1ST which is on the installation diskette. STEP B ------ If you received the kit as a .EXE file, all necessary files will be in the archive. This is a self-unpacking program. Copy the file EASYEDIT.EXE to a subdirectory and type EASYEDIT [RET]. The programs will unpack themselves automatically. 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. You can also set five other environment variables: 1. EELPATH - which will point to a local directory for getting the last file edited. This will normally be used by network users. It also stored the keyboard file and any local .CFG files. 2. EEAPATH - which can be used to point autosaves to a different disk/directory when EasyEdit does its automatic backups. 3. EESPATH - The directory where any swap files will be created if you use the TSR option. It is a good idea to try and use EMS memory or a large RAM disk if possible. (This only applies to the registered version.) 4. EERPATH - This is set to point to the directory where any R_C files will be stored. If not set, they will be stored in the same directory as the file being edited. 5. EEBPATH - This can be set to point to a directory where your backup files (.BAK) will be stored. If not set, they will be stored in the same directory as the file being edited. After that, set the PATH command to point to the EasyEdit home directory and you may start editing any file anywhere. @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 two questions: If you have an Enhanced keyboard, answer 'Y' to the first question. The program will then use INT16 functions 10 and 11 rather than the Turbo Pascal READKEY function and therefore can interpret the enhanced keyboard mappings properly. To use these enhanced features, the parameter ENHANCED must be set ON in EE.CFG. A complete list of extra keys available to you is displayed in the 'Notes on enhanced keyboards' section. If you wish to restore the key mappings from the file EEKEYF.ILE, answer 'Y'. 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 Finish editing keystrokes When you are finished, press the 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 and another copy of the EEKEYF.ILE file, 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. 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 2800 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. Note that the editing windows will use the centre arrow keys on an enhanced keyboard if ENHANCED is set ON in EE.CFG (See below). This is independant of the functions you assign to these keys. Registered users ---------------- If you enter a filename on the command line (eg KBDINST MINE), KBD_INST will save the keyboard mapping and help file to that file rather than inside EE.EXE. Then, with the configuration option KEYFILE, different users can have different keymappings without having to run KBD_INST each time. EasyEdit searches first in the EELPATH directory then EEPATH directory for these files. 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 @tc1Notes for Gold Key users Notes for Gold Key users There is a group of users who are accustomed to the Digital style of word processing. This is known as 'GOLD KEY EDITING' and relies on the user pressing a designated key (usually marked in Gold), releasing that key and then pressing another key to perform a certain action (such as saving a file etc). This is an alternate form of control keys unique to Digital. Now, EasyEdit can emulate this style using the key as the Gold key. This is in addition to, not instead of, all the normal function, control and Alt keys which are so familiar to PC users. To set it up, use the KBD_INST program and get to the keystroke to be modified. To enter an character, press once, press and then press again. Then press the secondary key associated with the action and [RET] to have that keystroke accepted. Repeat this for all the keys you wish modified. I have provided two keyboard map files which emulate (as far as possible) the WPS-PLUS keyboard on an enhanced keyboard and on an LK250 keyboard. Be assured, the key will continue to function in its normal manner whenever required. Nothing has been removed to give you this extra facility. You may also use the NUM-LOCK key to simulate the key by setting USENUMLOCK to ON in the file EE.CFG. To then change the numeric pad, press ALT-NUMLOCK. @pa @tc0The EasyEdit Configuration Program The EasyEdit Configuration Program To speed up loading and starting EasyEdit, the program can read most of its configuration from an environment variable rather than from the file EE.CFG. To invoke this, run the program EECFG. You will be shown a full screen display of the options to be changed. Press the letter associated with the option and it will toggle from TRUE to FALSE or vice versa. The exceptions are SEARCHINIT where you will have to specify a series of letters as outlined in the Find Text menu option below and HOTKEY where you select a number from 1 to 4 depending on the hotkey you wish to be assigned which will invoke the TSR version of EasyEdit. If, at any time, you press '?', a page of help text will be displayed to assist you. When finished, press to exit the program. A file called EECFGADD.BAT will be built in the current directory. You can the include this in your AUTOEXEC.BAT file for future work and also run it immediately to set up the environment. I would suggest that (for DOS 3.3 users) you use the CALL command so that any changes will not mean re-editing AUTOEXEC.BAT. eg in AUTOEXEC.BAT have the line CALL C:\EE\EECFGADD For DOS 3.2 and earlier, you will have to edit AUTOEXEC.BAT each time. [Sorry, but thats life]. @pa @tc0Files used File Used and EasyEdit defaults. -------------------------------- @tc1EELASTF.ILE EELASTF.ILE - Stored in the home directory as defined with the 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 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 and must contain a space between the keyword and the action. 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. There can be multiple pairs of variables on one line. eg if the file EE.CFG contains the line LOADMACRO %mac%.%ext% and the environment has been set with MAC=INIT and EXT=MMM, then the expansion will be to LOADMACRO INIT.MMM. 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 and 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 .ESV 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 .ESV. It does not affect the original file or the backup (.BAK) file. If you abort the edit, the original file is preserved. When reading in a file, the autosave directory is checked for a file corresponding to the one being edited. If found, a message is displayed and you have the option of restoring it. 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 .ESV 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 colour map is stored. EMS ON EMS OFF (D) 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. Note that if this option is set ON, even if you have no EMS memory, then the SPAWN to DOS command (), will swap most of EasyEdit out leaving a small stub. 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. LOCKFILE ON LOCKFILE OFF (D) With the LOCKFILE option enabled, every time a file is opened for editing, a check is made that the file is not in use by some other user. The file is then locked for your personal use until you finish editing. With this option disabled, editing is as before. See the section below for further details. LOCKEXT extension (default &%&) You can change the default extension used to 'lock' files in a multi-user or tasking environment to make it compatible with other programs which use this principle (eg Wordstar). Just enter the extension (up to 3 characters). @pa COMMFILE ON COMMFILE OFF (D) This option controls how the display of printer and macro files appears. With COMMFILE ON, the stored comment is displayed next to each filename. With COMMFILE OFF, no comment is displayed but the display appears and scrolls much faster. CODEPAGE ON CODEPAGE OFF (D) This option controls whether EasyEdit can display Codepage character sets or just the inbuilt ROM character sets. With CODEPAGE ON, the RAM character set will be used but you will not be allowed to switch to the 43/50 line display mode. With CODEPAGE OFF, you will use the built in character sets for your video card and can switch to 43/40 line mode. This only applies to EGA and VGA cards. BLNAME ON (D) BLNAME OFF This option controls how EasyEdit starts up if EDLAST is OFF (see above). If BLNAME is ON, and there is no filename specified on the command line, then a new file will be created with an initial name of 'BLNAME'. If BLNAME is OFF, and there is no filename specified on the command line, then a file window will open with '*.* as a wild card and you can choose a filename from the list offered. SAVEALL ON (D) SAVEALL OFF This option controls how the windows are closed down when exiting from EasyEdit. If SAVEALL is ON, all modified windows are saved. If SAVEALL is OFF, the current window is saved and then you are asked if you wish to save each other modified window. ENHANCED ON ENHANCED OFF (D) This option controls whether EasyEdit will use the extra functionality of an Enhanced keyboard. You must have set up the mappings in KBD_INST previously for any extra features to be used. Note that any editing windows will use the centre arrow keys if this option is set. STARTNUM ON (D) STARTNUM OFF This option controls whether the printing starts with page numbering turned on (default) or off. @pa HOLDDIR ON HOLDDIR OFF (D) This option determines whether or not EasyEdit will revert to the current directory when returning from a spawned command which may have changed the directory specification. It has no effect on saving files which have previously been edited. IGNOREM ON IGNOREM OFF (D) This option controls how EasyEdit displays colours if the system is switched to video mode 2 on a colour analog monitor for any reason. Some software leaves the system in the 'wrong' state (by assuming that modes 2 and 3 are the same - they are not). EasyEdit will attempt to correct this if you wish. Set this option ON if you see EasyEdit coming up in monochrome on a colour system. Please do NOT set this option if you have a monochrome graphics system (such as a portable). The grey shades may be hard to read. OWNMENU ON OWNMENU OFF (D) This option controls whether or not EasyEdit will attempt to read in a customised menu file. If set ON, the local support path (EELPATH) then the global support path (EEPATH) will be searched for the file EEMENU.CFG. If found, the file will be interpreted and the new menu system used. If set OFF, the built-in menu system will be used. MAKEBACKUP ON (D) MAKEBACKUP OFF This option controls whether or not to create a .BAK file when saving your work. If you are short of disk space, it may be advisable to turn this option off. If set ON, each time you save your work, a backup file with the extension .BAK is saved with the contents of the file before the last save. If set OFF, the file is overwritten without any backup being made. @pa HOTKEY n (default 1) A number between 1 and 4 representing one of the 'hot-keys' used to invoke the TSR version of EasyEdit. 1 ALT- 2 CTRL- 3 ALT-` 4 CTRL-` SWAPSIZE n (default 2048) This is the number of paragraphs (a paragraph is 16 bytes) to allocate as data space for editing when EasyEdit is set up as a non-swapping TSR. The number can be any value between 2048 and the maximum memory available. Invoke EasyEdit as a TSR (/NS option) and you will be informed of the range of options. MOVEIN ON MOVEIN OFF (D) Use this option if you wish the press of the key to take the cursor to the first character of the line rather than the first column. The next press of will then take the cursor to the first column (if no other key has been pressed first). DEFHEAD text Use this option to define a default header to be used when printing text. It will be overridden by any '@HE' commands DEFFOOT text Use this option to define a default footer to be used when printing text. It will be overridden by any '@FT' commands MYDICT ON (D) MYDICT OFF If this is set ON, then when the spell checker is invoked, the internal dictionary will be used. If set OFF, then the calls to Turbo Lightning will be used. MDICT dictionary This specifies the location and name of the master dictionary. If this is left out, EasyEdit defaults to EE.DCT in the EEPATH directory. UDICT dictionary This specifies the location and name of the user dictionary. If this is left out, EasyEdit defaults to USER.DCT in the EELPATH directory. [Note, this is the LOCAL path] @pa COMPILER compilername This option allows you to preset the name of the compiler you use. It can have the path in as well. If not, the compiler must be somewhere on your path. Currently, EasyEdit supports the following names: TPC Turbo Pascal (V5.5 and 6.0) TCC Turbo C (V2.00) TASM Turbo Assembler (V2.0) CL Microsoft C (V5.10) QCL Microsoft Quick C (V1.01) MASM Microsoft Assembler (V5.10) CSWITCH switches This option allows you to set any default compiler switches for the above compilers. USENUMLOCK OFF (D) USENUMLOCK ON This option controls whether NUM-LOCK will simulate an key or not. This is primarily for GOLD KEY users. KEYCOUNT num (D 1000) This option sets the number of keys pressed before AUTOSAVE takes place. Note that this value is only checked once every minute. KEYFILE name If the file 'name'.KEY is found in the EELPATH or EEPATH directory, then that key mapping and the associated EE.HLP file is used. Do not put any extension on the 'name'. REFORMLEFT ON REFORMLEFT OFF (D) IF this option is set on, any reformatting (using CTRL-B) will move the first line back to the left margin rather than reformatting from the current line. DOUBLELINE ON DOUBLELINE OFF (D) If this option is set, any line drawing will be done using the double line character set rather than the single line one. This can be changed from within EasyEdit as well. @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 (1) ----------------------------------------------------------------------- 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 ----------------------------------------------------------------------- (1) For a three button mouse, the centre button defaults are the same as the 'both button' defaults. 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. The block will be highlighted as you move the mouse. 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,Ctrl and Left Shift keys ALONECENT 174 Centre mouse buttons alone RSHIFTCENT 193 Centre mouse buttons plus Right shift key LSHIFTCENT 193 Centre mouse buttons plus Left shift key CENTCTRL 193 Centre mouse buttons plus the Control key LSHIFTCTRLCENT 193 Centre mouse buttons plus Left Shift and Ctrl keys CENTALT 193 Centre mouse buttons plus the Alt key LSHIFTALTCENT 193 Centre mouse buttons plus Left shift and Alt keys ALTCTRLCENT 193 Centre mouse buttons plus Alt and Ctrl keys ALLCENT 193 Centre mouse buttons plus Alt,Ctrl and Left Shift keys @pa @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 100) 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 block marking 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. Centre] the current line in margins 121. Set editor colours 122. Save colours, 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. Spell checker 170. Delete all attributes in current marked block 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 201 Perform a set of commands multiple times 202 Find matching pairs 203 Reserved 204 Add macro file comment 205 Toggle between Line and Column mode for block work. 206 Make a window Read-Only 207 Make a window Read-Write (if allowed) 208 Search for the next occurance of the word under the cursor 209 Toggle the single key select function 210 Move to the first line of the next paragraph 211 Move to the last line of the previous paragraph 212 Toggle out of the TSR back to the calling app. 213 Move all windows up one line 214 Move all windows down one line 215 Invoke the compiler options 216 Delete word to the left of the cursor 217 Toggle single/double line drawing mode 218 Copy or delete a file @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 /G:nnn Go to line 'nnn' on entry to the file. /RO Make the preceding file read-only /NB Don't make a .BAK file when saving a window. /TS Set EasyEdit up as a TSR with all the defaults /NS Set EasyEdit up as a non-swapping TSR /FI Force EasyEdit to use files for swapping even if EMS memory is present. /UN Unload EasyEdit from memory. /K:n Use 'hot-key' no 'n' (1-4) when invoking EasyEdit. @pa @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. 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+ @pa 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- 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 ( OTT ). eg EE filename /T:5 sets the tab size to 5 characters. @pa 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. n) You can go directly to a line within a file by using the /G: option. This option works unless you specify wildcards in the filename, when it is ignored. eg EE NEWFILE.PAS /G:127 will open file NEWFILE.PAS and position the cursor on line 127. o) You can make a window read-only from the command line by specifying the /RO option. This option only works if there is a preceding filename on the command line. eg: EE oldfile.txt /RO newfile.txt will open 'oldfile.txt' in a read-only window and open 'newfile.txt' in a normal window. p) You can avoid creating a .BAK file when saving files by setting this switch. Note, the following switches are all to do with the TSR options inside the registered version of EasyEdit. TSR's are explained in more detail in a later chapter. q) Set EasyEdit up as a TSR with the /TS switch. It will be made resident with all the defaults. r) Set EasyEdit up as a non-swapping TSR with the /NS switch. The swapsize is defined in EE.CFG (default is about 29Kb of editing space). s) Force EasyEdit to use EMS memory if there (and enough available) for its swapping space with the /EM switch. This is only needed if Digitals PCSA is active and you wish to override the default. t) Force EasyEdit to use files for swapping even if EMS memory is present with the /FI switch. You may wish to save the EMS memory for other things. u) Unload EasyEdit from memory with the /UN switch. An error message will be displayed if EasyEdit is not resident or if there are still unsaved files. If you get the message 'not enough memory', use the EEUNLOAD program. @pa v) Select the 'hot-key' to be used with the /K:n option. choices are: 1 ALT- 2 CTRL- 3 ALT-` 4 CTRL-` Notes 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. If any of options (r) to (v) are used, the option (q) - /TS - is not needed. @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. /G:nnn Go to line 'nnn' in the file. /RO Make the preceding file read-only /NB Don't make a .BAK file when saving a window. /TS Set EasyEdit up as a TSR with all the defaults /NS Set EasyEdit up as a non-swapping TSR /FI Force EasyEdit to use files for swapping even if EMS memory is present. /UN Unload EasyEdit from memory. /K:n Use 'hot-key' no 'n' (1-4) when invoking EasyEdit. @pa 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 ./RO and /G:nnn switches. @pa @tc1Initialisation sequence Initialisation sequence ----------------------- When you start up EasyEdit II, if the environment variable EECFG is not set, it first looks for a file called EE.CFG in the 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 the environment variable EELPATH has been set, the file EE.CFG is searched for again. This is for network users so that users may override defaults for their own use. If a mouse is present and is to be used, then the default options stored in EEMOUSE.CFG are read in. The files used are read in as above. Any abbreviations are read in and set up. Any matching pairs are read in. If a colour map file exists, it is read in. If the help file can be found, it is opened ready for use. If a user replaceable menu system is asked for, the file EEMENU.CFG is searched for and loaded. The directory EELPATH is searched before EEPATH. 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 or the one pointed to by the EERPATH environment variable (if set). 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. @pa 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 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 or an '๘' if the file is marked as read-only. 4-15 Filename 17-20 How far through the file (percent) 22-31 Current line number 33-39 Current column number 41-47 Current page number if page formatting is ON, or the current buffer number if page formatting is OFF. 51-52 An indicator if you are using a mouse. 54-55 BL if in Line mode, BC if in Column mode or CS if single key select mode is on 57-59 Insert/Overwrite indicator 61-62 Auto Indent indicator 64-67 Word wrap or margin release indicator 69-72 Justification ON/OFF indicator 74-75 Line Drawing indicator (<>) 76-80 Printing >P< or Macro recording >R< or the current attribute under the cursor (or the time if nothing else). @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 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 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 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 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 . 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 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 ( 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. Double lines can be drawn by toggling that option. @pa @tc1Printing Printing -------- EasyEdit has the capability to print files whilst 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 @HEstring Use 'string' as a header on each page @FOstring Use 'string' as a footer on each page @TCltext Print the text to a Table of Contents file (see below) @LS x Change to x line spacing (x between 1 and 9) @FTFont Change to the named font type (See later) Within the header and footer string, the following codes are valid $ Insert the name of the file being printed ^ Insert the files creation/modified date. # Insert current page number %1 Insert current date as Aug 17, 1989 %2 Insert current date as 17 Aug 1989 & Insert current time 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 @HEThis line is printed on page # at %1 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 @tc1Notes on Font Files Notes on Font Files EasyEdit (from version 2.5) has the ability to use several fonts in the same document. Obviously, your printer must have this facility or nothing will happen....... The advantage of this is that you can define codes for different printers with the same name and not have to change your text when swapping printers. To define all the fonts, use a text editor to create a font file with the same name as the printer definition file and with the extension of '.FNT'. For each font, you need one line which starts with the font name (upper or lower case) and then has a space and then has the codes necessary to invoke that font with your printer. The total line length cannot exceed 80 characters. eg, if the code to produce Times Roman 12 point was '#3' then the line might look like: TIMES12 #3 Then in the text, you specify '@FTTIMES12' as a print code and the sequence '#3' will be sent to your printer to turn on Times Roman 12 point. An example for an HP Deskjet printer is included. A subset of it is printed below with the ESCAPE character replaced by . Courier10/6 (s0P(s3T(s10H(s6V Courier16/6 (s0P(s3T(s16.67H(s6V Courier20/6 (s0P(s3T(s20H(s6V Courier5/12 (s0P(s3T(s5H(s12V Courier10/12 (s0P(s3T(s10H(s12V Courier16/12 (s0P(s3T(s16.67H(s12V Courier20/12 (s0P(s3T(s20H(s12V Times12 (s1P(s12V(s5T Times10 (s1P(s10V(s5T Times8 (s1P(s8V(s5T Times7 (s1P(s7V(s5T Times6 (s1P(s6V(s5T Times5 (s1P(s5V(s5T Times4 (s1P(s4V(s5T Prestige6/10 (s0P(s8T(s6H(s10V Prestige12/10 (s0P(s8T(s12H(s10V Prestige24/10 (s0P(s8T(s24H(s10V Prestige8/7 (s0P(s8T(s8H(s7V Prestige16/7 (s0P(s8T(s16.67H(s7V Prestige33/7 (s0P(s8T(s33.34H(s7V Letter (s2Q Draft (s1Q @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: +++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 FA option rather than 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 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 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 @tc0Notes on File Locking Notes on File Locking --------------------- EasyEdit has a rudimentary file locking capability. This is NOT true MS-NET file locking but a quick way of checking if another user has a file opened for editing with EasyEdit. It works as follows: If a user wants to open a file, a file with the same name but with an extension of '&%&' is created to act as a lock for other users. When the next user tries to access that file, EasyEdit will spot the .&%& file and display an error message accordingly. The exception from this is that Block Reads are allowed on any file and, of course, you can still edit the same file many times in different windows. I could not use the conventional file/record locking method because multi-tasking shells such as Desqview (tm) ignore them and I needed to cater for that. NOTE WELL: The point to be aware of is that EasyEdit checks for a file with the same name as that being edited and extension of &.& Thus, if you try to edit two files with the same name but a different extension in the same directory (eg EE.PAS and EE.ASM) then the second file read will fail if FILELOCK is on. In this case, turn file locking off or edit the files one at a time. @pa @tc0Notes on Column Mode. Notes on Column Mode. --------------------- 1. All copies take place in overstrike mode. This has to be done because I had to allow for the option of the user copying columns to the left of the text to be copied and overlapping horizontally. eg The text to be copied is in a block as follows: ฺฤฤฤฤฤฤฤฟ 1 2 3 4 ณ6 7 8 9ณq w e r 1 2 3 4 ณ6 7 8 9ณq w e r a b c d ณf g h iณs t u v a b c d ณf g h iณs t u v ภฤฤฤฤฤฤฤู If we copy to the left, we should end up with: ฺฤฤฤฤฤฤฤฟ 6 7 8 9 ณ6 7 8 9ณq w e r 6 7 8 9 ณ6 7 8 9ณq w e r f g h i ณf g h iณs t u v f g h i ณf g h iณs t u v ภฤฤฤฤฤฤฤู If we then copy in INSERT mode to the left we will end up with: ฺฤฤฤฤฤฤฤฟ 6 7 8 9 ณ1 2 3 4ณ6 7 8 9 6 7 8 9 ณ1 2 3 4ณ6 7 8 9 f g h i ณa b c dณf g h i f g h i ณa b c dณf g h i ภฤฤฤฤฤฤฤู And if we copy to the left and one column down in insert mode we will get: ฺฤฤฤฤฤฤฤฟ ณ6 7 8 9ณq w e r 6 7 8 9 ณ1 2 3 4ณ6 7 8 9 1 2 3 4 ณa b c dณf g h i a b c d ณa b c dณf g h i a b c d ภฤฤฤฤฤฤฤู As you can see, its not easy to overcome this, so I decided to ignore the problem. It was in theory possible to copy it all to a buffer and then copy it back but that limits the size of the columns to be moved. @pa 2. When you delete a block, it either 'closes the gap' or inserts spaces according to the insert mode of the window which has the marked block. This is different from Line mode which always 'closes the gap'. 3. In a block copy, the block markers are left with the original block and not moved to the new block. This is for the Move command. 4. A Move is a Copy followed by a Delete. This explains (I hope) why the above is set. 5. The end block marker is set under the current character. This is different from Line mode where it is set before the current character. That didn't make sense in Column mode. Toggle between the two modes after marking a block and you will see the difference. 6. Attribute marking/deleting will not work in Column mode. 7. Block read/write and format are not allowed in Column mode. @pa @tc0Notes on using an enhanced keyboard Notes on using an enhanced keyboard ----------------------------------- Using the KBD_INST program and setting the ENHANCED variable ON in EE.CFG, it is possible to have many more keystrokes available to invoke commands. With an enhanced keyboard in normal mode, the keypad and the the extra keys perform the same function and the F11/F12 keys do nothing at all. With the enhanced keyboard set up, you can (for example), use the extra arrow keys for the up and down movement and set the arrow keys on the numeric pad to go to the top/bottom of the file. Within KBD_INST, each key on the middle (or extra) keypad is defined as "Ex..." [eg ExHome for the Home key]. Where there may be conflict on the numeric keypad, that is defined as "Kp..." [eg KpEnter for the keypad Enter key]. The full list of keys you can use is as follows: On the numeric keypad Ctrl-Up Minus (-) Ctrl-Minus Centre (5) Ctrl-Centre Plus (+) Ctrl-Plus Down Ctrl-Down Left Ctrl-left Right Ctrl-Right End Ctrl-End PageDown Ctrl-PageDown Home Ctrl-Home Insert Ctrl-Insert Del Ctrl-Del / Ctrl-/ Alt-/ * Ctrl-* Alt-* Enter Ctrl-Enter Alt-Enter On the centre keypad Home Ctrl-Home Alt-Home PageUp Ctrl-PageUp Alt-PageUp Up Arrow Ctrl-Up Alt-Up Left Arrow Ctrl-Left Alt-Left Right Arrow Ctrl-Right Alt-Right End Ctrl-End Alt-End Down Arrow Ctrl-Down Alt-Down PageDown Ctrl-PageDown Alt-PageDown Insert Ctrl-Insert Alt-Insert Del Ctrl-Del Alt-Del @pa Miscellaneous F11 Shift-F11 Ctrl-F11 Alt-F11 F12 Shift-F12 Ctrl-F12 Alt-F12 Ctrl-0 Ctrl-1 Ctrl-3 Ctrl-4 Ctrl-5 Ctrl-7 Ctrl-8 Ctrl-9 Ctrl-; Ctrl-. Ctrl-Tab Alt-Tab @pa @tc0Notes on Menu Customisation Notes on Menu Customisation @tc1 Introduction Introduction EasyEdit now has the ability to allow the user to customise the menu system to include the commands in any way they wish. Of course, the default menu settings are always available by resetting one option in EE.CFG, the configuration file. The user replaceable menu system is controlled by two actions: setting OWNMENU to ON in EE.CFG and the presence of a file EEMENU.CFG in the local or global support path. If both conditions are satisfied, the menu file is read in and interpreted and the new menu structure is built. @tc1File Structure File Structure The following is the format for EEMENU.CFG. This format MUST be obeyed or the program will not function correctly. I have included rudimentary checking but nothing is foolproof. Each menu has a menu level. There can be a maximum of 3 levels. Each level starts with a string of six numbers, all integers, separated by commas, on one line as follows: Level, Xpos, Ypos, Xsize, Ysize, Items where: Level The level number (1 to 3) Xpos The starting X position for that menu (not including border characters) Ypos The starting Y position for that menu (not including border characters) Xsize The length of the menu (No of characters across) Ysize The depth of the menu (No of lines down) Items The number of menu items in that menu (Max 20). For each 'item', in the menu, you will need the following: Command, Offset,menu type, Highlight Offset, label where: Command The command number as defined in COMMAND.LST Offset Offset from the top left X or Y position Menu Type 0 is an ordinary menu item 1 has a Boolean (ON/OFF) after it 2 has a number after it 3 has some text after it Highlight The offset into the text for the highlight character Label A label describing the menu item. Max of 20 characters is used. @pa @tc1Notes Notes For Command number, if a menu item leads to a sub menu, it can have either the number 193 or the number 194. 194 means the menu is accessible with no file open; 193 means it is NOt accessible with no file open. Level 1 menus are always horizontal and there should only be one of them. Level 2 and 3 menus are always vertical and there can be any number of them. If a line begins with a semi-colon (;), it is ignored. This is so comments can be inserted into the file. If you want to use the EDLAST ON option, then there must be a FILE OPEN menu option. If you want to use the READROW ON option, then there must be a GOTO LINE/COLUMN/PAGE and OPTIONS LEFT/RIGHT/TOP/BOTTOM/PAGE menu options. If a menu has sub-menus, and not all items in that menu have sub-menus, then there must be 'place-holders' in the menu file. This is a sub-menu with no items in it. For Network users: EasyEdit attempts to find a menu file in the Local support path first (EELPATH). If there is not one, it then looks in the global support path (EEPATH) for the file. Thus, each user in a network can have customised menus with a global (company) one for backups. If EasyEdit detects an error in the file, it exits displaying the portion of the line where it had an error. I have provided two files as examples. The first one, GOODMENU.CFG is a copy of the built-in menu system. The second one EEMENU.CFG is an example of changing things around. It has Exit and Quit as top level items, the Block commands are within the Window menu and there are many other changes. Please feel free to modify these files to suit your own environment. @pa @tc0EasyEdit as a TSR EasyEdit as a TSR @tc1 Introduction EasyEdit has the ability to remain resident in memory, available at the press of a key, even if you are in the middle of another application. This is known as TSR mode (Terminate and Stay Resident). EasyEdit has two forms of TSR mode; swappable and non-swappable. In swappable mode, most of the code is swapped out to disk or EMS memory when the program is first loaded, leaving a 6Kb stub in memory. This means that most of your memory is available for other applications. When EasyEdit is invoked (with the 'hot-key'), the application you are running is swapped out and EasyEdit swapped in. When you are finished editing, EasyEdit is swapped out, the previous application swapped in, and you may resume where you left off. In non-swapping mode, all of EasyEdit remains resident in memory and it is therefore quicker to invoke it. However, this takes up a lot of memory (minimum of 215Kb) which may lead to some applications not working. This loss of memory is variable and controlled by a configuration option, SWAPSIZE, in EE.CFG. Please note that this is NOT multitasking. When EasyEdit is invoked, any other application is suspended. Also, this is not compulsory; you can still use EasyEdit in its 'normal' way. You can even use EasyEdit as a 'normal' editor with another copy resident and thus edit up to 12 files at once. To set EasyEdit up for swapping, it needs to be started with one of the TSR command line options (/TS, /NS, /EM, /FA, /K:n). These options (detailed above) jump to special code which sets up the swap areas and then exits back to DOS informing you which keystroke will invoke EasyEdit. After that, just press the 'hot-key' and EasyEdit will start up over any current application. Once EasyEdit is invoked, it all works as though it were the 'normal' version with the following exceptions: 1. The key to return to your previous application is (by default) . You may reassign this key to another, using KBD_INST.EXE but do NOT unassign it or assign it to the same keystroke as the 'hot-key'. In either of those cases, you will be trapped inside EasyEdit and the only way out would be to reboot your PC. 2. The exit, quit and 'Save Binary and Exit' commands do not function whilst inside the TSR. To exit, save your work and exit using the TSR exit (). 3. You will not be allowed to unload EasyEdit if any files are unsaved. 4. You will not be allowed to exit from the TSR if printing is in progress. 5. You are not allowed to spawn to DOS or run a DOS command from the TSR. @pa @tc1 Technical notes Technical notes --------------- Please load any networking software before EasyEdit as a TSR. Any software loaded afterwards will be swapped out when EasyEdit is invoked by the 'hot-key'. Thus communications may be lost when you are editing. For PCSA users, the LAT program, used by programs such as SETHOST, creates pointers into the calling program. If this calling program is then swapped out, the LAT program may dump data into the middle of EasyEdit. The SETHOST program is OK since EasyEdit will not swap over the top of it (thats the advantage of working for Digital!), but I cannot vouch for other programs. EasyEdit, in TSR mode, monitors the following interrupts: 05H - Print Screen 08H - Clock Tick 09H - Keyboard 13H - Bios Disk Read/Write 16H - Bios Keyboard 25H - Dos Disk Read 26H - Dos Disk Write 28H - Dos Multitasking 09H is monitored to watch for your keystroke; 08H and 28H are monitored for up to 2 seconds after the 'hot-key' has been pressed, to make sure it is safe to pop up. The others are watched to make sure they are not in operation when EasyEdit is invoked. Do not load EasyEdit as a TSR before Desqview. See above for reasons. Do not invoked EasyEdit while running any programs that use DOS Extender technology, especially the 386 versions (Phar Lap etc). They do odd things like remap memory which can have disastrous effects if you try and swap it out. If you do not have EMS memory but can create a 1Mb virtual disk using extended memory, set the EESPATH parameter to point to it. It will significantly decrease swapping time. EasyEdit marks the swap files as SYSTEM and Hidden so they cannot be accidentally deleted. When EasyEdit is unloaded, the swap files are deleted. If the PC is rebooted before EasyEdit is unloaded, the files are left but will be reused the next time EasyEdit is loaded as a TSR. @pa When EasyEdit is invoked as a TSR, it does the following: Check if the graphics mode is the same as when EasyEdit was loaded. If not, it beeps and exits. Thus, EasyEdit will NOT pop-up over a graphics program. Check and save the number of lines on the screen (EGA and VGA only). Save the state of the mouse, if loaded. This relies on the mouse driver supporting functions 15H,16H and 17H. If you had a warning message when loading EasyEdit as a TSR, the mouse state will not be saved. Please contact the mouse manufacturer for a more up to date version. It should be Microsoft version 6 compliant. Save the screen layout. Call EasyEdit. Continue editing until is pressed. Restore screen layout. Restore the mouse state (if applicable). Restore the correct no of screen lines. Swap back to the previous application. @pa @tc0Compiling a program Compiling a program EasyEdit has the ability to swap itself out, compile a program and return to editing, where, if it finds any errors in the compilation, will load in the file (if not already loaded), and highlight the last error line and displaying the relevant error message. With all 'C' and 'ASM' compilers, you then get the chance to move up and down the errors list with one keystroke. This does not apply to Turbo Pascal since the compiler stops after the first error. The current list of supported compilers is : TPC Turbo Pascal (V5.5 and 6.0) TCC Turbo C (V2.00) TASM Turbo Assembler (V2.0) CL Microsoft C (V5.10) QCL Microsoft Quick C (V1.01) MASM Microsoft Assembler (V5.10) BCC Borlands C++ (V2.00) To invoke this option, press [or whichever key you have assigned]. This will bring up a menu item as shown here: ษออออออออออออออออออออออออออCompile Setup อออออออออออออออออออออออออออป บ Go บ บ Filename G:\TP\EE\CREATE_I.PAS บ บ Compiler name TPC บ บ Switches /M บ บ Next error บ บ Previous error บ บ Wait after compile OFF บ บ Test filename G:\TP\EE\BIN\CREATE_I บ บ Run test file บ ศอออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออผ Choose any items to amend in the normal way and then press 'G' to start the compilation. Filename: This is, by default, the filename of the current window. You may change it. If the file is in memory and has been modified, it is saved before the compilation starts. If any errors are detected in the compilation and the file is not already in memory, then it is read in, unless you already have 6 windows open. Compiler name Choose one of the names from the list above. You may prefix it with a pathname if you wish. If you choose a compiler which is not on the list, the compilation will still take place but an error message will appear when it tries to detect any errors. Switches Enter any compiler switches here. Next error Display the next error which the compiler found. A maximum of 10 errors are stored. Previous error Display the previous error which the compiler found. A maximum of 10 errors are stored. @pa Wait after If you are uncertain that the compilation is taking place, change this option to ON. Before EasyEdit returns to editing, it pauses and you press any key to continue. Thus, you can inspect the output that the compiler produces. Test filename To test the program you have compiled, enter its name or the batch file that calls it here. Run test file To run the test, choose this option. The 'Wait after Compile' option also works here. @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 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 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 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 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 Move the cursor up one line in the same column. Down one line Move the cursor down one line in the same column. You may not go beyond the last line in the file. Scroll up 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 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 Move the cursor to display the next screen. The number of lines moved depends on the window size. Up Page Move the cursor to display the previous screen. The number of lines moved depends on the window size. Top of file Move the cursor to the beginning of the file. Bottom of file Move the cursor to the end of the file. Left of Line Move the cursor to column one of the current line. If AutoIndent is ON, the cursor will first move to the first character on the line, then to the beginning of the line. Right of line Move the cursor to the last character on the current line. Top of screen Move the cursor to the top of the screen in the current column. Bottom of screen Move the cursor to the bottom of the screen in the current column. Go to line 'n' 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' 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' Move to page 'n' if pagination is ON. Displays an error if pagination is OFF. Goto Window 'n' Go to window 'n'. A list of available windows will be shown; choose one in the normal way. Goto top block Go to the start of a marked block. Goto end block Go to the end of a marked block. @pa Jump to marker Jump to marker 'n'. 'n' must be between 0 and 9 and previously set Set marker 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 Move the cursor to its previous position. Up equal indent Move up to the next line whose first character is at the same column as the current line. Down equal indent Move down to the next line whose first character is in the same column as the current line. Next Sentence Move to the beginning of the next sentence. Prev Sentence Move to the beginning of the previous sentence. New Line Insert a line break before the current cursor position. If indent is ON, position according to the previous line Insert Line Insert a line break after the current cursor position. If indent is ON, position according to the previous line Insert Ctrl char The next character typed after the will be inserted into the text and not interpreted in any way. Very useful for inserting escape sequences into text. Delete char Delete the character underneath the cursor and move characters to close the gap if in Insert mode. Delete prev char 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. If in insert mode, close the gap. Note that this command will NOT delete any attribute markers. Use the key or the TAD command to delete attribute markers. @pa Delete word right Delete the word to the right of the current cursor position. Delete to EOL Delete all characters from the current cursor position to the end of the line. Delete line Delete the current line and move it to the delete buffer. Delete line no undo Delete the current line but do not move it to the delete buffer. Find Find text. See the menu text for further description. Find and replace Find text and replace with other text. See the menu text for further description. Search and apply macro Search for text, and if found, playback the selected macro. See the menu text for further descriptions. Find Next Continue the search using the previous text string. See the menu text for further descriptions. 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. Abandon file Clear the current window. If the file has been modified, you are given an opportunity to save it first. Press to continue editing. 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. Write block Write the currently marked and highlighted block to a file. See the menu option for more details on this. Save file Save the current window to a file and continue editing. Save/edit new Save the current file if modified and open a new file in the current window. @pa Save/exit Save the current file, if modified and exit to DOS. Save to name Save the current window to another file. Open new file 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 Close the current window. If the file has been modified, you will be given an opportunity to save it. 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. Previous Window Go to the previous window. Counterpart to the command above. Resize window Resize the current window. See the menu option for more details. Toggle window 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. Set Block begin Mark the beginning of a block of text. When both top and bottom positions have been marked, the text is highlighted. Set Block end Mark the end of a block of text. Copy Block Copy the currently marked and visible block to immediately before the cursor. Move Block Move the currently marked and visible block to immediately before the cursor. @pa Delete Block Delete the currently marked and visible block. See the menu option for more details on this. Hide block display Turn the block highlight OFF. Many block commands are only executed when the block is highlighted (visible). Mark current word Make the current word a visible block. Macro record Toggle macro recording ON or OFF. See the menu option for more details of this. Insert scrap (prompt) 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 Insert the scrap macro 'n' times See below for size limits Insert Macro '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 254. 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 ones 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. @pa Toggle Insert Toggle between Insert and Overstrike mode for the current window. This option can be saved with the OS command. Toggle Autoindent 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 ( OML ). Toggle Word Wrap 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 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 Set the left margin for the current window. See the menu option for more details. Set right margin Set the right margin for the current window. See the menu option for more details. Set temp margin 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. @pa Set Margin at 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. Set margin release 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 Centre the current line between the left and right margins. Toggle case 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 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 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 Reformat the current paragraph so it fits within the current left and right margins. Autoindent and compression are accounted for. Reformat block Reformat the marked and visible block as above. Blank lines are taken as paragraph markers. Toggle tab display Toggle the display of tab characters at the top of the screen. It only affects the display, not the tabs. Toggle mark display Toggle the display of text markers Toggle page display Toggle the display of pages on the screen. Toggle attribute display Toggle the display of attributes as colours or control characters. See the menu option for more details. @pa Toggle help display Toggle the display of short-cut keystrokes when in the menu system Invoke DOS shell Execute a DOS command. Press [RET] for a DOS shell. See the menu option for more details on this. Change dir Change to a new drive or directory See the menu option for more details. Get Info Get info on current file. See the menu option for more details on this. Show memory 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 Move the cursor to the next tab stop (either fixed or smart) inserting spaces or tab characters if appropriate. Back-Tab Move the cursor to the previous tab stop (fixed only). @pa Toggle fixed tabs 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 Edit the tabs interactively. See then menu option for more details. Set tabs 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 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 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 As above but for doublestrike. Set Underline As above but for underline. Set Superscript As above but for superscript. Set Subscript As above but for subscript. Set Compressed As above but for compressed mode. @pa Show Attribute 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. Delete Attributes Any attribute markers within a marked block are deleted. 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. Help summary Display a summary of how to use the help system. Key Help Display help on the function keys Other help is accessed through the Main help display. Menu Activate the menu system. Abort command Abort any incomplete command. Undo last deletion 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 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 Insert the entire undo buffer at the cursor. Flush undo buffer Clear out the undo buffer. Draw box Toggle box drawing ON or OFF. See the text above for more details on this. Toggle 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. @pa Expand abbreviations Expand the previous 1-3 characters based on the abbreviations file. See above for details. Check Spelling Perform a spelling check if Turbo Lightning is installed or the user dictionary is found.. 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. Do Command Perform a set of commands many times. See below for more details. Find matching pair Find the matching pair as defined in the file EE.MCH. See below for more details. Add macro file comment Add a comment to a macro file. Toggle Block Line/Column mode Toggle between working on lines of text and columns of text with the block functions. Make a window read-only Make the current window read-only. This means that any modifications done will not be saved. Make a window read-write Makes the current window writable. Any modifications done will be saved as long as the indicator '*' is seen in the status line. Find next word at cursor Find the next occurence of the word underneath the cursor. See the menu option for further details. Toggle single key select If not set, turns on single key block selection. Then, cursor movement will automatically set the block highlight. Press it again to anchor the block. Next paragraph Move the cursor to the first character of the first line of the next paragraph. @pa Previous paragraph Move the cursor to the first character of the last line of the previous paragraph. Toggle out of the TSR Leave editing and return to the application which was there before EasyEdit was invoked with the hot-key. Move all windows up Move all windows up one line. Move all windows down Move all windows down one line. Compile a program Display a set of menus to compile a program. See the section on compiling for more details. Delete word left Delete a word to the left of the cursor. If the cursor is under a word, it will delete that word. Toggle single/double line When drawing lines, this option toggles whether single lines of double lines will be used. Copy/Delete a file UF This will allow users to copy or delete files without exiting EE first. Files can be selected from a list. @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 Toggle Select Toggle single key block selection. 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 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 Compile program Display a set of menus to compile a program. See the section on compiling for more details. 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 Toggle out of EasyEdit as a TSR and return to the previous application. Ctrl-F5 Spare Use as you wish Ctrl-F6 Do Command Perform a command many times. Enter the number of times to perform the command, followed by a '!', followed by the command. Enter the command the same way as a macro command. If no '!' is found, the default is to run it twice. Ctrl-F7 Delete block Delete the currently marked and visible block. See the menu option for more details on this. Ctrl-F8 Hide block Turn the block highlight OFF. Many block commands are only executed when the block is highlighted (visible). Ctrl-F9 Spell check Invoke the spelling checker. 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 to continue editing. Shft-F3 Find Matching Find the corresponding match to the word under the cursor - eg begin/end or { }. See the appendix for more details on this. 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 Toggle Line/Col Toggle between Line and Column mode when working with blocks of text. See the notes above for further information. 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 command. If you have used your own menu system, then please ignore this section. 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 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 key. An example is displayed below ษออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออป บ File Block Window Text 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 Block Window Text Goto Search Options Utilities บ ศหอออออออออออออออออหอออออออออออออออออออออออออออออออออออออออออออออออออออออออออออผ บ Open.. บ บ Close บ บ Save บ บ Write to.. บ บ Print.. บ บ Get info บ บ Exit บ บ Add Binary/exit บ บ Quit บ ศอออออออออออออออออผ @tc2Open A) Open 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 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 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 ... 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 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 will be saved first if it has been modified,before printing takes place. 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

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 Block Window Text Goto Search Options Utilities บ ศหอออออออออออออหอออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออผ บ Open.. บ บ Close บ บ Save บ บ Write ษอออออออออออออออออออออออออออ Print Setup อออออออออออออออออออออออออออป บ Print.บ Print file now บ บ Get inฬอออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออน บ Quit บ Name of file บ ศอออออออบ Which printer PLAIN.PDF บ บ Device LPT1 บ บ Copies 1 บ ฬอออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออน บ Auto formatting ON บ บ First page 1 บ บ Last page 4095 บ บ Offset 0 บ บ Manual paper feed OFF บ บ Use formfeeds OFF บ บ Edit printer codes บ บ Save printer setup บ บ Both, Odd or Even Both บ ศอออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออผ @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 file in the current window. 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. @pa @tc3Printer type c) 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 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 d) 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. @tc3Copies e) Copies This option lets you print multiple copies of the same file without having to repeat the command. It will only print one copy TO a file. Enter the number of copies to be printed. @tc3AutoFormatting f) 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 g) First page Enter the first page you want to print. It must be less than or equal to the last page. @tc3LastPage h) 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. @tc3Offset i) Offset Enter any left margin offset. This saves you having to enter the @PO command at the top of your document. @tc3Paper feed j) 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 k) 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 l) 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 บ บ Comment บ ศอออออออออออออออออออผ 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 key, press the SCROLLOCK key first, then the key, then SCROLLOCK again to revert to normal. Press [RET] when finished or to abort the edit. The 'comment' is used to give more information about that printer and is displayed when a list of printer files is shown (if COMMFILE is ON). @tc3Save printer setup m) 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. @tc3Both, Odd or Even n)Both, Odd or Even This option allows you to print all pages, just even pages or just odd pages. It works if you select the start and finish page as well. Thus, you can print to both sides of the paper by specifying odd pages, then reversing the paper and specifying even pages. @pa @tc2Get info F) Get info This option displays information about the current file being edited, some environment information and the name and address of the licensee. Press to continue working. @tc2Exit G) Exit This option saves any files which have been modified and exits back to DOS. @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 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 @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 Block Window Text Goto Search Options Utilities บ ศอออออออออหอออออออออออหออออออออออออออออออออออออออออออออออออออออออออออออออออออออผ บ Begin บ บ End บ บ Hide บ บ Copy บ บ Move บ บ Delete บ บ Write.. บ บ Read.. บ บ Format บ บ Lines ON บ ศอออออออออออผ @tc2Begin A) Begin 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 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 This will turn the block highlight off. It does NOT hide the text, only the highlight. @tc2Copy D) Copy Copy the current marked block to immediately BEFORE the cursor position. The new text becomes the marked block. @tc2Move E) Move Move the current marked block to immediately BEFORE the cursor position. @tc2Delete F) Delete 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 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 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 Format the current marked block. The block must be highlighted and the cursor must be positioned inside it or an error message will result. @tc2Lines J) Lines ON/OFF 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 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 Make the previous window current. The cursor will move into the previous window and you may continue editing there. @tc2Next D) Next Make the next window current. The cursor will move into the previous window and you may continue editing there. @tc2Resize E) Resize 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]. @tc2Extract Binary 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 filename 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 @tc2Read-Only G) Read-Only This option will make a window read-only. This allows you to make corrections to the text of the window knowing it will never be saved to disk. An indicator '๘' (ASCII 248) is displayed next to the filename. Note that these files will NOT be 'autosaved'. @tc2Read-Write H) Read-Write This option makes a read-only window writable. This option will be ignored if the file is read-only on the disk drive. Note that any amendments made before it was made read-write will only be saved if the modified indicator '*' is on. You can force this by entering and deleting one character. @pa @tc1Text menu Text Menu --------- ษออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออป บ File Block Window Text Goto Search Options Utilities บ ศออออออออออออออออออออออออออออออหออออออออออออออออออหออออออออออออออออออออออออออออผ บ Format paragraph บ บ Temporary margin บ บ Margin release บ บ Attribute.. บ บ Centre line บ บ Set marker.. บ บ Restore line บ บ Undelete บ ศออออออออออออออออออผ @tc2Format paragraph A) Format paragraph 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 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 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. You can also delete all attributes within a marked block from this menu. @tc2Centre line E) Centre line This will centre the current line between the left and right margins if wordwrap is ON. @pa @tc2Set marker F) Set Marker 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 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 When complete lines of text are deleted , they are placed on an 'undelete buffer'. You can restore these lines one at a time with this command. @pa @tc1 Goto menu Goto Commands ------------- These commands are all concerned with positioning the cursor at a suitable point in the file. ษออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออป บ File Block Window Text Goto Search Options Utilities บ ศอออออออออออออออออออออออออออออออออออหอออออออออออออออออหออออออออออออออออออออออออผ บ Page number.. บ บ Line number.. บ บ Column number.. บ บ Top of file บ บ Bottom of file บ บ Marker.. บ บ Start of block บ บ End of block บ บ Next para บ บ Previous para บ ศอออออออออออออออออผ @tc2Page A) Page Number 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 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 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 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 The cursor will be moved to the top of the file. @tc2Bottom of file E) Bottom of file The cursor will be moved to the bottom of the file. @tc2Marker F) Marker 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 Jump to the start of a block of data (set with the key). The block does not need to be visible. @tc2End of block H) End of block Jump to the end of a block of data (set with the key. The block does not need to be visible Hint - The above two commands give you two extra markers to use. @tc2Next Paragraph I) Next Paragraph Move the cursor to the first character of the first line of the next paragraph. @tc2Previous Paragraph J) Previous Paragraph Move the cursor to the first character of the last line of the previous paragraph. @pa @tc1Search menu Search menu ----------- These commands are concerned with find/replace text options. ษออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออป บ File Block Window Text Goto Search Options Utilities บ ศออออออออออออออออออออออออออออออออออออออออออออออหอออออออออออออหอออออออออออออออออผ บ Find.. บ บ Replace.. บ บ Use macro.. บ บ Again บ บ Next Word บ ศอออออออออออออผ @tc2Find A) Find This allows you to search through the text for a specified word or phrase. Control characters can be included by preceding them with . You can search for an end-of-line by including . 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. (n) The found string must start in column n. (+n) The found string must be at or after column n. (-n) The found string must be at or before column n. The last two commands can be combined to produce true column searches. Note that the default options can be set using the SEARCHINIT option in EE.CFG. @pa @tc2Replace B) Replace 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 . You can search for an end-of-line by including . 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 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 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. @tc2Next Word E) Next Word This option searches for the next occurence of the word under the cursor. It uses the default option string (UGB etc) as set up by the last 'Find' command (or by the SEARCHINIT variable) and places the word in the Find buffer for subsequent searches. Be aware that the cursor is positioned beyond the next occurence of the word so that the 'Find Next' command can work successfully. @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 Block Window Text Goto Search Options Utilities บ ศออออออออออออออออออออออออออออออออออออออออออออออออออออหอออออออออออออออออออออหอออผ บ Margins.. บ บ Format options.. บ บ Tabs.. บ บ Load file options.. บ บ Display options.. บ บ comPiler options บ บ Colours.. บ บ Save setup บ ศอออออออออออออออออออออผ @tc2Margins a) Margins.. ษออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออป บ File Block Window Text 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 . @pa @tc2Format b) Format options.. ษออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออป บ File Block Window Text 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 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 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 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 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 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 Block Window Text 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 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 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 key will add a new tab and pressing the key will delete a tab. Press [RET] when finished or to abort. @tc3Display tabs e) Display tabs 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 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 Block Window Text 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 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 Block Window Text 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. 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. 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 key. @tc2Compiler Options f) Compiler Options. This leads to a sub menu for setting the compiler options and compiling/testing your programs. See the chapter on compiling above (page 57). @tc2Colours g) 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 to return to the previous menu. The colours are saved as a default. ษออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออออป บ File Block Window Text 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 บ ศออออออออออออออออออออผ @pa @tc2Save setup h) 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 Block Window Text Goto Search Options Utilities บ ศออออออออออออออออออออออออออออออออออออออออออออออออออออออหออออออออออออออออออออออหผ บ Spelling check บ บ Macros.. บ บ Directory.. บ บ Change directory.. บ บ Operating system.. บ บ File บ บ Help บ ศออออออออออออออออออออออผ @tc2Spelling check a) Spelling check Spell check the document in the current window. The spelling checker is quite unique in the text editing world. This one can either use the Borland Turbo Lightning engine or use its own internal dictionary to actually do the work. If you don't have Lightning installed and you have not registered your copy of EasyEdit, an error message is displayed. If the internal dictionary is used, all words are assumed to be lower case and no checking is made on words such as don't or doesn't. This will change in a future version. 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 to cancel or 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 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 to return to this menu). This option does not work with the EasyEdit internal dictionary routines. It is planned for a future version. 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 to return to this menu. If justification is ON, then the line will be re-justified. e) Add to dictionary The word (lower cased) will be added to a user dictionary as defined by the UDICT option in EE.CFG. This user dictionary will be used in all subsequent spelling checks. f) 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. g) 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 254 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 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 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 or ). 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, arrow keys and Enter are the keystrokes concerned. @tc3Add a file comment f)Add a file comment Use this option to add a comment to the macro file. Enter up to 40 characters. This will be used when displaying macro filenames in the Load option if COMMFILE is ON. @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. E - Replace the string (terminated by ASCII 254) with the environment variable of the same name. 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> or <#254>. Note well: There can only be a maximum of 254 characters per macro even after all the substitution has taken place. If substitution takes the macro to larger than 254 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 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 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] alone to invoke a DOS shell (Type EXIT to return to EasyEdit in that case). If the option EMS is set ON, then EasyEdit will swap most of itself out to EMS giving more memory for the swapped in application. One word of warning: Do NOT invoke any TSR (Terminate and Stay Resident) programs from this command. The system may hang on you !!!!! TSR's are programs like MOUSE or SIDEKICK. If you are not sure, ask someone. @tc2File e)File This option will invoke a sub-menu. From here, you may copy a file or delete a file. If you enter wild-cards (eg *.*), you can select files from a pull down list. @tc2Help f) 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 and 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 @tc1Notes on Matching Pairs Notes on Matching Pairs This command (Shift-F3 by default) is for the programmers. One of the hardest things is to find the matching begin/end pairs in a heavily convoluted program. Now, EasyEdit can do it for you. First, you need to set up the file EE.MCH with all the pairs you wish to look for. I have provided a sample (printed below). begin end { } /* */ ( ) As you can see, each pair is on one line, separated by a space. Each item can be up to 10 characters each and there is a maximum of 10 pairs allowed. When EasyEdit loads, it looks for EE.MCH in the default home directory. If found, it loads in the pairs to be used. To find the matching pair, put the cursor on the word/letter of one side of the pair and press . If there is a match, the corresponding half will be highlighted. @tc2Rules and hints: Rules and hints: A start pair is defined as the word you want a match for. The end pair is defined as the word to be searched and matched eg in BEGIN/END, with the cursor under BEGIN, the start pair is defined as BEGIN and the end pair is defined as END. EasyEdit follows the following rules: 1. If the pair half is not one of '{}' or a '[]' or a '()' then the search is done on WHOLE WORDS only. Thus, if you put the cursor on 'Begin', then it will not find 'WEND' but will find 'END'. For the above three cases, search is done on a character by character basis. So, if the match you want is a pair such as '(*' and '*)' put the cursor under the '*' and not the '('. 2. Case is not important. 3. If you put the cursor on the second half of the pair (as defined in EE.MCH), then the search will be backwards. Otherwise, the search will be forwards. This can be useful if you want to find the matching 'begin' to the current 'end' for example. @pa 4. Be careful on what is defined as the start pair. For instance, 'end;' is OK as a word since EasyEdit ignores the trailing ';' but other combinations may not be OK. I have tried to cater for all eventualities but if in doubt put spaces around the start pair. The end of a word is defined by the following character set #32,#9,#13,#10,#39,,,.,/,?,;,:,",<,>,[,],{,},-,=,\,+,|,(,),*,% ,@,&,^,$,#,!,~,;]; The reason for the limitation is that EasyEdit needs to have some way of checking for the end of a word and it does it by checking the word under the cursor until it meets a character that is in the above set. 5. If the match doesn't seem right, look for a matching end pair within a comment. For instance, with a 'begin/end' pair, its very easy to have a comment such as {this is the end } and EasyEdit will include that 'end; in its count. 6. In order to find the start pair, EasyEdit does the following: If the cursor is at the end of the line, EasyEdit searches backwards to find the last word. If the cursor is underneath a word, EasYedit uses that word. If the cursor is between words, then EasyEdit searches forwards to find the next word and uses that as its start pair. If in doubt, put the cursor UNDER the word to be used. I have done limited testing on it and it seems OK. If you do find any problems, please document them and send them to me. @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. It has been tested on both Novell and PCSA networks (PCSA is Digitals Lan Manager network). @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). 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 and set the EELPATH variable to point to a local directory. Set the other variables as appropriate. @pa @tc1Notes on 'Do Command' Notes on 'Do Command' If you wish to enter any key into the command 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,arrow keys and Enter are the keystrokes concerned. 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. When inserting a command a number of times, there is a finite limit to the maximum number. The internal type-ahead buffer is 1024 characters and the command can only be inserted as many times as it takes to fill this buffer. Thus, if your command is 200 characters then it can only be inserted 5 times even though you may have requested it to be inserted more than that. EasyEdit searches for the first '!' and expects a number before it. If an invalid number is found, the command aborts. If you have a '!' in the command that you wish to be inserted in the text and no number at the front (ie, you want it inserted twice - the default), put a dummy '!' at the front. This command can be very useful for entering exact numbers of underlines ('80!-' will do that) or deleting numbers of lines ('20!' will do that) or other things like that. @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 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. Use the '%parameter' in EE.CFG for any option which you may frequently change. Its easier than re-editing EE.CFG each time 16. I have included many macro files and printer tables. Please feel free to use them as templates for further work. 17. To speed up the starting up, have as few options in the .CFG file as possible. Each option takes time to process. 18. Register your shareware copy. You get the latest version plus a professional manual with much more in it. 19. If you use PC-Tools Desktop, turn off the macro facility before using EasyEdit as a TSR. If you do not do this, you will never be able to exit from EasyEdit once it is invoked. @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. 4. One word of warning: Do NOT invoke any TSR (Terminate and Stay Resident) programs from the SHELL command. The system may hang on you !!!!! TSR's are programs like MOUSE or SIDEKICK. If you are not sure, ask someone. 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. When you register, you will get a supplementary manual with all the EasyEdit errors and an explanation. Yet another good reason to register. 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 EE.MCH Matching pairs file. EE.PIF Program Information File for MS-Windows v3 EECFG.EXE Configuration program for environment EEUNLOAD.EXE An unloader to the TSRed EasyEdit 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 *.FNT Font files EASYMAN.TXT This manual - written with EasyEdit. README.1ST A quick installation guide. RELEASE.xxx Release notes for the current version. RELNOTES.TXT Release notes for previous versions. REGIST.FRM The registration form. EE.DCT 80,000 word dictionary (registered users only). EE.IDX The index to the dictionary @pa @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.... Max Brouwer for his dictionary routines. 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