home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / vrac / vde18g.zip / VDE.REF < prev    next >
Text File  |  1996-06-01  |  71KB  |  1,083 lines

  1.  
  2.                                    VDE.REF
  3.                                    -------
  4.                      Reference Manual for the VDE Editor:
  5.                          version 1.8G (30 May 1996)
  6.  
  7.                              (c)1987-96, E. Meyer
  8.  
  9.  
  10.  
  11.  ===============================  CONTENTS  ==================================
  12.  
  13.     (For QUICK START, SYNTAX, GENERAL INFORMATION etc. see the file VDE.DOC)
  14.  
  15.      6.  COMMAND REFERENCE, alphabetically by topic:
  16.             Auto format, Auto indent, Auto number, Auto save, Block commands, 
  17.          Column block mode, Cursor position, Data files, Deleting, Envelopes, 
  18.          Files, Find/replace, Foreign characters, Graphics, Header, 
  19.          Hyphenation, Information, Inserting, Justification, Line spacing, 
  20.          Margins, Matching files, MenuBars, Multiple files, Pagination, 
  21.          Paragraph indent, Place markers, Print preview, Print styles/codes, 
  22.          Printer drivers, Printing, Proportional spacing, Protected mode, 
  23.          Reformat, Ruler line, Run command/shell, Save/exit, Screen controls, 
  24.          Screen size, Spelling check, Splitting files, Tabs, Time/date, 
  25.          Undelete, Upper/lower case, Windows.
  26.  
  27.      7. REVIEWS / ABOUT THE AUTHOR.
  28.  
  29.     (For detailed explanation of MACROS, see the file VMACRO.REF)
  30.  
  31.     (For use of the VINST installation utility, see the file VINST.REF)
  32.  
  33.  
  34.  =========================  6. COMMAND REFERENCE  ============================
  35.  
  36.  
  37.  AUTO FORMAT (^OM) -  Continuously keeps the paragraph of text you are working 
  38.     on properly formatted (margins and spacing), even as you add to or delete 
  39.     from the line; format changes are implemented instantly.  (Auto format 
  40.     does NOT affect parts of the file you have not changed.)  When off, the 
  41.     manual ^B command can still be used (see REFORMAT).
  42.          Care must be taken in files with mixed formats, as the CURRENT 
  43.     settings of margins and spacing are always used.
  44.          Note that with Auto Format on, certain keystrokes may have additional 
  45.     (or no) effects, due to immediate reformatting afterward; and some 
  46.     operations like Find/Replace may be somewhat slower.
  47.  
  48.  AUTO INDENT (^OA) -  Causes wordwrap or the [Enter] key, upon moving to the 
  49.     next line, to indent to match any existing indentation on that line (with 
  50.     insert OFF) or the previous line (with insert ON).  Thus any structured 
  51.     indentation you create is maintained.  Useful as a temporary (paragraph) 
  52.     indent, or for outlines, program source code, etc.  Works in all modes, 
  53.     including nondocument.  Note: Indentation must be done with spaces or 
  54.     variable tabs, NOT with hard tabs.
  55.  
  56.  AUTO NUMBER (^K#) -  VDE can automatically number items in a list.  Just type 
  57.     a "#" character where each number should go:
  58.              #.  First item.
  59.              #.  Second item...
  60.     You can then mark the list off as a block, and use the ^K# command; VDE 
  61.     will insert the numbers (1, 2, etc) in place of the "#" markers.  You will 
  62.     be asked for the starting number; the default is 1.  If auto format (^OM) 
  63.     is on, text will be realigned to compensate for varying length numbers.  
  64.     (Once numbering is done, the markers are gone.  For frequently revised 
  65.     lists, leave the "#" markers in the file on disk; use ^K# just before 
  66.     printing, and do not save afterward.)
  67.  
  68.  AUTO SAVE (^KA) -  Saves any changes you have made to disk automatically, at 
  69.     regular intervals.  This ensures that you don't lose too much work if you 
  70.     make a mistake, have a power outage, etc.  ^KA lets you set the interval 
  71.     (1 to 255 minutes), or turn this feature off entirely (0).  [The default 
  72.     can be set with VINST].
  73.          Notes: Auto save will wait for an interval of keyboard inactivity.  
  74.     It cannot save "untitled" work, or a file that has been protected (^KO).  
  75.     It preserves a backup file only when the file has not already been saved 
  76.     since it was first loaded.
  77.  
  78.  BLOCK COMMANDS (^KB,^KK,^KH,^KZ,^KY,^KC,^KV,^KW; ^QB,^QK; ^KPB) -  A block of 
  79.     text is delimited by two markers, set by ^KB (beginning) and ^KK (end), 
  80.     which remain in the text until reset elsewhere or deleted.  Alternatively, 
  81.     you can mark a block simply by holding down Shift while using the 
  82.     [^,v,<,>,Home,End,PgUp,PgDn] keys to move the cursor, or pressing the main 
  83.     (left) button while moving with the mouse.  Once marked, the block text 
  84.     displays in a contrasting color.  ^KH unmarks the block, removing any 
  85.     marker(s) set.
  86.          Normally a block is a continuous segment of the file; but VDE can 
  87.     also work with column blocks, rectangular regions with the block markers 
  88.     at opposite corners.  For details, see COLUMN BLOCK MODE.  The command 
  89.     behavior described below is for NORMAL block mode.
  90.          The block move and print commands (^KV,^KPB) require a block to be 
  91.     fully marked before use.  To save keystrokes, the other block commands 
  92.     (see also ^K#,^K",AltC), if used when only one block marker is present, 
  93.     will first mark the current cursor position as the other end of the block:
  94.          ^KY goes to and deletes the block.  (^QP may be used to return the 
  95.     cursor to its position before the deletion.)
  96.          ^KV moves the marked block to the present cursor location; ^KC copies 
  97.     it there, leaving the original marked.  (^QP will return to the former 
  98.     position of a moved block, or move to the end of the text just copied.)
  99.          ^KZ "zooms into" a block: the rest of the text is inaccessible, and 
  100.     the block is temporarily treated as the entire file.  This isolates one 
  101.     portion of a file for your attention, and also limits the scope of VDE 
  102.     commands (find/replace, word count, etc) to that part of the file.  (Only 
  103.     saving to disk continues to involve the entire file.)  Use ^KZ again to 
  104.     zoom back out.  If no block markers exist, ^KZ will zoom into an empty 
  105.     block.  In zoom mode, pagination is off; you can use block operations, 
  106.     though any block markers within will disappear when you zoom back to the 
  107.     whole file.
  108.          ^KW writes the block text to a disk file; you will be asked for the 
  109.     filename (and optional mode).  You can also choose to append the text to 
  110.     an existing file by typing a "+" before the filename, as in:
  111.                       Write to file: +GORT
  112.     (If you don't specify "+", and the file already exists, VDE will ask 
  113.     whether you want to overwrite or append; press [Esc] or [Space] to 
  114.     cancel.)  You cannot write to a file you are currently editing.
  115.          ^QB moves the cursor to the block start (if marked); ^QK moves to the 
  116.     block end.
  117.          ^KPB (^KP with B option) prints the block text only.  (See PRINTING.)
  118.  
  119.  COLUMN BLOCK MODE (^KN,^KI) - ^KN toggles column blocking, and ^KI selects 
  120.     between normal (insert) and replace mode for column blocks; when on, you 
  121.     will see "CBl" (or "CRp" for replace) in the header.
  122.          Normally, a block consists of the entire text stream between the 
  123.     block markers; see BLOCK COMMANDS.  But a column block is only the 
  124.     rectangle with the start marker at the top left corner, and the end marker 
  125.     at the bottom right.  Block highlighting will clearly show the difference 
  126.     between the two modes.  The ending column must be greater than the 
  127.     starting column, otherwise a column block will not highlight (though the 
  128.     markers remain visible) and block operations will not work.
  129.          Column mode, as its name suggests, is most useful in rearranging data 
  130.     arranged in columns, such as tables or parts of non-document files.  It 
  131.     may also be used in documents; column block operations do not invoke auto- 
  132.     format.  If printer codes or block markers make it difficult to judge 
  133.     column alignment, use preview (^OD).
  134.          Many block commands work essentially the same in normal or column 
  135.     block mode, including ^KB, ^KK, ^KH, ^K", ^K', ^K^, ^KW, ^KPB, AltC, ^KY, 
  136.     and ^U.  Two are invalid in column block mode: ^KZ, ^K#.  (As a 
  137.     substitute, create a new empty file with AltL,^Enter and use AltC,AltP to 
  138.     copy the column block to it.)
  139.          The block move/copy/read commands, ^KV, ^KC, ^KR, and AltP, can 
  140.     either insert text or replace existing text, depending on the mode 
  141.     selected with ^KI, to give you more flexibility in manipulating columnar 
  142.     data.  In either case, the block text will appear at the cursor location 
  143.     (as top left corner); if some of its lines are shorter than others, spaces 
  144.     will be added to fill out the rectangle.
  145.          Note that it is possible to Cut a block in column mode, then Paste in 
  146.     normal mode, etc.
  147.  
  148.  CURSOR POSITION (Mouse,Arrows; ^F,A,C,R; ^QE,X,S,D; ^QR,C; ^QI,L,N,P; AltO) -  
  149.     Simple cursor motion is accomplished with a mouse (or equivalent pointing 
  150.     device) if installed, or with the four PC arrow keys [^,v,<,>] or the 
  151.     classic WordStar "diamond" ^E,^X,^S,^D.  While generally interchangeable, 
  152.     there are some subtle differences between these methods.
  153.         The mouse functions only on the text screen (not at command prompts), 
  154.     and it can move DIAGONALLY as well as:
  155.            UP or DOWN maintaining the previous cursor column
  156.            LEFT only to the beginning of the line
  157.            RIGHT past the end of the line and up to the edge of the screen
  158.     The WordStar diamond keys move:
  159.            UP or DOWN to the previous column OR end of new line if shorter
  160.            LEFT or RIGHT from one character to the next throughout the file
  161.     The arrow keys move:
  162.            UP or DOWN maintaining the previous cursor column
  163.            LEFT or RIGHT from one character to the next throughout the file,
  164.              but on to the edge of the screen if already past end of line
  165.     That is, the mouse moves at will across the screen, while the WordStar 
  166.     keys move only within existing text, and the arrow keys are a sort of 
  167.     hybrid.  Mouse speed is controlled by its own driver software.
  168.          Whenever the cursor is temporarily pointing past the end of the line, 
  169.     you will see a ">" by the column in the header; if you add text at this 
  170.     location, spaces will be inserted first to allow inserting it there.
  171.  
  172.          ^F or ^[>] moves right, to the start of the next word; ^A or ^[<] 
  173.     moves left, to the start of the current, then the previous, word.  ^C or 
  174.     [PgDn] scrolls forward (down) one screen; ^R or [PgUp] scrolls backward 
  175.     (up) one screen.
  176.          Preceded by ^Q, many keys move more Quickly: thus ^QE, ^QX go to the 
  177.     top or bottom of the screen; ^QS, ^QD to the left or right end of the 
  178.     line.  Similarly, ^QR and ^QC jump to the beginning or end of the file.
  179.          ^QI moves directly to the specified page (for documents) or line (for 
  180.     non-documents); see also "[_]" option, under SYNTAX.  In documents, ^QL 
  181.     and ^QN move to the start of the Last or Next page, respectively.
  182.          ^QP generally returns the cursor to its Previous position, before the 
  183.     last large motion occurred.  So it is effectively an "undo" for commands 
  184.     like ^B, ^QR/C, ^QF/A, ^QM/B/K, AltM, AltO.  ^QP can be repeated to cycle 
  185.     between two positions in a file.  ^QP also has special uses following 
  186.     certain block operations; see ^KY, ^KV, ^KC, ^KR, AltP, ^U.  For example, 
  187.     ^QP moves to the end a block just read, copied, pasted, or undeleted, so 
  188.     if after inserting the block you realize you didn't want it there after 
  189.     all, you can remove it with the commands: ^KB ^QP ^KK ^KY.
  190.          AltO displays an Overview ("scroll") bar at the top of the screen.  
  191.     The length of the bar corresponds to the file's size.  You can move the 
  192.     cursor left or right with the arrow keys; a marker remains to designate 
  193.     the original (current) position.  To move to the indicated position, press 
  194.     [Enter]; press [Esc] instead to cancel.
  195.  
  196.  DATA FILES (AltU) -  AltU allows you to change many VDE settings by Using 
  197.     (loading or saving) specific types of data files.
  198.          .VDF files can be Loaded and Saved - see KEY DEFINITION FILES.
  199.          .VDG files can be Loaded and Saved - see GRAPHICS.
  200.          .VDP,C,I files can be Loaded - see PRINTER DRIVERS, CHARACTER WIDTHS,
  201.                                         USER OPTIONS.
  202.     Any of these may also be loaded with a semicolon on the command line (see 
  203.     SYNTAX).  If no directory is specified, files must be in the current or 
  204.     VDE directory (see DIRECTORIES).
  205.          Note: When you load a .VDG file with AltU, it cannot alter any pre- 
  206.     existing graphics which are actually present in files being edited.
  207.          .VDP,C,I files can be written by VINST.  In the event that VDE cannot 
  208.     load a data file created by an earlier version, VINST can usually convert 
  209.     it by reading the old file and writing it back to disk in the new format.
  210.  
  211.  DELETING ([BkSp],[Del],^[BkSp],^[Del],^G,^T,^Y; ^QY,^Q[BkSp],^QT) -  ^G or 
  212.     [Del] deletes the character at the cursor.  [BkSp] deletes the previous 
  213.     one.  ^T deletes a word to the right (from the cursor to the end of the 
  214.     word).  ^[BkSp] deletes a word to the left.  ^[Del] deletes the entire 
  215.     current word.
  216.          ^Y deletes the entire current line.  ^QY deletes just the part of the 
  217.     line to the right of the cursor; ^Q[BkSp] deletes the part to the left.
  218.          ^QT, followed by a character, deletes everything up until the next 
  219.     occurrence of that character.  EXAMPLE: ^QT. (period) deletes to the end 
  220.     of the sentence.  Special cases: ^QT[Enter] deletes to the next HARD CR, 
  221.     the end of the paragraph; ^QT^Z deletes to the end of the file.
  222.          Unintended deletions can be recovered (see UNDELETING).
  223.  
  224.  ENVELOPES (^KPA) -  VDE provides an easy way to print a single envelope to 
  225.     accompany a letter, via the "A"ddress option of the print command:
  226.        1.  Begin by moving the cursor to the address of the recipient, and 
  227.     marking this as a block (see BLOCK COMMANDS):
  228.                      {Chester Fludd
  229.                       193 Lakota St         "{}" = block markers
  230.                       Norman, OK  73069}
  231.        2.  Then use the print command (^KP), and at the options prompt, type 
  232.     "A", followed by "1" or "2" to specify the envelope size: 1 for smaller 
  233.     (letter) size envelopes, about 3.625 x 6.5"; 2 for larger (business) size, 
  234.     4.25 x 9.5".
  235.        3.  Optionally, you may include a return address for the upper left 
  236.     corner of the envelope: enter this in "double quotes", using a backslash 
  237.     (\) to mark the beginning of a new line.  Example:
  238.                   Options:  A2"C. Fludd\193 Lakota St\Norman, OK 73069"
  239.     (You may find it convenient to set up envelope printing with your usual 
  240.     return address as a FUNCTION KEY, if you will use it often.)
  241.        4.  Load the envelope correctly in your printer, and press [Enter] to 
  242.     print it.  Then you can continue to edit or print the letter itself.
  243.  
  244.          NOTES: Printers handle envelope feeding in various ways.  With some 
  245.     you can feed in a single envelope, and manually position it on the platen; 
  246.     with some others, a separate tray is available for envelopes, and you will 
  247.     need to install special codes to select the proper tray.  Many laser 
  248.     printers expect to feed envelopes lengthwise, so you will need codes to 
  249.     print in a landscape font.  [To install control codes to prepare your 
  250.     printer for an envelope, see PRINTER INSTALLATION.]
  251.          Vertical positioning of text on the envelope can easily be changed by 
  252.     adding linefeeds to the initialization string.  Horizontal positioning can 
  253.     be changed with the "L" print option.  Because of the way laser printers 
  254.     operate in landscape mode, VDE prints both envelope sizes with their RIGHT 
  255.     edge in the same place.  This means that on other printers, the LEFT edge 
  256.     of the smaller envelope must be placed 3" (30 columns) in from the left 
  257.     margin.  If this is inconvenient, it can be overridden by specifying the 
  258.     left margin option (e.g. "L0") AFTER the "A1" option.
  259.  
  260.  FILES (^KL,^KR,^KJ,^KF) -  ^KL Loads new file(s) to edit, REPLACING the 
  261.     current one.  (If the file has been modified, you will be prompted to 
  262.     confirm that you mean to abandon it.  To save the file first, use ^KD 
  263.     instead; to load file(s) in ADDITION to the current one, use AltL 
  264.     instead.)  You can enter any number of filenames, with optional line/page 
  265.     numbers and modes (see SYNTAX).
  266.          ^KR Reads in the contents of a single disk file, inserting the text 
  267.     at the current cursor position as a marked block.  (Note that the effect 
  268.     depends on whether column block mode is engaged.  Also, ^QP can be used to 
  269.     move to the end of the text just read in.)
  270.          ^KJ deletes any disk file you specify.  (If you need more complex 
  271.     file utilities, remember that you can run any DOS command with AltR.)
  272.  
  273.          All these commands prompt for a filename.  If you are unsure, and 
  274.     want to pick a name from a directory listing, you can call up the "file 
  275.     browser" display by pressing [Enter] alone for *.*, or typing any other 
  276.     directory argument like C:\MYDIR or *.LTR.  (Note: if you mean to load an 
  277.     "untitled" work area, press ^[Enter] instead of [Enter], at the ^KL 
  278.     prompt.  See PROMPTS for other control key usage.)
  279.          Files display alphabetically in uppercase, then directories in 
  280.     lowercase (beginning with the parent directory "..").  If there are more 
  281.     items than will fit on screen, you will see "..." at the top or bottom to 
  282.     indicate this.  Hidden or System files will not display and cannot be 
  283.     edited with VDE.  [Note: VINST can also specify several filetypes (like 
  284.     unreadable .COM or .EXE files) to exclude; they will not display unless 
  285.     specified explicitly, and cannot be edited.]
  286.          You can move the cursor through the list with the arrow keys, 
  287.     [PgUp,Dn], or [Home,End]; additionally, a letter "A-Z" may be typed to go 
  288.     to the next file beginning with that letter, or "\" to go to the next 
  289.     subdirectory.  When the cursor is on a subdirectory, pressing [Enter] 
  290.     allows you to view its contents in turn; when it is on a file, pressing 
  291.     [Enter] selects that file to complete your command.
  292.          If you are loading files, you can also press "+" to "tag" files, 
  293.     marking them as a group, and then press [F4] to load them all at once.  
  294.     Pressing "+" again will untag a file, or [Esc] will untag all.
  295.          You can quit by pressing ^[Break], or clear the display and return to 
  296.     the directory prompt by pressing [Esc] or [Space].
  297.  
  298.          ^KF brings up the full-featured File browser; you may specify any 
  299.     directory argument, and the contents will be alphabetically listed.  (The 
  300.     default, if you just press [Enter], is the directory shown at the ">dir" 
  301.     prompt, and all files *.*.)  Below you will see, in addition to the cursor 
  302.     motions already described, a full complement of operations to apply to the 
  303.     file the cursor is on:
  304.            [F1]   LOAD an additional file to edit;
  305.            [F2]   replace the current file with a NEW one;
  306.            [F3]   READ a file into the current file;
  307.           [Del]   DELETE the file (be careful, deletion is immediate).
  308.     If the file you want to load or read requires a different file mode, you 
  309.     can first press "/" and the correct mode letter (D,N, etc).
  310.          When the cursor is on a directory, you can press [Del] to REMOVE it 
  311.     (if empty), or [Enter] to view its contents.  (This returns you to the 
  312.     ">dir" prompt, where you can actually specify any new drive/directory.)
  313.          You can also press "+" to tag files, marking them as a group, and 
  314.     then press [F4] to load them all at once.  (Other operations cannot be 
  315.     performed while tagging.)  Pressing "+" again will untag a file, or [Esc] 
  316.     will untag all.
  317.          You can quit by pressing ^[Break], or clear the display and return to 
  318.     the directory prompt by pressing [Esc] or [Space].
  319.  
  320.  FIND/REPLACE (^QF,^QA; ^L,^H) -  ^QF is the command to FIND a string.  (See 
  321.     also "[_]" option, under SYNTAX.)  The search normally proceeds from the 
  322.     cursor position forward, and is case (upper-lower) sensitive.  In document 
  323.     modes, it allows for extra whitespace (spaces, soft CR) between words in 
  324.     the event of wordwrap.
  325.         Special codes:  Graphic characters can be entered with AltG.  ^_ 
  326.     (Ctrl-underline) functions as a wildcard, matching any single character.  
  327.     Use the single code ^M (CR) to match the end of a line (CR,LF); in 
  328.     documents, a string STARTING with ^M will match a HARD CR (without 
  329.     preceding space) only.  Use the special code ^^ (Ctrl-caret) to find line 
  330.     overstrikes created by ^PM.  Examples:
  331.               Find: ^MLABEL       matches "LABEL" at start of line only;
  332.               Find: M^_.          matches "Mr.", "Ms.", etc.
  333.         ^QA is the REPLACE command.  It asks for a string to find, as above, 
  334.     then what to change it to.  Normally, the cursor will move to each 
  335.     occurrence of the string, and you will be asked ("Chg?") whether to change 
  336.     it; answer "Y"es or "N"o, or "*" to change all the rest without asking 
  337.     individually, or press [Esc] to quit.
  338.          There are several options for find/replace:
  339.            "B" = search Backward for the specified string;
  340.            "C" = Case insensitive search (upper/lower are equivalent);
  341.            "W" = whole Word only (skip instances part of a larger word);
  342.            "G" = search Globally (from start or end of current file);
  343.            "M" = Multi-file search (continues through all files being edited);
  344.            "N" = No query: replace all instances without asking.
  345.     To skip the options prompt, finish entry of the find string (for ^QF) or 
  346.     replace string (for ^QA) by typing ^[Enter] instead of [Enter].
  347.          ^L instantly repeats the last find or replace (^QF/^QA) operation 
  348.     once more; the "B,C,W,M" options remain as last specified.  ^H also 
  349.     repeats, but in the reverse direction.
  350.          NOTES: Replacing will cause reformatting if auto format (^OM) is on.  
  351.     (Be careful with this in a file with varying margins.)  "N"o query is 
  352.     assumed whenever ^QA is used in a macro.  [VINST can set "C"ase insensi-
  353.     tive as your default, so that specifying "C" then means case sensitive.]
  354.  
  355.  FOREIGN CHARACTERS -  Characters in the upper ASCII range (80-FF or 128-255), 
  356.     such as foreign letters and accents, can be entered directly into text 
  357.     using either standard DOS method: one of the DOS KEYBxx keyboard map 
  358.     utilities, or the [Alt] key and numeric keypad (hold down [Alt] while 
  359.     pressing keypad 1,5,5 for character 155).
  360.          VDE treats these characters as "graphics": you are limited to a total 
  361.     of 32 such codes at a time, and any that you have used may be found in the 
  362.     menu brought up by the AltG command.  See GRAPHICS.
  363.  
  364.  GRAPHICS (AltG) -  You can enter a PC graphic (or foreign) character into the 
  365.     file either directly from the keyboard, via [Alt] and the numeric keypad, 
  366.     or with the AltG command.  You will be presented with a menu of up to 32 
  367.     characters (labeled A-Z,1-6) to choose from; the default set contains some 
  368.     useful box drawing parts, and has room free for other characters that 
  369.     might be loaded.  [It can also be modified with VINST.]
  370.          In addition, any individual menu entry can be redefined: type "=", 
  371.     then the code (A-6) to change.  (If a graphic definition is present in any 
  372.     file being edited, you cannot change it.)  You can then select the desired 
  373.     character from the complete graphics set, by moving the cursor to it and 
  374.     pressing [Enter].  Alternatively, if you press [Tab], you may enter the 
  375.     extended ASCII code in either hex (2 digits 80-FF) or decimal (3 digits 
  376.     128-255) format.  Example: the Greek alpha can either be picked off the 
  377.     menu, or entered as "E0" hex or "224" decimal.  Once defined, the graphic 
  378.     can be entered into the file by pressing its menu letter.
  379.          As a further convenience, you can type "-" to clear all entries not 
  380.     needed for graphics already present in your files.
  381.          Graphics are stored in disk files in accord with the current file 
  382.     mode.  Printing of graphics depends on whether your printer driver is 
  383.     designated [see PRINTER INSTALLATION] as PC graphics (PC8) or Roman8, or 
  384.     neither, in which case VDE will "emulate" them, choosing standard ASCII 
  385.     character overstrikes that come as close as possible.  This usually works 
  386.     well, especially for the foreign language characters.
  387.          NOTE: a few "control codes" in the ASCII range 00-1F,7F, if entered 
  388.     into a file with ^P, will also appear in the graphics table, because of 
  389.     the way VDE represents them internally.
  390.          CAUTION: If you load a file containing many graphics (or binary data 
  391.     that will be interpreted as graphics), VDE will try to add each in turn to 
  392.     the table.  If the graphics table fills up, any further graphics will be 
  393.     replaced by spaces.  You will see the "Graphics overflow" error message, 
  394.     and protected mode (R/O) will engage, to guard against saving to disk and 
  395.     corrupting the file.  (The most common cause of this error is attempting 
  396.     to read a file containing binary data, including a word processor file in 
  397.     the wrong file mode.)
  398.  
  399.  HEADER (^OQ) -  The "header" at the top of the screen can be toggled on and 
  400.     off with ^OQ.  It provides useful information, but can be removed if you 
  401.     prefer a screen showing nothing but your text.  It looks like this:
  402.     ------------------------------------------------------------------------
  403.     + VDE.DOC /A      P 14   L 11   C 48    Ins    Col    AF DS J+ PS ! ^K_
  404.                  or (NP,BZ)         (>)  (WIn,R/O)(CRp)(AI,HR) (MR) (?,")
  405.     -----------------------------------------------------------------------
  406.     '+' = Multi-file flag indicates other file(s) are also being edited.
  407.     'VDE.DOC /A' = Current filename and mode.  The full directory information, 
  408.          along with other files being edited, can be displayed with the AltK 
  409.          command (see INFORMATION).
  410.     'P 14...' = Cursor position in file by page (in document modes), line, 
  411.          column.  If past end of line, column displays as "C>nn".  If 
  412.          pagination off (^OP0), 'NP' displays instead of a page number; in 
  413.          block zoom mode (^KZ), 'BZ' displays.
  414.     'Ins','WIn' = Insert (^V) or Word Insert (^Ins) on.
  415.     'R/O' = Read/Only, protected mode (^KO) on.
  416.     'Col','CRp' = Column block (^KN,I) modes.
  417.     'AF' = Auto Format (^OM) on.  (Documents only)
  418.     'AI' = Auto Indent (^OA) on.
  419.     'HR' = Hard Reform (^OY) on.  (Documents only)
  420.     'DS' = Double spacing (^OS) on.
  421.     'J+','J-' = Right Justification (^OJ) modes.  (Documents only)
  422.     'MR' = Margins released (^OX).  (Documents only)
  423.     'PS' = Proportional spacing (^OK) on.
  424.     '!','?','"' = Macro is executing, awaiting input, or being recorded.
  425.     '^K_' = Command key prefixes (and some prompts) display here.
  426.  
  427.          In 40-column mode, an abbreviated header is shown:
  428.     ----------------------------------------
  429.     + VDE.DOC /A      I!  P 14  L 11  C 48      "I,W" = Insert, Word Insert
  430.                or (W,R)(?,")      (^K_)           "R" = Read/Only
  431.     ----------------------------------------
  432.  
  433.  HYPHENATION (^OH,^P-) -  VDE can't hyphenate automatically, but it can 
  434.     recognize hyphens that you type in the text, treating them as a legitimate 
  435.     place to break a line.  ^OH toggles hyphenation on and off.  If off, 
  436.     hyphens are not treated as wordbreaks.  [The default can be changed.]
  437.          In addition to ordinary hyphens, "-", there are "soft hyphens", which 
  438.     you can enter by typing ^P- (^P,hyphen), and which display in a different 
  439.     color.  Soft hyphens indicate optional places to break a long word: they 
  440.     print as a hyphen when they fall at the end of the line, but not if they 
  441.     wind up in mid-line.  (Note: only file modes /D,W,S,P,F store soft hyphens 
  442.     as such; when saving to disk in other modes, or in printing, they either 
  443.     become hyphens or disappear, as appropriate.)
  444.  
  445.  INFORMATION (AltK,AltI) -  The file/memory information command AltK displays 
  446.     a message telling you:
  447.       - The full name (including directory) of the current file;
  448.       - When it was last saved, and whether (Y/N) it has now been changed;
  449.       - Whether any print toggles (^B,^D,^S etc) are unpaired in a document;
  450.       - A word count for document files;
  451.       - The current size of the file in bytes or k (1k = 1024 bytes);
  452.       - Bytes of memory used in this text segment, and percentage full;
  453.       - The total amount of memory free to edit further files;
  454.       - The names of all other files being edited.
  455.     If more files are being edited, the cursor will be positioned on the 
  456.     second one listed; the Up/Down arrow keys can be used to select any file, 
  457.     and pressing [Enter] will take you to it.  Press [Esc] to exit.
  458.          AltI displays the VDE version, date, and copyright.  (An uninstalled 
  459.     copy of VDE does this automatically on startup.)
  460.  
  461.  INSERTING (^V,[Ins],^[Ins],^_,^N,^\) -  ^V or [Ins] toggles Insert mode 
  462.     on/off, and ^[Ins] toggles Word Insert.  When on, you will see "Ins" or 
  463.     "WdI" in the header.
  464.          When both are OFF, VDE is in Overwrite mode: when you type a 
  465.     character, it replaces the one the cursor is on; when you press [Enter], 
  466.     the cursor advances to the beginning of the next line of text.  With 
  467.     Insert (^V) ON, when you type a character, it is inserted into the text, 
  468.     while any characters that were already there are carried to the right; 
  469.     when you press [Enter], a return is inserted into the text, causing the 
  470.     beginning of a new line.
  471.          Word Insert is a hybrid of the two modes: mostly it behaves like 
  472.     Overwrite mode, so you can replace an existing word; but when the cursor 
  473.     reaches the end of the word, it starts to behave like Insert mode, so you 
  474.     can continue typing without overwriting the next word.  This is handy for 
  475.     revising existing text.
  476.          The ^_ and ^N commands (insert space, insert CR) are most useful in 
  477.     Overwrite mode (avoiding the need to turn Insert on and back off).
  478.          The ^\ command copies the character above the cursor (in the previous 
  479.     line), making it easy to duplicate parts of lines.  Handling of existing 
  480.     characters depends on the Insert mode.
  481.  
  482.  JUSTIFICATION (^OJ) -  ^OJ controls right justification mode, cycling between 
  483.     three states:
  484.               ADD.  ("J+" in header.)  Text paragraphs will be 
  485.          formatted with an even right margin, by inserting extra 
  486.          spaces between words as necessary.
  487.               REMOVE.  ("J-" in header.)  Formatting will undo 
  488.          justification by removing any extra spaces between words, 
  489.          leaving an uneven right margin again.
  490.               OFF.  Formatting does not change spacing of text.
  491.     Thus the Reform (^B) command can justify or de-justify text as desired.
  492.          Notes: Justification does not work with proportional spacing (^OK).  
  493.     Right-justified text should not be saved in file mode /U, which has no 
  494.     margin structure, or in modes /X,/M,/P, or /F, because XyWrite, MS Word, 
  495.     and WordPerfect will not recognize VDE's method of justification.
  496.  
  497.  LINE SPACING (^OS) -  ^OS toggles between single and double line spacing.  In 
  498.     double space mode, the following functions generate double carriage 
  499.     returns: [Enter], Insert CR (^N), Reform (^B), Wordwrap.  You can easily 
  500.     mix single and double spacing; ^B can convert between the two.
  501.          Note: a single-spaced file can also be printed out double-spaced with 
  502.     the "D" option of the ^KP command (see PRINTING).
  503.  
  504.  MARGINS (^OR,^OL,^OX,^OC,^OF) -  ^OR sets the Right margin, and enables text 
  505.     formatting.  At the prompt, enter the column number (up to 255), or just 
  506.     press [Enter] for the current cursor column.  (Note: in proportional mode 
  507.     (^OK), the number is interpreted in 1/10" instead of characters.)
  508.          ^OL similarly sets the Left margin column; the value must be less 
  509.     than the right margin.  (^OL is normally used for indenting selected 
  510.     paragraphs.  To leave blank space at the left of the page throughout when 
  511.     PRINTING, see the "L" option of the ^KP command, or the left margin 
  512.     setting in PRINTER INSTALLATION.)
  513.          "Wordwrap" is automatic in all document modes whenever the margins 
  514.     are set: anything typed before the left margin will move up to it; 
  515.     anything typed past the right margin will wrap over to the next line.  
  516.     (See also REFORMAT and AUTO FORMAT.)  Wordwrap and formatting are disabled 
  517.     if the right margin is set to 1, or while margins are released (^OX).
  518.          (NOTES: Margins cannot be set in nondocument modes; a left margin 
  519.     cannot be set in /X, /U, or /M mode.  For page top/bottom margins see 
  520.     PRINTING.)
  521.          ^OX toggles margin release, allowing you to type outside the margins.  
  522.     Use ^OX again to cancel.
  523.          ^OC Centers the current line with respect to the margins; ^OF sets 
  524.     the line Flush right.  Afterward, the cursor advances to the next line.
  525.  
  526.  MATCHING FILES (AltM) -  This command can locate small differences between 
  527.     two largely similar files (perhaps an earlier and a later revision of your 
  528.     work).  You must first load these two files (AltL), then split the screen 
  529.     between them (AltW), and position the cursor in corresponding places in 
  530.     both files (for example, the top).
  531.          Then press AltM.  Starting from these positions, VDE searches for any 
  532.     difference between the files.  If there is one, VDE will stop on those 
  533.     lines, showing the disagreeing passages side by side.  If you want to 
  534.     continue, press AltM again.  (If the difference was significant you may 
  535.     first need to reposition one cursor to match the other.)  If the cursor 
  536.     winds up at the end of both files, they match.
  537.          Note: in document modes, AltM compares word by word, ignoring mere 
  538.     formatting differences (margins, spacing etc).  In nondocument modes, it 
  539.     is an exact character by character comparison.
  540.  
  541.  MENUBARS (^[Esc]) -  ^[Esc] is used to call up the MenuBar.  (LeftShift-Esc 
  542.     can also be used.)  Press the hilighted letter to select a submenu, then 
  543.     select again to perform a command.  You can press [Esc] or [Space] to back 
  544.     up to the main menu, or ^[Break] to abort.
  545.          The ^[Esc] command can also be used in a macro definition; if entered 
  546.     at the Esc[ prompt, it displays as a hilighted "!", and should be followed 
  547.     by one or two letters for menu selections.  (This feature is used in the 
  548.     WordPerfect compatibility macros contained in WP.VDF, to present menu 
  549.     choices; see DEFAULT FUNCTION KEYS.)
  550.  
  551.  MULTIPLE FILES (AltL,AltB,AltN,AltX,AltQ,AltC,AltP) -  VDE allows you to edit 
  552.     up to 8 files simultaneously, if you have enough memory.  This can be done 
  553.     from the command line, by giving a list of several filenames.
  554.          Otherwise, to Load additional files, press AltL.  You can enter any 
  555.     number of filenames, with optional line/page numbers and modes (see 
  556.     SYNTAX); for an "untitled" work area, press ^[Enter].  You can also access 
  557.     the file browser with [Enter] or wildcards (see FILES).  (You will get an 
  558.     error message if you run out of memory, or are already editing the named 
  559.     file, or 8 files.)
  560.          Once multiple files are in use, AltB and AltN can be used to cycle 
  561.     back and forth through the files being edited.  If you Quit or Exit 
  562.     (^KQ,^KX) from one file, you will be returned to the previous one.  It is 
  563.     possible to view two files on screen at once (see WINDOWS).
  564.          For convenience, AltX exits ALL files immediately, saving any changes 
  565.     made.  AltQ quits ALL files immediately, without saving; if any of them 
  566.     have been modified, you will be prompted (just once) to confirm this.
  567.          The Cut(Copy) and Paste functions are designed to copy a block of 
  568.     text between two files; of course they also work within a single file, 
  569.     although ^KC is generally easier to use.  AltC Cuts a marked block of 
  570.     text, placing it in a buffer for later recovery.  [VINST lets you choose 
  571.     whether or not the cut block is also removed from its original position.]  
  572.     AltP Pastes in the previously cut text at the cursor position.  ^QP can be 
  573.     used to move to the end of the text just pasted.
  574.  
  575.  PAGINATION (^OP,^PL) -  The ^OP command sets the page length: the number of 
  576.     text lines (not including any header or page numbering, which take 3 extra 
  577.     lines) per page.  Enter a value up to 255 lines, or 0 for no pagination.
  578.          This setting determines the page and line count shown in the document 
  579.     header ("P xx L xx"); when nonzero, all page functions (numbering, 
  580.     headers, start/stop at page) are enabled in printing.  A formfeed will be 
  581.     sent to eject each full page.  [VDE does not send a formfeed before 
  582.     printing; install one in your printer initialization if you want.]
  583.          When zero, pagination is off.  The header will say "NP L xxxx", 
  584.     showing you the absolute line number in the file; printing occurs with no 
  585.     page breaks, though a formfeed is sent at the end of the file.  (To skip 
  586.     even this, use the block print option "B", which allows you to print 
  587.     several small things on the same sheet or, in conjunction with the "*" 
  588.     option, multiple copies of index cards, labels, etc.  See PRINTING.)
  589.          The ^PL command embeds a formfeed (^L) in the text, to begin a new 
  590.     page; the best place to put it is at the beginning of a line.
  591.  
  592.  PARAGRAPH INDENT (^OG) -  You can indent text simply by changing the left 
  593.     margin (^OL), but there are times when you want only a temporary indent.  
  594.     ^OG gives a "paragraph indent"; each time you use it, the left margin is 
  595.     reset to the next tab stop over (see TABS).  The indentation lasts until 
  596.     you type the [Enter] at the end of the paragraph (or use the ^B or ^OL 
  597.     commands), at which time the original left margin is restored.
  598.  
  599.  PLACE MARKERS (^KM,^KU;^QM) -  You can set any number of temporary place 
  600.     markers in the text with ^KM, when you want to return to a spot later.  
  601.     Place markers display as a highlighted "!", and can be deleted 
  602.     individually if no longer needed; they are NOT saved to disk.
  603.         ^KU can be used to remove all markers from a file at once.
  604.         ^QM moves the cursor to the next place marker in the file, cycling 
  605.     back to the top of the file as needed.
  606.  
  607.  PRINT PREVIEW (^OD) -  This command shows you a preview of the text as it 
  608.     would print: with all non-printing codes (markers, ^P codes, etc) hidden, 
  609.     and page breaks indicated by a row of dotted lines.  This is handy for 
  610.     making sure that text is aligned properly, and will help you avoid wasting 
  611.     time and paper on unacceptable printouts.  You can scroll through the file 
  612.     in this mode with [PgUp,Dn] or ^R,^C; or move to the top or bottom, with 
  613.     ^[Home,End].  Press [Esc] to continue editing.
  614.  
  615.  PRINT STYLES/CODES (^P) -  This command prefix is used to enter various 
  616.     "codes" in the ASCII range 00-1F,7Fh into the text, usually for purposes 
  617.     of printer control.  Most codes are entered in a standard fashion: ^PA 
  618.     embeds ^A, etc.  Those with defined functions in VDE documents display as 
  619.     highlighted letters, and always insert; the rest (all, in nondocuments or 
  620.     /A mode) display as graphics, and observe the current INSERT status.
  621.          Several standard ASCII codes will seldom be needed: ^P[Esc] will 
  622.     enter the ESC code (1Bh), but these are most commonly used for printer 
  623.     control, and VDE offers a much easier way of doing this (see below).  
  624.     ^P[Del] enters the DEL code (7Fh).  ^P^Z enters the code ^Z (1Ah), which 
  625.     normally should not be used because many programs (including MSDOS) treat 
  626.     it as an end of file (EOF) mark in a text file.
  627.          Several other common control codes will produce special effects:
  628.           ^P^I - tab - printers respond variously to this
  629.           ^P^L - formfeed - causes a page break
  630.           ^P^H - backspace - overstrikes previous character
  631.           ^P^M - carriage return (without linefeed) causes overstruck line
  632.  
  633.     The further codes below do NOT operate in nondocuments or /A mode.
  634.          ^P^G causes printing to pause immediately, until you press a key to 
  635.     continue ([Esc] will cancel).  This allows you to adjust the paper 
  636.     position on some printers for printing forms.  (Note: on many dot matrix 
  637.     printers, can only be used at the start of a line.)
  638.          In place of complex "escape sequences" for print styles (underlining, 
  639.     etc), VDE lets you enter a single marker, which will be translated into 
  640.     the proper codes during printing.  VDE supports a set of 13 codes for this 
  641.     purpose: seven toggles, six switches.  [See PRINTER INSTALLATION on how to 
  642.     install the proper driver for your printer.  Otherwise, only ^PS and ^PX 
  643.     will work.]  The conventional WordStar meanings of these codes are:
  644.        Toggles: ^P^B  boldface        Switches: ^P^Q  (user def 1)
  645.                   ^D  ("doublestrike")            ^W  (user 2)
  646.                   ^S  underline                   ^E  (user 3)
  647.                   ^Y  italic ("ribbon")           ^R  (user 4)
  648.                   ^T  superscript                 ^A  alternate pitch
  649.                   ^V  subscript                   ^N  standard pitch
  650.                   ^X  strikeout [with "-", "/", etc -- see USER OPTIONS]
  651.     But you can use them for anything you like.  "Toggles" are good for 
  652.     features like underlining that are turned on and off; enter them in pairs, 
  653.     to mark the beginning and end of the desired text.  "Switches" are better 
  654.     for multi-valued parameters like character pitch or print quality.
  655.          If toggles are not properly paired, you will find print effects 
  656.     continuing throughout the rest of your document.  To save time and effort, 
  657.     use the AltK command to check for this before printing.
  658.  
  659.  PRINTER DRIVERS (AltV,AltU) -  Since many people use more than one kind of 
  660.     printer, VDE accomodates two different printer drivers, a primary and an 
  661.     alternate.  Before printing a file, you can select which one is active 
  662.     using AltV.  [You can install different drivers with VINST.]
  663.          AltU gives you access to an unlimited number of further printer 
  664.     drivers in the form of .VDP disk files; select "L"oad, then type the file 
  665.     name.  [See PRINTER INSTALLATION for instructions on how to create such 
  666.     files.]  The new driver will replace the previous primary.
  667.  
  668.  PRINTING (^KP) -  The ^KP command Prints the file you are editing.  The page 
  669.     format is determined by several factors: the current page length (^OP) 
  670.     determines the number of lines of text per page.  The top and left margins 
  671.     can be varied with options below.  Other options produce either a centered 
  672.     page number at the bottom of the page, or a header, consisting of a page 
  673.     number in the corner and/or a string of text; the spacing of these is 
  674.     controlled by settings in the printer driver.  Various printers position 
  675.     paper differently, but can typically put at least 60 lines of text on a 
  676.     standard 11-inch page.
  677.          You will be asked for a set of "Options:", at which point you may 
  678.     enter one or more of the following, in any order:
  679.  
  680.        @nn    begins printing AT page nn of the document.
  681.        =nn    RENUMBERS the printout so first page is numbered nn.
  682.        #nn    prints only (up to) a TOTAL of nn pages.
  683.        O,E    prints only Odd or Even pages (print one, then run the paper 
  684.             back through and print the other, for double-sided printing).
  685.        F      prints FACING pages (header/number reversed on even pages).
  686.        *nn    prints the entire job out nn TIMES (nn=1...255).
  687.  
  688.        N      NUMBERS pages sequentially, at top right.
  689.        C      numbers pages at bottom CENTER.
  690.      "..."    uses the quoted string as a HEADER.  The string will print at 
  691.             the top right next to the page number unless it begins with a "<" 
  692.             character, in which case it prints at the left edge.
  693.               Note: you can include the current Filename, Time or Date in the 
  694.             header simply by entering ^F, ^T, or ^D, respectively.  To enter a 
  695.             quote mark, double it ("").
  696.        S      SUPPRESSES the header/page number on the first page of output.
  697.        Tnn    sets a TOP MARGIN skip of nn lines.     [The default margins can
  698.        Lnn    sets a LEFT MARGIN skip of nn columns.    be set with VINST.]
  699.  
  700.        B      prints only the currently marked BLOCK.  Pagination is disabled, 
  701.             and no final formfeed is sent; you may have to eject the page.
  702.        A      ADDRESSES an envelope; see ENVELOPES.
  703.        P      PAUSES for your keystroke before each page prints (sheet feed).
  704.        ^      FILTERS control codes (like ^X) so they print out as text "^X".
  705.        D      DOUBLESPACES the printout.
  706.      '...'    sends an additional string of printer initialization commands 
  707.             before printing begins.
  708.   (FILENAME)  redirects printer output to a disk file.  All print control 
  709.             codes will go into the file just as they would have been sent to 
  710.             your printer, according to your current printer driver.  To append 
  711.             the output to an existing file, use a "+": (+FILENAME).
  712.  
  713.               EXAMPLE 1:      Options:  "<STATUS REPORT: ^D" N F
  714.     will put a header like "STATUS REPORT: 10/19/90" at the top left of each 
  715.     page, and the page number at the top right (vice versa on even pages).
  716.               EXAMPLE 2:      Options:  L12 #1
  717.     will print one page only, with an added left margin of 12.  (Printing a 
  718.     single page is a good check of page layout before going ahead to print a 
  719.     long file.  To continue at page two, use Options: @2.)
  720.               EXAMPLE 3:      Options:  BD(+SCRATCH)
  721.     will append the print output of the current marked Block, double spaced, 
  722.     to the disk file SCRATCH.
  723.  
  724.          ABOUT PAGINATION:  If you set the page length to 0 (see ^OP) or 
  725.     select the 'B' option to print only a block, the output will NOT be 
  726.     paginated by VDE -- that is, data will be sent to the printer in a 
  727.     continuous stream, and the printer will break pages when it considers them 
  728.     full.  No headers or page numbers will be printed; in fact, none of the 
  729.     options @,=,#,O,E,F,N,C,S,T,P,"...", which involve page numbering, are 
  730.     allowed with 'B'.  If for some reason you do want paginated printing of a 
  731.     block only, you must cut and paste it to a new file (see AltC,P), and 
  732.     print it as a separate file.
  733.  
  734.          ABOUT MARGINS: A left margin that is part of a document's format (via 
  735.     ^OL, etc) affects the file text but not placement of headers or page 
  736.     numbers.  Left margin settings external to the text ("Lnn", or printer 
  737.     driver default) shift the entire printout to the right, including headers 
  738.     and page numbers.  Because these settings are also in columns, their 
  739.     physical width will vary according to the font in use; you will get more 
  740.     consistent results if you use your printer's absolute left margin setting 
  741.     feature (see PRINTER INSTALLATION).
  742.  
  743.          ABOUT INITIALIZATION:  Codes '...' must be entered as actual 
  744.     characters or control codes, not digits.  If the command is "Esc A" (1B 41 
  745.     hex), press quote, ^P, [Esc], A, quote.  To enter a quote mark (27 hex), 
  746.     double it ('').  (Some control codes, including Esc, must be entered with 
  747.     the ^P prefix; see PROMPTS.  Codes 00-1F are entered as ^A, ^B, etc.  You 
  748.     may find an ASCII table helpful; see VINST.REF.)  An empty string ('') can 
  749.     be used to skip the driver's usual initialization, and can be followed 
  750.     (after a space) by another string '...' to use instead.
  751.  
  752.          OTHER NOTES:  Options 'C' and 'N' cannot be used together.
  753.          If you are in /W or /S file mode, any WordStar dot commands in the 
  754.     file (lines beginning with ".") will not be printed.
  755.          You can cancel printing at any time by pressing [Esc], or pause by 
  756.     pressing any other key (press a key again to resume).
  757.  
  758.  PROPORTIONAL SPACING (^OK) -  Normally VDE assumes a fixed pitch font, since 
  759.     each character is the same width.  If you print with such a font (like 
  760.     Courier or Prestige Elite) your printout will look just like what you saw 
  761.     onscreen.  If you switch your printer to a proportional font (like Times 
  762.     Roman) and print the same document again, it will look quite different: 
  763.     the right margin will become very uneven; indents and tabs will shrink, 
  764.     and may not line up properly from one line to the next; etc.  This is 
  765.     because character widths now vary, and spaces are usually smaller than the 
  766.     average width.  Word processors devote an enormous amount of code and 
  767.     data, which VDE has no room for, to coping with the challenges of 
  768.     proportional printing, and the different fonts you might use.  But if your 
  769.     printer has a proportional font that you like, you can still get VDE to 
  770.     use it, and to format text so that at least it will once again print with 
  771.     a more even right margin.
  772.          Use ^OK to toggle proportional mode on and off.  When on, you will 
  773.     see "PS" in the header; all wordwrap and reformatting (^B,^OC,^OF) will 
  774.     take advantage of a table of varying character widths, for a better 
  775.     aligned printout, though now line lengths may look uneven on screen; and 
  776.     when you print, a proportional font will be selected.  In proportional 
  777.     mode, the right margin is interpreted in inches rather than characters, 
  778.     based on a conversion of 10 cpi, so that a right margin (^OR) setting of 
  779.     70 means 7.0", rather than 70 characters.
  780.          Mixing proportional and fixed print in the same document is a little 
  781.     tricky.  You will need to install a print (^P) toggle or switch to 
  782.     alternate between the two fonts.  You must type or format the fixed pitch 
  783.     parts with ^OK off, and the proportional parts with ^OK on (and 
  784.     appropriately altered margins).  The ^OK status when you print determines 
  785.     which font VDE starts out with.
  786.  
  787.          Note the following LIMITATIONS in VDE's admittedly crude implemen- 
  788.     tation of this feature:
  789.          You may need to install codes to enable proportional mode in your 
  790.     printer driver [see PRINTER INSTALLATION].
  791.          Proportional printing should work fairly well with VDE's default 
  792.     width table, but for best results, you should fine-tune this table to 
  793.     match the actual character widths of your own preferred font [see 
  794.     CHARACTER WIDTHS].
  795.          Only the right margin setting (^OR) is affected by proportional mode.  
  796.     The left margin, tabs, and the ruler line can still be used, but they 
  797.     continue to work based on character columns.
  798.          Right justification (^OJ) is not available in proportional mode.
  799.  
  800.  PROTECTED MODE (^KO,/R) -  When you want to view a file without accidentally 
  801.     modifying it, you can engage protected mode with ^KO: the flag "R/O" (for 
  802.     Read/Only) shows in the header, and any command that would modify the file 
  803.     will be rejected as an "Invalid Key".  To disengage, use ^KO again.
  804.          If you load a file with the DOS R/O attribute, protected mode will 
  805.     engage automatically.  There is also an option /R that can be specified 
  806.     after a filename to load it Read/Only.  In either case, the ^KO command 
  807.     will not be able to disengage it.  The text cannot be modified with VDE, 
  808.     unless you first rename it (^KE) to a new filename.
  809.  
  810.  REFORMAT ([Enter],^B;Esc*S;^OY;^OB) -  In documents, pressing [Enter] creates 
  811.     a permanent or "hard" Carriage Return marking the end of a paragraph.  
  812.     (This is a CR without a preceding space; wordwrap creates a removable 
  813.     "soft CR", preceded by a space.  See TEXT FORMATTING.)
  814.          ^B reformats the paragraph the cursor is in according to the current 
  815.     margin settings and line spacing.  (Thus ^B is used not only to reshape a 
  816.     paragraph after editing, but also to change its format in various ways: 
  817.     see MARGINS, JUSTIFICATION, LINE SPACING.)  If the top line is indented 
  818.     relative to the next one, VDE preserves that as paragraph indentation.  To 
  819.     reformat an entire file use the MACRO command (Esc[) to repeat ^B.  (See 
  820.     also AUTO FORMAT.)
  821.          Use Esc*S if you want ^B to adjust single lines ending in a hard CR 
  822.     to the left margin; Esc*s returns to the default, which is to leave such 
  823.     lines alone (since they might be centered titles, etc).  (This is a 
  824.     special case of the Esc* TOGGLE CONTROL command.)
  825.          ^OY toggles hard reform mode, which allows reformatting of text 
  826.     containing hard CRs (such as ASCII text from other sources).  "HR" 
  827.     displays in the header; autoformat is turned off; reform (^B) will convert 
  828.     a group of text lines with hard CRs into a formatted paragraph with soft 
  829.     CRs.  A blank line or change of indentation is recognized as starting a 
  830.     new paragraph.  There are also various ways of converting a "soft" 
  831.     paragraph back into hard text; the easiest is to save it in /N mode.
  832.          ^OB toggles hard CR/TAB display.  In document modes, these are 
  833.     normally marked by left-arrow or double-arrow characters, to distinguish 
  834.     them from soft CRs and spaces; but if you find this distracting, you can 
  835.     turn them off.
  836.  
  837.  RULER LINE (^OT) -  To help you align text properly, ^OT displays a "ruler 
  838.     line" above the text.  Type ^OT again to remove it.  A moving pointer 
  839.     indicates the current column.
  840.          In each column you will see one of several symbols: the arrow "v" is 
  841.     the cursor column; "L,R" designate the current margins; "." indicates 
  842.     areas outside the current margins, "-" within them.  Also, tab stops are 
  843.     marked by either "!" (Variable) or ":" (Hard).  Examples:
  844.         (/D mode)      L-----!---!----------v--!--------------R........
  845.         (/N mode)      :.......:.......:....v..:.......:.......:.......
  846.  
  847.  RUN COMMAND/SHELL (AltR) -  AltR lets you run DOS commands without leaving 
  848.     VDE.  An imitation DOS prompt is produced (e.g., "C:\WORK>"); you can copy 
  849.     or rename files, or run any other program you like, and afterwards VDE 
  850.     will prompt you to "Press [Esc]", which will return you to your undis- 
  851.     turbed VDE editing session.
  852.          In addition, you may simply hit [Enter], which lets you out into what 
  853.     is known as a Command Shell: you are actually back IN DOS, and can use any 
  854.     number of commands or move around as you like; when through, you need to 
  855.     type the DOS command EXIT to return to VDE.
  856.          Caution: don't load new memory-resident utilities from within the 
  857.     AltR command; this fouls up the DOS memory allocation.
  858.          To use AltR, you must have enough free memory to load and run the 
  859.     chosen program; and VDE must be able to find COMMAND.COM in order to 
  860.     execute it, via the COMSPEC environment variable.  Be sure either that 
  861.     your AUTOEXEC.BAT file includes a line like
  862.                         SET COMSPEC=C:\COMMAND.COM
  863.     or that your CONFIG.SYS file includes a line like
  864.                         SHELL=C:\COMMAND.COM C:\ /P
  865.     (In either case replace "C:\" with the appropriate directory.)
  866.  
  867.  SAVE/EXIT (^KE,^KS,^KX,^KD,^KQ) -  ^KE renames your work, allowing you to 
  868.     change the filename (including directory) to which it will be saved, 
  869.     and/or the file mode governing its format.  At the prompt you can enter a 
  870.     new filename, directory, mode, or any combination of these.  You can make 
  871.     your work "untitled" by pressing ^[Enter] at the prompt.  (See PROMPTS for 
  872.     other control key usage.)
  873.          ^KS Saves your work so far, writing the text to a disk file named in 
  874.     the header.  (If it's "untitled", a new name will be requested.)  If the 
  875.     file has not been modified, you will be prompted to confirm that you meant 
  876.     to save it again anyway.  For safety, when you save changes to an existing 
  877.     file, a copy of the previous version is preserved as a BACKUP FILE (with 
  878.     the same name, but extension ".BAK").  If you decide to abandon your 
  879.     latest changes, you can recover the old version from the BAK file.  [You 
  880.     can choose not to maintain BAK files, if you prefer; see VINST, OPTIONS.]
  881.          There are several different commands for finishing up:
  882.        ^KX eXits, saving your work (if modified).
  883.        ^KD (Done) saves your work, then prompts you for a new file to edit.
  884.        ^KQ just Quits, without saving to disk.  If the file has been modified, 
  885.     you will be prompted to confirm that you meant to do this!
  886.  
  887.  SCREEN CONTROLS (^W,^Z; Alt-arrows; ^OE,^OZ) -  VDE provides a number of 
  888.     commands to control the display screen:
  889.          ^W and ^Z shift the screen frame up and down a line at a time, 
  890.     without moving the cursor in the text (unless necessary).
  891.          Used with [Alt], any arrow key also causes the frame to shift: 
  892.     up/down by 1/3 screen, or right/left 32 columns.  Again, the cursor is not 
  893.     moved unless necessary.  (The screen cannot shift rightward past the end 
  894.     of the current line.)
  895.          ^OE makes the current line the top of the screen.
  896.          ^OZ temporarily blanks the entire screen: for avoiding CRT burn-in, 
  897.     or just protecting work from prying eyes or fingers.  Restore the screen 
  898.     by pressing [Esc].  This is also useful if some other software (like a 
  899.     memory-resident utility) has messed up the screen: type ^OZ,Esc and VDE 
  900.     will completely restore it.
  901.  
  902.  SCREEN SIZE (AltA,AltE) -  VDE automatically adapts to any size text screen 
  903.     currently in use (minimum: 40 columns, 8 lines).  This means that VDE 
  904.     supports nonstandard screen sizes (like 96 or 132 columns) provided by 
  905.     some PC video systems; it will run on laptop/palmtop computers with 
  906.     smaller displays; and visually impaired users can use the DOS command MODE 
  907.     40 to edit with a 40 column large-type screen.  When running with fewer 
  908.     than 80 columns, VDE omits most toggle indicators from the header, and 
  909.     truncates the function key labels; also, some menus remain in 80-column 
  910.     format, and can be scrolled horizontally by pressing the [<,>] keys while 
  911.     they are on screen.
  912.          You can use your own software (like the popular UltraVision program, 
  913.     or any utilities that may have come with your video adapter card) to 
  914.     change the font or screen size (lines,columns) before running VDE, or even 
  915.     while editing (via the AltR command).  VDE also offers two internal 
  916.     commands to vary screen size:
  917.          AltA changes the screen width, toggling between normal (80-column) 
  918.     mode and wide (132-column) mode.  It can be used alone, or in combination 
  919.     with AltE.  This command works ONLY with certain brands of video cards 
  920.     which offer 132 column displays [see INSTALLATION to specify yours], or if 
  921.     you are running UltraVision with a card that supports its 132 column mode.
  922.          AltE changes the screen length (number of text lines displayed).  In 
  923.     standard 132-column modes it simply toggles between the normal 25-line and 
  924.     50-line (VGA; 43 for EGA) text.  But when possible, it displays a prompt 
  925.     offering a wider range of sizes:
  926.                     Standard VGA - 20,25,28,33,40,50,57 lines  (80 cols)
  927.                              EGA - 17,25,29,35,43,50
  928.             with UltraVision VGA - 25,34/36,50/53,60/63 lines  (80/132 cols)
  929.                              EGA - 25,34,43,60
  930.     You can select a letter code A-G, or [Enter] for your default value [which 
  931.     can be changed with VINST].  Larger characters are easy on the eyes; 
  932.     smaller ones can pack more text into one screen.
  933.          NOTE: Under DESQview, you must use its "Rearrange:Video" menu 
  934.     selection to change text sizes; VDE's own commands will not work.
  935.  
  936.  SPELLING CHECK (AltH,AltJ) - For registered users who have the spelling 
  937.     checker, AltH will check spelling of the word at the cursor, and AltJ will 
  938.     go through the document beginning at the word after the cursor.  See the 
  939.     VDESPELL.DOC file that comes with the speller for complete instructions.
  940.  
  941.  SPLITTING FILES (AltS) -  If you encounter a text file that is too large for 
  942.     VDE to load and edit, you can divide it into manageable chunks with the 
  943.     Split command.  You will be prompted for the name of the file to split; 
  944.     VDE will divide it in pieces whose names have a number added at the end of 
  945.     the file name.  Example: BIG.DOC will split into BIG1.DOC, BIG2.DOC, etc, 
  946.     each of which you can edit separately.  After 9, the numbers continue with 
  947.     letters A..Z.  (The original file also remains on disk.)
  948.          If necessary, the files can later be reassembled into one with the 
  949.     DOS COPY command, for example:  COPY BIG1.DOC+BIG2.DOC BIG.DOC.
  950.  
  951.  TABS ([Tab],Shft[Tab],^[Tab]; ^OV,^OI,^ON; ^PI,Alt[Tab]) -  There are two tab 
  952.     modes, Variable and Hard; ^OV toggles between them.
  953.          In Hard Tab mode (the default for nondocuments), the [Tab] key enters 
  954.     an actual TAB (ASCII 09) character, which will overwrite the character at 
  955.     the cursor or, if Insert is on, insert before it.  Hard tabs display at 
  956.     fixed intervals [normally 8 columns; optionally 4 or 16], and also appear 
  957.     as a bidirectional arrow in document modes.  How (or whether) they print 
  958.     depends upon your printer's handling of code 09h.
  959.          In Variable Tab mode (the default for documents), the [Tab] key just 
  960.     moves the cursor to the next tab stop set.  In Overwrite mode, the cursor 
  961.     moves over any existing text; in Insert mode, spaces are inserted into the 
  962.     text.  In either case, spaces are added at the end of a line as needed.  
  963.     Up to sixteen tab stops may be set with ^OI, or cleared with ^ON; the 
  964.     defaults are in columns 6, 15, 35, and 55.  [These can be changed.]  Both 
  965.     commands prompt for a list of column numbers, or you can press [Enter] for 
  966.     the cursor column.  The Set command ^OI also accepts two options, both of 
  967.     which replace all previous tab settings:
  968.               @nn           Set tabs every "nn" columns
  969.               #n1,n2,...    Set tabs to columns "n1,n2,..." ONLY
  970.     You can simply clear all variable tabs by typing ^ON followed by "*".
  971.          Shft[Tab] tabs backwards (left to the previous tab position), useful 
  972.     for moving around in tables, etc.
  973.          ^[Tab] tabs to the column of the next nonblank in the previous line, 
  974.     for automatic alignment with existing columns.
  975.          Alt[Tab] offers a shortcut to get a hard tab in variable tab mode, or 
  976.     variable tab in hard tab mode.  And ^PI can always be used to insert a 
  977.     hard tab.
  978.  
  979.  TIME/DATE (AltT,AltD) -  VDE can read the DOS system clock and insert the 
  980.     current time and date in your file automatically.  Just press AltT for the 
  981.     Time, or AltD for the Date.  The string will appear at the current cursor 
  982.     location, as though you had typed it in yourself: for example,
  983.               1:21 PM            [or 13:21 -- VINST selects the format]
  984.               January 15, 1988   [or 1/15/88, 15 January 1988, 15.1.88]
  985.  
  986.  UNDELETING (^U) -  The undelete function can be used to recover accidentally 
  987.     deleted text or overstruck characters.  The lost text will be replaced at 
  988.     the current cursor location.  ^U may be used repeatedly to undo a sequence 
  989.     of deletions, recovering each character, word, or line in order.  (Once 
  990.     all deleted text is restored, ^U does nothing.)
  991.          Exception: block deletions cannot be recovered sequentially, they 
  992.     must be undeleted immediately (before any other deletion occurs).  An 
  993.     undeleted block is no longer marked, but can be re-marked with the 
  994.     commands ^KB ^QP ^KK.
  995.          Undeletion can also be used as a sort of quick-and-dirty block move.  
  996.     For example, if the cursor is at the start of a word, the commands ^T^F^U 
  997.     (which of course can be assigned to a function key) will swap that word 
  998.     with the one following it.  Similarly, ^Y^X^U will swap two lines.
  999.  
  1000.  UPPER/LOWER CASE (^^; ^K",^K',^K^) -  ^^ (Ctrl-caret or 6) reverses the case 
  1001.     of the character at the cursor, if it was a letter, and moves to the next.
  1002.          ^K^ (^K-caret) reverses all text in a marked block (see BLOCK 
  1003.     COMMANDS); ^K" makes all text in the block uppercase, ^K' lowercase.
  1004.  
  1005.  WINDOWS (^OW; AltW,AltF; ^[PgUp,PgDn]) -  VDE can split the screen into two 
  1006.     windows, showing either two parts of the same file or two different files.  
  1007.     In either case, AltF moves the cursor back and forth between the two 
  1008.     windows.  ^[PgUp] and ^[PgDn] scroll BOTH windows in synchronization.
  1009.         ^OW is used within a SINGLE file; it creates a second window 
  1010.     (originally a duplicate of the first, of course) in which you can move to 
  1011.     and view or edit another location in the file at the same time.  (Note: 
  1012.     modifications made to the same area of the file will be reflected in the 
  1013.     inactive window after an interval of keyboard inactivity.)  Type ^OW again 
  1014.     to undo windowing.
  1015.         AltW splits the screen Window between two DIFFERENT files being 
  1016.     edited, showing you both at once (note the different filename in the 
  1017.     second window).  Type AltW again to undo.
  1018.  
  1019.  
  1020.  ====================  7. REVIEWS / ABOUT THE AUTHOR  ========================
  1021.  
  1022.  
  1023.       Reviewers and users comment on VDE as a writing tool:
  1024.  
  1025.        "VDE is a word-processing program for people who like their 
  1026.     programs lean, mean and simple... executes all the standard 
  1027.     operations necessary for writing articles, books or screenplays... 
  1028.     blazingly fast... Even the loading and storing of files is speedy."     
  1029.               - Paul Ciotti, Los Angeles Times Magazine (18 March 1990)
  1030.  
  1031.        "This may be the finest piece of word processing code ever 
  1032.     written.  I have never been as impressed with anything as I have with 
  1033.     VDE 1.5... writing software in 100 percent assembly language still 
  1034.     pays off in performance and reduced code size.  It's an astonishing 
  1035.     product, believe me.  It's more than the perfect laptop word 
  1036.     processor.  Actually, it's something that corporations should 
  1037.     consider if they want to save tens of thousands of dollars...  I 
  1038.     cannot give a higher recommendation for any product that I have seen 
  1039.     in ten years than I can for VDE 1.5.  Top recommendation."
  1040.               - John Dvorak, PC Magazine (24 April 1990)
  1041.  
  1042.        "What fascinated Dvorak was not just the astonishing functionality 
  1043.     achieved with very little programming code, but also the attitude -- 
  1044.     and implications -- of the author who circulated it freely asking 
  1045.     only for a modest sum...  VDE is an amazing word-processor, offering 
  1046.     almost everything except the layout and document processing features 
  1047.     found in far fatter programs... it supports the old WordStar command 
  1048.     set... ergonomically the most efficient I've ever learned."
  1049.               - Colin Brace, Language Technology/Electric Word (July/Aug 1990)
  1050.  
  1051.        "I've used various versions of WordStar, WordPerfect, and Wang 
  1052.     IWP.  I wouldn't trade my copy of VDE for shrink-wrapped sets of the 
  1053.     latest versions of all of these.  I congratulate you both on the 
  1054.     quality of your program and on your policy in making it available..."
  1055.               - K.N., registered VDE user (August 1991)
  1056.  
  1057.        "You've recognized a truth about writing, which every commercial 
  1058.     word-processor vendor has forgotten.  Writing is about words -- not 
  1059.     fonts or bit-maps or graphical layout.  Writers need the computer 
  1060.     equivalent of a typewriter -- not a print-shop."
  1061.               - J.W., registered VDE user (August 1995)
  1062.  
  1063.      In Spring 1992, VDE appeared in "Dvorak's Top 30", a boxed collection of 
  1064.  shareware applications published by Interplay Productions, available in 
  1065.  retail stores.  It is also included on-disk with the book "Dvorak's Inside 
  1066.  Track to DOS and PC Performance" by John Dvorak and Nick Anis, published by 
  1067.  Osborne/McGraw-Hill.
  1068.  
  1069.  
  1070.                                ABOUT THE AUTHOR
  1071.  
  1072.      Eric Meyer has also written the shareware ZIP serial file transfer 
  1073.  program and Meyer File/Directory (MFD) utilities, as well as a number of free 
  1074.  utilities for IBM PC compatibles.  He holds an A.B. in physics and a Ph.D. in 
  1075.  history and philosophy of science, and has taught at the Universities of 
  1076.  Indiana, Oklahoma, and Colorado.  A computer enthusiast since high school, he 
  1077.  has programmed in languages from APL to Z80; lately he has been working 
  1078.  mostly in 8086 assembler.  In a period of escalating software complexity and 
  1079.  prices, he still believes that useful, inexpensive software should remain 
  1080.  available to computer users worldwide.
  1081.  
  1082.  ===============================[end VDE.REF]=================================
  1083.