home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / wp / vde16.zip / VINST.REF < prev    next >
Text File  |  1990-12-12  |  35KB  |  614 lines
  1.  
  2.  
  3.                                   VINST.REF
  4.                                   ---------
  5.                   Instructions for VDE Installation Utility:
  6.                            VINST 1.60 (12 Dec 1990)
  7.  
  8.                              (c)1987-90, E. Meyer
  9.  
  10.  
  11.  
  12. ================================  CONTENTS  ==================================
  13.  
  14.  
  15.  1. RUNNING VINST.  What VINST is, and how to use it.
  16.  
  17.  2. INSTALLATION.  Installing for different computer hardware:
  18.                    Screen size; IBM compatibility; Colors; etc.
  19.  
  20.  3. MENUBAR MODE.  Choice of operating mode; customization of User menu bar.
  21.  
  22.  4. USER OPTIONS.  Customization of many initial VDE settings.
  23.  
  24.  5. PRINTER INSTALLATION.  Using printer features: print modes, graphics, etc.
  25.  
  26.  6. DEFAULT MACRO KEYS.  Installing a default set of macro keys.
  27.  
  28.  7. DEFAULT FUNCTION KEYS.  Installing the function keys.
  29.  
  30.  8. GRAPHICS.  Modifying the default set of graphics characters.
  31.  
  32.  9. CHARACTER WIDTHS.  Modifying the default set of character widths.
  33.  
  34. 10. RESTORE DEFAULTS.  Undoing previous modifications.
  35.  
  36.  
  37. ===========================  1. RUNNING VINST  ===============================
  38.  
  39.  
  40.      VINST is a utility that lets you modify your copy of the VDE editor:
  41.               * Installing for use on non-standard computers
  42.               * Selecting or customizing a driver for your printer
  43.               * Configuring settings and options to suit your tastes
  44.  
  45.      VDE comes configured for a standard IBM PC; you will need to make some 
  46. changes before using it on a non-IBM compatible computer, or on an IBM PC with 
  47. an old-style CGA graphics card (see INSTALLATION).  You will want to choose 
  48. the correct driver for your printer, and may eventually want to make some 
  49. small modifications to it.  And, once you start editing with VDE, you will 
  50. probably discover some of its many settings and options that you would like to 
  51. change.  For example, if you intend to use MenuBar mode, you can make this the 
  52. default instead of Command mode.
  53.  
  54.               NOTE: VINST allows VDE to be customized for best 
  55.          performance on a variety of computer hardware.  If you are 
  56.          using equipment (computer, graphics card, printer, etc) 
  57.          which VDE does not work well with, or does not seem to be 
  58.          taking full advantage of, please provide the appropriate 
  59.          technical or programmer's information from your manual so 
  60.          that future versions of VDE can support it.
  61.  
  62.      You should begin using VINST soon; once you have made changes to VDE, the 
  63. initial welcome/copyright messages in VDE and VINST will no longer appear.
  64.      Your copies of the program files will be called VDE.COM and VINST.COM, 
  65. though of course you can rename them (I usually call them V.COM and VI.COM).  
  66. To run VINST simply type:
  67.               C>vinst                 if your copy is still called "VDE.COM"
  68.         or    C>vinst V.COM           if it's called "V.COM" (or whatever).
  69.      Notes: VINST modifies the file VDE.COM; always keep an unmodified 
  70. original copy of all VDE files in case problems arise!  The version numbers of 
  71. VINST and VDE (and any auxiliary key or printer files, see below) must agree.
  72.  
  73.      VINST is fully menu-driven; it will present you with a set of categories 
  74. that corresponds to each section below, starting with Installation; within 
  75. each category, each value is named and displayed, giving you the opportunity 
  76. to change it.  The program is largely self-documenting, and steps you through 
  77. each item individually.  The main menu also offers a "Help" option, which 
  78. displays some of the following information on screen to assist you.
  79.  
  80.      VINST uses several types of data entry for different parameters:
  81.   TEXT - Just type in the character(s).
  82.   LOGICAL - Yes/No.  Just type "Y" or "N".
  83.   DECIMAL - Enter a number from 0 to 255.
  84.   HEX - Enter a two-digit hexadecimal byte value 00-FF.
  85.            (Don't omit lead zeros.)
  86.   BYTE STRING - at the parenthesis, enter the LENGTH of the string (the number 
  87.            of bytes, in hex), then the bytes themselves.  Each byte may be 
  88.            entered either in hex, or by pressing the single quote key "`" 
  89.            followed by the equivalent ASCII character.
  90.                      Example:   (02) 1B 3D     or     (02) `Esc `=
  91.            This format is referred to below as "(#),bytes".
  92.  
  93.      Each time, the current value will display, and then you will be prompted 
  94. for a new one.  (Just press [Ret] to leave the existing setting.)  VINST can't 
  95. always check for illegal values; be careful what you enter!
  96.      At most points in VINST, you can press [Esc] to return immediately to the 
  97. Main Menu, or ^C to abort the program.
  98.  
  99.      For the entry of codes in the Printer Installation, you may find the 
  100. following equivalence table for hexadecimal and character values helpful.
  101.  
  102.  
  103.                                ASCII/HEX TABLE
  104.  
  105.   Dec Hex Char   Dec Hex Char   Dec Hex Char   Dec Hex Char   Dec Hex Char
  106.   ------------------------------------------------------------------------
  107.     0  00  ^@     26  1A  ^Z     54  36   6     80  50   P    106  6A   j
  108.     1  01  ^A     27  1B  ^[     55  37   7     81  51   Q    107  6B   k
  109.     2  02  ^B     28  1C  ^\     56  38   8     82  52   R    108  6C   l
  110.     3  03  ^C     29  1D  ^]     57  39   9     83  53   S    109  6D   m
  111.     4  04  ^D     30  1E  ^^     58  3A   :     84  54   T    110  6E   n
  112.     5  05  ^E     31  1F  ^_     59  3B   ;     85  55   U    111  6F   o
  113.     6  06  ^F     32  20 space   60  3C   <     86  56   V    112  70   p
  114.     7  07  ^G     33  21   !     61  3D   =     87  57   W    113  71   q
  115.     8  08  ^H     34  22   "     62  3E   >     88  58   X    114  72   r
  116.     9  09  ^I     35  23   #     63  3F   ?     89  59   Y    115  73   s
  117.    10  0A  ^J     36  24   $     64  40   @     90  5A   Z    116  74   t
  118.    11  0B  ^K     37  25   %     65  41   A     91  5B   [    117  75   u
  119.    12  0C  ^L     38  26   &     66  42   B     92  5C   \    118  76   v
  120.    13  0D  ^M     39  27   '     67  43   C     93  5D   ]    119  77   w
  121.    14  0E  ^N     40  28   (     68  44   D     94  5E   ^    120  78   x
  122.    15  0F  ^O     41  29   )     69  45   E     95  5F   _    121  79   y
  123.    16  10  ^P     42  2A   *     70  46   F     96  60   `    122  7A   z
  124.    17  11  ^Q     43  2B   +     71  47   G     97  61   a    123  7B   {
  125.    18  12  ^R     44  2C   ,     72  48   H     98  62   b    124  7C   |
  126.    19  13  ^S     45  2D   -     73  49   I     99  63   c    125  7D   }
  127.    20  14  ^T     46  2E   .     74  4A   J    100  64   d    126  7E   ~
  128.    21  15  ^U     47  2F   /     75  4B   K    101  65   e    127  7F  del
  129.    22  16  ^V     48  30   0     76  4C   L    102  66   f    --graphics:--
  130.    23  17  ^W     49  31   1     77  4D   M    103  67   g    128  80
  131.    24  18  ^X     50  32   2     78  4E   N    104  68   h    129  81
  132.    25  19  ^Y     51  33   3     79  4F   O    105  69   i    130  82 ...
  133.   -------------------------------------------------------------------------
  134.  
  135.  
  136. =============================  2. INSTALLATION  ==============================
  137.  
  138.  
  139.      VDE can display text on the screen in two very different ways: on an IBM 
  140. PC it writes directly to video RAM for greater speed; otherwise, it can run on 
  141. any MSDOS computer, using normal character output with ANSI codes for screen 
  142. positioning.  (In addition, the HP Portable Plus is also supported as a "near 
  143. compatible".)
  144.      The IBM PC installation gives the best performance, but requires an IBM 
  145. standard BIOS and video adapter (MDA,CGA,EGA,VGA).  A Hercules (HGC) card 
  146. should also work, as it is MDA compatible.  On an EGA/VGA system the use of 
  147. color mode is recommended, even with a monochrome monitor (MODE CO80 or BW80, 
  148. not MONO).  You can adjust the display colors and cursor to your preferences.
  149.      The non-IBM installation will run on any MSDOS system that supports ANSI 
  150. standard screen control sequences (you must have the statement DEVICE=ANSI.SYS 
  151. or equivalent in your CONFIG.SYS file).  You must also specify the size of 
  152. your screen.  This installation can of course also be used on IBM compatibles, 
  153. in the event that direct video access is undesirable.  It will even work in 
  154. "remote" applications, such as high-speed modem connections, with appropriate 
  155. terminal software on the user's end.
  156.  
  157. IBM PC PARAMETERS:
  158.  
  159. Screen colors - you can select seven different colors: for normal text; block 
  160.     text; place marks and printer codes; soft CRs and hyphens; header; menus 
  161.     and prompts; and header/menu highlights.  Each is specified by an 
  162.     "attribute byte" consisting of two hex digits, for a background and 
  163.     foreground color.  ("17" = "1", blue background, + "7", white text.)  You 
  164.     will see a color palette displayed on screen; the color digits are:
  165.         *0 = BLACK   4 = red      *8 = GREY           C = bright red
  166.          1 = blue    5 = magenta   9 = bright blue    D = bright magenta
  167.          2 = green   6 = brown     A = bright green   E = yellow
  168.          3 = cyan   *7 = WHITE     B = bright cyan   *F = BRIGHT WHITE
  169.     (* - All MDA screens can display black, white, and bright white; in some 
  170.     cases, grey may also be visible.)
  171.          If you have an EGA/VGA display, the palette will include all 256 
  172.     colors (00-FF).  Otherwise, you will see only 128 (00-7F); on MDA/CGA 
  173.     systems, the background attributes 8-F produce blinking video (ugh).
  174. Border colors - you can select two border colors: one to operate within VDE, 
  175.     the other to restore on exit to DOS.  Each is one digit from the list 
  176.     above.  Example: to set a white border within VDE, then return to black on 
  177.     exit, enter "70".  To keep a black border at all times enter "00".
  178.  
  179. Cursor type (D/B/U) - You can choose the cursor type you want during editing.  
  180.     A full "B"lock cursor is more easily visible on the LCD displays of laptop 
  181.     computers; some prefer "U"nderline.  Choose "D"efault to leave it whatever 
  182.     it was before VDE was run.  (In 43/50 line mode, it is always a block.)
  183. Video card for 132 col mode (N/C/A/P) - VDE's AltA command (132 text columns) 
  184.     works only with supported types of video cards.  Choose "C" if you have a 
  185.     VGA card with Chips & Technologies chipset; or "A" for an ATI card (e.g. 
  186.     "EGA Wonder"); or "P" for a Paradise VGA+ card.  If you have none of 
  187.     these, enter "N"; the AltA command will not work.
  188. Problems with CGA snow (Y/N) - Normally No.  Some older CGA cards experience 
  189.     ugly "snow" when programs write directly to video memory.  If this happens 
  190.     to you, select "Y", and VDE will time its video access according to 
  191.     horizontal retrace intervals.  (Display speed will be slightly reduced.)
  192. Ignore enhanced keyboard (Y/N) - Normally No; if you have an enhanced (AT) 
  193.     keyboard VDE will recognize its extra keys.  But some "popup" (TSR) 
  194.     programs may not work properly with this input method.  If you encounter 
  195.     such trouble, set this to Yes.
  196.  
  197. NON-IBM PC PARAMETERS: (automatically set for IBM PC)
  198.  
  199. Clock speed in MHz - Set this decimal value to reflect your CPU clock speed. 
  200.     Common values are 5 (for 4.77), 8, 10, etc.  For faster 286/386 CPUs you 
  201.     may want to set this even higher than the clock speed.  Adjust the value 
  202.     if desired to change the length of delays in VDE.  (At present this 
  203.     affects only the horizontal scroll delay and the "Esc;" macro command.)
  204.  
  205. Terminal initialization - enter an optional string of code (#),bytes to be 
  206.     sent to the screen after clearing the screen, before (re)entering VDE.
  207. Terminal deinitialization - another string of code (#),bytes to be sent to the 
  208.     screen upon exiting from VDE back to DOS.  (Max. lengths: 0F = 15 bytes.)
  209.  
  210. Viewable columns (80-255) - normally 80; set to the column width of your 
  211.     display, if different.
  212. Viewable lines (16-255) - normally 25; if you have a shorter or longer default 
  213.     display (on entry to VDE), enter the length here.
  214. Fast scroll supported (Y/N) - Does your computer respond to the ANSI sequences 
  215.     for insert/delete line (Esc[L,Esc[M)?  If so, set this to "Y" for a faster 
  216.     display; otherwise "N".  (MSDOS ANSI.SYS does not support these codes; 
  217.     some enhanced console drivers, such as NANSI.SYS, do.)
  218.  
  219.  
  220. =============================  3. MENUBAR MODE  ==============================
  221.  
  222.  
  223.      You can choose which operating mode you prefer (MenuBar or Command).  In 
  224. addition, the "User" menu bar can be configured to your taste: to provide 
  225. different keywords for accessing functions, or to add functions that are not 
  226. otherwise available in the existing menu bars.  (The default installation has 
  227. the "Ruler" function (^OT) in place, the other four left blank.)
  228.  
  229. Use MenuBar mode (Y/N) - Do you want to start out in MenuBar mode?  If not, 
  230.     Command mode is used.  See OPERATING MODES.
  231.  
  232. "User" menu bar - If you will be using MenuBar mode, there is a special menu 
  233.     bar provided for you to configure yourself.  The five items on this bar 
  234.     are referred to as {User: item 1-5}.  To define each, you have to provide 
  235.     two things: a "keyword" and the "command" to execute.  (As usual you can 
  236.     just press [Ret] to leave the existing value alone.)
  237.          The keyword appears in the menu bar display, like "Center" or "rUler" 
  238.     in the "Text" menu: it describes what the item will do if selected, and 
  239.     the capital "C" or "U" indicates which key letter must be pressed to 
  240.     select it.  Your keyword can be up to 12 characters long, and must contain 
  241.     exactly ONE capitalized letter (A-Z), which will be the selection key.  
  242.     (Don't use the same key for more than one item.)  An unused entry may be 
  243.     simply left blank, or filled with "---" if you prefer.
  244.          The command determines the function which will be performed when the 
  245.     item is selected from the menu.  (See COMMAND MODE for a full listing.)  
  246.     Each command consists of one or two keystrokes.
  247.          For example: the "sCreen" menu has an item "Window" which gives you a 
  248.     split window on two files, but there is no way to split the window on two 
  249.     locations in the SAME file (as you can with the ^OW command) via existing 
  250.     menu bars.  However, you can easily add this to the User menu bar:
  251.                 For   "{User: item #}"    type    "One-file win"
  252.                 For   "Command:"          type    "^OW"
  253.     You now have a new MenuBar command, {User:One-file win}, which is invoked 
  254.     by pressing [Esc],U,O.
  255.  
  256.  
  257. =============================  4. USER OPTIONS  ==============================
  258.  
  259.  
  260.      You can change a variety of default settings in your copy of VDE, 
  261. according to your taste.  "Default" means the state assumed when VDE is first 
  262. run, or in the absence of any previous user commands.
  263.  
  264. Autosave interval (min.) - Enter your choice for the interval in minutes.  A 
  265.     value of 0 turns this feature off.
  266. Preserve BAKup files (Y/N) - Should a backup file (.BAK) be kept when you save 
  267.     over an existing file?  Choose "Y" to play safe, "N" to save disk space.
  268. Use ^Z as EOF mark (Y/N) - Should an EOF marker (^Z, 1Ah) be considered the 
  269.     end of an ASCII file?  (In modes other than /A,/N it is always treated 
  270.     so.)  MSDOS software should not require this, but some early programs 
  271.     (like their CP/M predecessors) did still use this convention.
  272. Filetypes to exclude - You can specify four filetypes (or type masks, using 
  273.     "?" wildcards) to "hide" from VDE.  (Originally set to ".COM" and ".EXE".)  
  274.     Such files will not show in the ^KF directory display (unless the filetype 
  275.     is specified explicitly), and cannot be edited.  This is a protection 
  276.     feature, for non-text files which can be damaged by trying to edit them.  
  277.     To leave an entry unused, type "...", NOT blanks.
  278. Default file mode - Which of the file modes (A,U,N,W,5,P,X) described in 
  279.     VDE.DOC do you want as the default?  (Originally "A"SCII.)
  280. Auto mode select filetypes - You can specify four filetypes (or type masks, 
  281.     using "?" wildcards) as exceptions to the above default: for example, you 
  282.     could declare all ".ASM" files to default automatically to "N" mode, or 
  283.     all files ".89?" to "W" mode.  To leave an entry unused, type "...".
  284.  
  285. Header on (Y/N) - Should the header (^OQ) start out ON?
  286. Ruler on (Y/N) - Should the ruler (^OT) start out ON?
  287. Insert mode (I/W/O) - Which insert (^V) setting do you want to start out with: 
  288.     Insert, Word insert, or Overstrike (insert off)?
  289. Auto format (Y/N) - Should auto format (^OM) start out ON?
  290. Double spacing (Y/N) - Should double spacing (^OS) start out ON?
  291. Proportional spacing (Y/N) - Should proportional spacing (^OJ) start out ON?
  292. Hard CR display (Y/N) - Should Hard CR display (^OB) start out ON when editing 
  293.     in document modes?
  294. Hyphenation (Y/N) - Should hyphenation (^OH) start out ON in documents?
  295. Case-INsensitive search (Y/N) - Do you want string searches (^QF) to be case 
  296.     insensitive by default?  Normally, No.  (If Yes, specifying the "U"pper- 
  297.     case option while using ^QF will force a case SENSITIVE search.)
  298.  
  299. Left and Right margin columns (1-255) - Default margin settings for Document 
  300.     modes.  Set both to 1 to disable wordwrap and reformatting entirely.
  301. Fixed tab display width (4,8,16) - Hard tabs display at fixed column 
  302.     intervals.  (Normally 8;  4, 8, and 16 are the ONLY legal choices.)
  303. Reserve status line (Y/N) - Do you want VDE to reserve the bottom (normally 
  304.     25th) screen line for use as a status or function key line by other 
  305.     software?  (Normally No, VDE uses this line for text.)
  306. Scroll overlap (0-255) - This is the number of lines of overlap between 
  307.     screens when scrolling: the smaller, the larger the scroll.  Originally 2, 
  308.     for a nearly full scroll.  Must be smaller than your screen size!
  309.  
  310. Beep on error (Y/N) - Do you want a beep when a VDE error message displays?
  311. [BkSp] (^H) deletes to left (Y/N) - Do you want the [BackSpace] (^H) key to 
  312.     delete characters?  Originally No - it just moves the cursor left.
  313. [Del] deletes to right (Y/N) - Do you want the [Delete] key (and ^[BkSp]) to 
  314.     remove the character to the right?  Originally No - it deletes to left.
  315. [Home,End] move left/right on line (Y/N) - Do you want the [Home] and [End] 
  316.     keys to move to the start or end of the line?  Originally No -- they move 
  317.     to the top or bottom of the screen, as in WordStar.
  318.  
  319. Variable tab stops -  Enter up to 8 variable tab stop columns, in ascending 
  320.     order.  Fill unused values with 0.  Originally: 6, 15, 35, 55.
  321.  
  322. Show time as AM/PM (Y/N) - Do you want the time stamp to display in 12 hour 
  323.     format (AM/PM)?  Originally Yes.  If No, the time shows in 24 hour format.  
  324.     (Affects AltT command and ^T in print headers.)
  325. Show date in Euro format (day,mo,yr) (Y/N) - Do you want the date to display 
  326.     in European format?  Originally No, meaning US Format (mo,day,yr).  
  327.     (Affects AltD command and ^D in print headers.)
  328. Show date numerically (Y/N) - Do you want AltD to enter the date numerically 
  329.           (1/15/88)?  Originally No, meaning verbose (January 15, 1988).
  330.  
  331.  
  332. =========================  5. PRINTER INSTALLATION  ==========================
  333.  
  334.  
  335.      Printers vary enormously.  VDE can accomodate two printer drivers, each 
  336. of which can be installed to take advantage of your printer's special 
  337. features.  (Within VDE, the AltV command can be used to select the driver to 
  338. use when printing.)  The defaults installed in VDE are a standard "IBM/Epson 
  339. FX" driver, and a "Simple" driver that can send plain text to any printer, but 
  340. does not support any print controls other than underline and strikeout.  (The 
  341. "Simple" driver is also recommended for Diablo, Juki, and other daisy-wheel or 
  342. typewriter style printers.)  These and several pre-defined drivers for other 
  343. printers can be selected from a menu within VINST.
  344.      Most of the drivers in the VINST menu implement only basic codes for 
  345. print effects like italics and proportional printing; you can, however, modify 
  346. them to your taste, to implement any additional features (fonts, etc) you have 
  347. available.  After choosing a driver from the Menu, return and select "Edit 
  348. current driver".  (To modify the Alternate driver, you must temporarily switch 
  349. it to the selected one.)
  350.      An example of a more fully configured driver is "HPLJ-PacPg 25in1".  This 
  351. can be used with a HP LaserJet printer equipped with a Pacific Page 25-in-1 
  352. cartridge (or any other that provides the fonts indicated below).  It offers 
  353. the following effects:
  354.         CODE  EFFECT
  355. Normal print  Prestige Elite 10 point font, printer margin set to column 6
  356.          ^OJ  Times Roman 10 point proportional font
  357.     ^B,^S,^Y  Boldface, Underline, Italics (all fonts)
  358.        ^T,^V  Superscript, Subscript using 7 point Prestige font
  359.           ^D  switch to Times Roman from Prestige and back
  360.        ^A,^N  switch to Courier 12 point from Prestige and back
  361.           ^Q  Mini Gothic 3.6 point
  362.           ^W  Presentation Bold 18 point
  363.           ^E  Math Elite 10 point
  364.           ^R  return to Prestige from ^Q,^W,^E
  365.  
  366.      If your printer is not on the driver menu, but emulates or resembles one 
  367. that is, start out using that driver, and refine it as needed.  Failing this, 
  368. you can start out with the "Simple" driver and, referring to your printer 
  369. manual, install all the necessary codes yourself.  (In this event, please 
  370. consider sending this information so that a new driver can be added to VINST.)
  371.  
  372.      VINST can use special Printer Driver files to store and retrieve other 
  373. printer definitions.  This makes it easy to save your installation and to pass 
  374. it along to others.  These files should have a type of ".VDP".  When editing 
  375. in VDE, the AltU command may be used to load such a file, putting any number 
  376. of different printer drivers at your disposal.  In VINST, you have the option 
  377. to read in or write out such a file, as well as editing the following values 
  378. individually.
  379.  
  380. Printer ID - Identify the printer you are installing.  (16 characters)
  381. Printer device - Normally "PRN", but you can choose a specific port (like 
  382.     LPT2) if your system has several printers.
  383.  
  384. Extended character set (P/R/N) - Specifies how "extended ASCII" characters 80- 
  385.     FF (graphics or foreign characters) will print.  This depends on the 
  386.     sequence of characters in your printer's fonts.  Your choices are:
  387.        <P>C8 - the standard IBM PC character set.
  388.        <R>OMAN8 - an arrangement common in laser printer fonts.  VDE will 
  389.               translate IBM graphics into Roman8 equivalents where possible.
  390.        <N>one - your printer doesn't print characters in this range at all.  
  391.               VDE will "emulate" IBM graphics, choosing overstruck pairs of 
  392.               standard characters that come close.
  393.     Note that if you are using a customized screen font that agrees with your 
  394.     printer font, whatever it may be, you should choose <P>.
  395. Send LF after CR (Y/N) - Normally Yes.  But with a few printers, which manu- 
  396.     facture their own LineFeed on receiving a Return, you will need No here.
  397.  
  398. Page length (0-255) - Set the number of text lines to print on a page.  (Does 
  399.     not include another 3 lines for a header or page number, if used.)
  400. Top margin (0-255) - Set the number of blank lines to skip as a top margin 
  401.     before printing the number of text lines set above.  Default is 0.
  402. Reserve space for header (Y/N) - Default is Yes; when printing without header 
  403.     or page number, 3 blank lines will be skipped at the top of each page, so 
  404.     that the page layout is the same as when headers are used.
  405. Left margin (0-255) - Set the number of blank columns to skip as a left margin 
  406.     before printing each line.  Useful if you can't set the margin on your 
  407.     printer with an initialization string.  Default is 0.
  408.  
  409. Printer initialization - Enter an optional string of code (#),bytes to send to 
  410.     the printer before each print job, to set default margins, print modes etc.  
  411.     Max. length here and below is 1F = 31 bytes.  (NOTE: the ^KP command has 
  412.     an option to specify additional codes at print time.  See PRINTING.)
  413. Printer deinitialization - Enter another string (#),bytes to send to the 
  414.     printer after each print job, to restore printer to desired state on exit.
  415.  
  416. Proportional printing - Enter the codes needed to set your printer for 
  417.     proportional printing, when ^OJ is engaged, and then to turn this off.  
  418.     Both strings are entered as (#),bytes.
  419.  
  420. Codes for toggles (on/off) - For six of the seven printer toggles (not ^X), 
  421.     you need to tell VDE the codes to send to your printer to produce the 
  422.     desired effect, then turn it off again.  The conventional meanings of the 
  423.     toggles are:      ^B  boldface         ^Y  italic/ribbon color
  424.                       ^D  doublestrike     ^T  superscript
  425.                       ^S  underline        ^V  subscript
  426.     but you can use them for anything you want.  Example: IBM/Epson printers 
  427.     require three-byte sequences to turn continuous underlining on and off:
  428.            Underline on   "Esc - 1"    hex 1B 2D 31   dec 27 45 49
  429.                     off   "Esc - 0"        1B 2D 30       27 45 48
  430.     You would enter the data, starting with the byte count:
  431.            Underline (^PS) on:  (03) 1B 2D 31      <--- entry in hex format
  432.                    ...and off:  (03) `Esc `- `0    <--- or by character
  433.     You should find all necessary codes in your printer manual.
  434.          (NOTES: ^PS will underline text by overstriking with "_" if you do 
  435.     not install codes for it.  ^PX requires no installation at all.)
  436.  
  437. Codes for switches - The same idea, but for switches, which send the same 
  438.     codes every time they are used.  WordStar calls the switches:
  439.           ^Q,W,E,R    user 1,2,3,4         ^A  alternate pitch
  440.                    (no standard meaning)   ^N  normal pitch
  441.     but once again, you can use them for different fonts, printer bin 
  442.     selection, or anything else.
  443.  
  444. ==========================  6. DEFAULT MACRO KEYS  ===========================
  445.  
  446.  
  447.      VDE has a set of 36 macro keys assignable to the commands Esc0...9 and 
  448. EscA...Z.  The default macro definitions are those attached to these commands 
  449. when VDE is first entered.  By changing them you can configure VDE to suit 
  450. your own specialized writing requirements.  (Any keys defined with Esc] while 
  451. using VDE override these defaults.)
  452.  
  453.      VINST can use Key Definition files to store macro key sets.  These should 
  454. have a file type of ".VDK", for ease of identification.  You have the option 
  455. to read in or write out such a file, as well as editing the keys individually.  
  456. (VDK files can also be read or saved with VDE's AltU command, but only VINST 
  457. can display the definitions, or change those in VDE.COM itself.)
  458.      VINST gives you a display much like this:
  459.  
  460.       Macro Keys:  (___ bytes free)      <---- note room available
  461.       [Esc0]<>
  462.       [Esc1]<>                           <---- "<>" flag means undefined key
  463.       [Esc2]<>
  464.       [Esc3]^[;^C                        <---- normal macro definition
  465.       [Esc4]<>
  466.       [Esc5]<N>World Wide Widgets Inc.   <---- "<N>" flag means No-rpt key
  467.       [Esc6]<>
  468.       [Esc7]<Q>^QR^KB^QC^KK^KC           <---- "<Q>" flag means Quiet key
  469.       [Esc8]<>
  470.       [Esc9]<>
  471.  
  472. Just select the number of the key you want to redefine, then type in the new 
  473. definition, much as you would in VDE.  All the same rules apply; there is a 
  474. 128-character length limitation.
  475.      There are several different ranges of keys, which can be displayed and 
  476. modified in a set of 10 at a time (for example, keys 0-9 as above, or A-J).  
  477. You can also copy definitions from one macro or function key to another.
  478.      VDE comes with a macro key file EXAMPLES.VDK, containing several macros 
  479. discussed above under MACROS and MACRO PROGRAMMING:
  480.  
  481.      [Esc0]<Q>^QR^NAltD^OF                         ;put date at top right
  482.      [Esc1]<Q>^QS^S^S^[= [^D^D                     ;move to start of paragraph
  483.      [Esc2]<Q>^[~.1^S^[1^[~.<^D^[= 2^[=^M2         ;move to start of sentence
  484.               ^S^S^[!1^[2^D^[= 2^[=^M2
  485.      [Esc3]<Q>^QS^X^[=^M]^S^V ^V^D^[![             ;soften hard-CR paragraph
  486.  
  487. (Note that "Esc" displays as "^[".)
  488.  
  489.  
  490. =========================  7. DEFAULT FUNCTION KEYS  =========================
  491.  
  492.  
  493.      VDE also has a set of 48 Function Keys (available in command mode only!), 
  494. corresponding to the [F1]...[F12] keys in their normal, Shift-, Ctrl-, and 
  495. Alt- usage (referred to collectively here as F1...F48).  These are identical 
  496. in features and functions to the Macro Keys discussed above.  You can easily 
  497. configure these to match the standard function-key configuration for 
  498. Wordstar's key overlay, to correspond to Word Perfect function-key usage, or 
  499. in any other way you like.
  500.      VINST can use Function Key Definition files to store function-key sets.  
  501. These should have a file type of ".VDF", for ease of identification.  You have 
  502. the option to read in or write out such a file, as well as editing the keys 
  503. individually.  (VDF files can also be read or written with VDE's AltU command, 
  504. but only VINST can display the definitions, or change those in VDE.COM itself.)
  505.      VINST gives you a display much like this:
  506.  
  507.       Function keys, #1-10:  (___ bytes free) <---- note room
  508.       [F1]<>
  509.       [F2]<>                                  <---- "<>" flag means empty
  510.       [F3]<>
  511.       [F4]<Q>^OL5^M^OR60^M                    <---- quiet function key
  512.       [F5]<>
  513.       [F6]<>
  514.       [F7]<>
  515.       [F8]<>
  516.       [F9]<Q>^PS
  517.       [F0]<Q>^PY
  518.  
  519. This works just like the macro keys above, with four sets of 10 keys to define 
  520. (Normal, Shift, Ctrl, Alt), and if you have an enhanced keyboard, a separate 
  521. additional set of 8 keys for the [F11],[F12] keys in each of those states.  In 
  522. addition, you can copy definitions from one macro or function key to another.
  523.      VDE includes sample function-key files which you can read in to define 
  524. the function keys according to the usage of WordStar or Word Perfect.  The 
  525. WordStar default definitions (for version 4 and later) in WS4.VDF are:
  526.  
  527. WS4.VDF      NORMAL      SHIFT        CTRL             ALT
  528.      [F1]     ^J          ^OB          ^QF         Vertical bar graphic
  529.      [F2]     ^U          ^OC          ^QA         Horizontal bar
  530.      [F3]     ^PS                      ^L          Upper-left corner
  531.      [F4]     ^PB                      ^QI         Upper-right corner
  532.      [F5]     ^Y          ^KY          ^OL         Lower-left corner
  533.      [F6]     ^T          ^KU          ^OR         Lower-right corner
  534.      [F7]                 ^KV                      Upper T graphic
  535.      [F8]                 ^KC                      Lower T
  536.      [F9]     ^KS         ^KB          ^QS         Left T
  537.      [F0]     ^KD         ^KK          ^QD         Right T
  538.  
  539. The WP.VDF file will not "turn VDE into Word Perfect", but it does provide a 
  540. considerable degree of keystroke compatibility.  You can assign any other 
  541. functions desired to unused keys (e.g. [F9]):
  542.  
  543. WP.VDF       NORMAL      SHIFT        CTRL             ALT
  544.      [F1]     ^U         Esc?Y        AltR
  545.      [F2]     ^QF                                      ^QA
  546.      [F3]     ^J                      Esc?C            ^OD
  547.      [F4]    ^I^OL^M                  Esc?B           Esc?B
  548.      [F5]     ^KF        AltD                          ^PZ
  549.      [F6]     ^PB         ^OC                          ^OF
  550.      [F7]    Esc?E       Esc?P
  551.      [F8]     ^PS        Esc?T        Esc?S           Esc?S
  552.      [F9]
  553.      [F0]     ^KS        Esc?F        Esc[
  554.  
  555.  
  556. ==========================  8. GRAPHICS CHARACTERS  ==========================
  557.  
  558.  
  559.      VDE allows text to contain a limited, but variable, set of 32 characters 
  560. in the range 80-FFh (on an IBM PC, these are typically graphics or foreign 
  561. characters; see FOREIGN CHARACTERS and GRAPHICS).  In addition, the code ^Z 
  562. (1Ah) must be treated as a graphics character.  VINST lets you specify your 
  563. own default graphics set.  Keep a fair amount of space free in it if you 
  564. frequently work with files with many foreign or graphics characters, in order 
  565. to avoid overflowing the table.
  566.      VINST can use Graphic Definition files to store graphic character sets.  
  567. These should have a file type of ".VDG", for ease of identification.  You have 
  568. the option to read in or write out such a file, as well as editing the keys 
  569. individually.
  570.  
  571.      You will be shown the current definitions, in the same format as the VDE 
  572. Graphics command.  You may select any entry to redefine (A-Z, 1-6) whether 
  573. vacant or not; or, you may clear them all.  In VINST, new graphic codes must 
  574. be entered by hex value, from 80 to FF (and 1A); a full list of graphics 
  575. characters (80-FF) can be displayed for your selection if you need it, by 
  576. typing "?" at the definition prompt.  Simply pressing [Ret] means "free" or 
  577. undefined.
  578.      Note that your Printer Installation determines how graphics will print.
  579.  
  580.  
  581. ===========================  9. CHARACTER WIDTHS  ============================
  582.  
  583.  
  584.      In order to judge the margins correctly when formatting, VDE's 
  585. proportional printing feature (^OJ) needs to know how wide each character is 
  586. when it prints.  The default width table, based on a 10-point Times Roman 
  587. font, will probably work fairly well with any proportional font ("m" is wider 
  588. than "i", and so on).
  589.      If you would like to fine-tune this table to correspond to your favorite 
  590. font instead, use VINST to modify the width table as needed: you can select 
  591. each character, then enter its width (in units of 1/360") as a decimal value.
  592.      The easy way to determine these widths is to print out a file with lines 
  593. of 60 of each character.  (Don't type that out by hand; use the macro command 
  594. to repeat each letter 60 times.)  Measure the length of each line in inches, 
  595. and multiply by 6: that is the character width in 1/360".  The result is 
  596. typically between 16 and 48.)
  597.      Note that this doesn't affect how your printer operates -- just how VDE 
  598. judges the length of each line for reformatting in proportional mode.
  599.  
  600.  
  601. ==========================  10. RESTORE DEFAULTS  ============================
  602.  
  603.  
  604.      This option on the VINST menu is provided in the event that you want to 
  605. undo any changes that you (or someone else) has made to your copy of VDE.  
  606. This should return VDE to the state it was distributed in: installation for 
  607. IBM PC; Command mode; all User Options restored to their original defaults; no 
  608. Macro or Function Keys (except, for convenience, [F1]=help); printer drivers 
  609. IBM/Epson and Simple; original Graphics characters and Character widths.
  610.  
  611.  
  612.  
  613. ===================================[end]======================================
  614.