home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 6 / The_Pier_Shareware_Number_6_(The_Pier_Exchange)_(1995).iso / 049 / vde173a.zip / VINST.REF < prev    next >
Text File  |  1994-08-17  |  42KB  |  702 lines
  1.  
  2.                                   VINST.REF
  3.                                   ---------
  4.                   Instructions for VDE Installation Utility:
  5.                           version 1.73 (17 Aug 1994)
  6.  
  7.                              (c)1987-94, E. Meyer
  8.  
  9.  
  10.  
  11. ================================  CONTENTS  ==================================
  12.  
  13.  
  14.  1. RUNNING VINST.  What VINST is, and how to use it.
  15.  
  16.  2. INSTALLATION.  Installing for different computer hardware, colors, etc.
  17.  
  18.  3. USER MENUBAR.  Customization of User menu bar.
  19.  
  20.  4. OPTIONS.  Customization of many initial VDE settings.
  21.  
  22.  5. PRINTER INSTALLATION.  Using printer features: print modes, graphics, etc.
  23.  
  24.  6. DEFAULT FUNCTION KEYS.  Installing the default function keys.
  25.  
  26.  7. GRAPHICS.  Modifying the default set of graphics characters.
  27.  
  28.  8. CHARACTER WIDTHS.  Modifying the default set of character widths.
  29.  
  30.  9. RESTORE DEFAULTS.  Undoing previous modifications.
  31.  
  32.  
  33. ===========================  1. RUNNING VINST  ===============================
  34.  
  35.  
  36.      VINST is a utility that lets you modify your copy of the VDE editor:
  37.               * Installing for use on non-standard computers
  38.               * Selecting or customizing a driver for your printer
  39.               * Configuring settings and options to suit your tastes
  40.  
  41.      VDE comes configured for a standard IBM PC; you will need to make some 
  42. changes before using it on a non-PC-compatible computer, or a graphics board 
  43. (like old IBM CGAs) that experiences "snow" (see INSTALLATION).  You will want 
  44. to choose the correct driver for your printer, and may eventually want to make 
  45. some small modifications to it.  And, once you start editing with VDE, you 
  46. will probably discover some of its many settings and options that you would 
  47. like to change.
  48.  
  49.               NOTE: VINST allows VDE to be customized for best 
  50.          performance on a variety of computer hardware.  If you are 
  51.          using equipment (computer, graphics board, printer, etc) 
  52.          which VDE does not work well with, or does not seem to be 
  53.          taking full advantage of, please provide the appropriate 
  54.          technical or programmer's information from your user's 
  55.          manual so that future versions of VDE can support it.
  56.  
  57.      You should begin using VINST soon; once you have made changes to VDE, the 
  58. initial welcome/copyright messages in VDE and VINST will no longer appear.
  59.      Your copies of the program files will be called VDE.EXE and VINST.COM, 
  60. though of course you can rename them (I usually call them V.EXE and VI.COM).  
  61. To run VINST simply type:
  62.               C>vinst                 if your copy is still called "VDE.EXE"
  63.         or    C>vinst V.EXE           if it's called "V.EXE" (or whatever).
  64.  
  65.      Any changes you make while running VINST -- choosing different options, 
  66. reading in data files, etc -- are in memory only.  You can choose "Quit" from 
  67. the main menu and VDE.EXE will remain unchanged.  Only when you choose "Save" 
  68. (or "Restore defaults") does VINST modify the file VDE.EXE.
  69.  
  70.      VINST can also read and write various "auxiliary data files" (type .VDx), 
  71. for user options, macro definitions, graphics, and printer support; see DATA 
  72. FILES.  VDE's ability to load such files allows modifications to these 
  73. features during editing.  In addition, they can make updating to a new version 
  74. of VDE easier: just save your old settings to files with the old VINST, and 
  75. then install them in your new copy of VDE with the new VINST.
  76.      Because installation features change with almost every release, the 
  77. version numbers of VINST and VDE must agree.  Auxiliary data files (.VDx) 
  78. change format less often, and VINST can often read files created by other 
  79. recent versions.  In either case, if VINST can't load an older file, you will 
  80. get a "<Version error>" message, and must re-create the file.
  81.      VINST uses the same search technique as VDE to find a data file if you 
  82. don't specify a path yourself: it looks in the "SET VDE" directory, if set, 
  83. then in the directory VINST.COM was run from, then the current DOS directory.  
  84. This order applies equally to writing data files, if no path is specified.
  85.  
  86.      VINST is fully menu-driven; it will present you with a set of categories 
  87. that corresponds to each section below, starting with Installation; within 
  88. each category, each value is named and displayed, giving you the opportunity 
  89. to change it.  The program is largely self-documenting, and steps you through 
  90. each item individually.  The main menu also offers a "Help" option, which 
  91. displays some of the following information on screen to assist you.
  92.  
  93.      VINST uses several types of data entry for different parameters:
  94.   TEXT - Just type in the character(s).
  95.   LOGICAL - Yes/No.  Just type "Y" or "N".
  96.   DECIMAL - Enter a number from 0 to 255.
  97.   HEX - Enter two-digit hexadecimal byte value 00-FF.  (Don't omit lead 0's.)
  98.   BYTE STRING - The value shown in (parentheses) is the length of the current 
  99.                string.  Enter a new series of byte values.  Each may be 
  100.                entered either in HEX, as above, or by pressing the single 
  101.                quote key ['] followed by the appropriate ASCII character.  You 
  102.                can also press ["] to duplicate the existing value.  (To enter 
  103.                an empty string (00), press ^[Enter] or ^J.)
  104.  
  105.      In each case, the current value will display, and then you will be 
  106. prompted for a new one.  (Just press [Enter] to leave the existing setting.)  
  107. VINST can't always check for illegal values; be careful what you enter!
  108.      At most points in VINST, you can press [Esc] to return immediately to the 
  109. Main Menu, or ^C to abort the program.
  110.  
  111.      For the entry of codes in the Printer Installation, you may find the 
  112. following equivalence table for decimal, hexadecimal, and character values 
  113. helpful.
  114.  
  115.                                  ASCII TABLE
  116.  
  117.   Dec Hex Char    Dec Hex Char    Dec Hex Char   Dec Hex Char   Dec Hex Char
  118.   --------------------------------------------------------------------------
  119.     0  00  ^@ NUL  26  1A  ^Z EOF  54  36   6     80  50   P    106  6A   j
  120.     1  01  ^A      27  1B  ^[ ESC  55  37   7     81  51   Q    107  6B   k
  121.     2  02  ^B      28  1C  ^\      56  38   8     82  52   R    108  6C   l
  122.     3  03  ^C      29  1D  ^]      57  39   9     83  53   S    109  6D   m
  123.     4  04  ^D      30  1E  ^^      58  3A   :     84  54   T    110  6E   n
  124.     5  05  ^E      31  1F  ^_      59  3B   ;     85  55   U    111  6F   o
  125.     6  06  ^F      32  20  SPACE   60  3C   <     86  56   V    112  70   p
  126.     7  07  ^G      33  21   !      61  3D   =     87  57   W    113  71   q
  127.     8  08  ^H BS   34  22   "      62  3E   >     88  58   X    114  72   r
  128.     9  09  ^I TAB  35  23   #      63  3F   ?     89  59   Y    115  73   s
  129.    10  0A  ^J LF   36  24   $      64  40   @     90  5A   Z    116  74   t
  130.    11  0B  ^K      37  25   %      65  41   A     91  5B   [    117  75   u
  131.    12  0C  ^L FF   38  26   &      66  42   B     92  5C   \    118  76   v
  132.    13  0D  ^M CR   39  27   '      67  43   C     93  5D   ]    119  77   w
  133.    14  0E  ^N      40  28   (      68  44   D     94  5E   ^    120  78   x
  134.    15  0F  ^O      41  29   )      69  45   E     95  5F   _    121  79   y
  135.    16  10  ^P      42  2A   *      70  46   F     96  60   `    122  7A   z
  136.    17  11  ^Q      43  2B   +      71  47   G     97  61   a    123  7B   {
  137.    18  12  ^R      44  2C   ,      72  48   H     98  62   b    124  7C   |
  138.    19  13  ^S      45  2D   -      73  49   I     99  63   c    125  7D   }
  139.    20  14  ^T      46  2E   .      74  4A   J    100  64   d    126  7E   ~
  140.    21  15  ^U      47  2F   /      75  4B   K    101  65   e    127  7F  DEL
  141.    22  16  ^V      48  30   0      76  4C   L    102  66   f    --Graphics--
  142.    23  17  ^W      49  31   1      77  4D   M    103  67   g    128  80   Ç
  143.    24  18  ^X      50  32   2      78  4E   N    104  68   h    129  81   ü
  144.    25  19  ^Y      51  33   3      79  4F   O    105  69   i    130  82....
  145.   --------------------------------------------------------------------------
  146.  
  147.  
  148. =============================  2. INSTALLATION  ==============================
  149.  
  150.  
  151.      Because VDE responds to the special keys of a PC keyboard, and writes 
  152. directly to video RAM for greater display speed, its default installation 
  153. requires an IBM PC compatible BIOS and video adapter (MDA, CGA, EGA, or VGA).  
  154. A Hercules (HGC) board should also work, as it is MDA compatible.  On an 
  155. EGA/VGA system the use of color mode is recommended, even with a monochrome 
  156. monitor, to take advantage of a wider variety of "grey shades".
  157.      Special installations are also available for certain "near-compatibles": 
  158. the Hewlett-Packard 95LX/100LX palmtops, the HP Portable Plus, and the Otrona 
  159. 8:16 with IBM video emulation.
  160.      Versions of VDE prior to 1.7 also supported a "Generic" installation 
  161. using standard MSDOS output, that required only compatibility with ANSI 
  162. standard screen control sequences.  This worked on non-PC compatibles, as well 
  163. as on compatibles in situations where direct video access is undesirable -- 
  164. even in "remote" applications, with appropriate terminal software on the 
  165. user's end.  If you require such capabilities, VDE 1.65 remains available.
  166.  
  167.      VINST can use Installation files to store your installation, menubar, and 
  168. user option settings.  These should have a file type of ".VDI", for ease of 
  169. identification.  You have the option to read in or write out such a file, as 
  170. well as proceeding to edit your installation.  VDE can load such files with 
  171. its AltU command; only the computer choice (IBM PC, etc) remains unaffected.
  172.  
  173. IBM PC PARAMETERS:
  174.  
  175. Screen colors - you can select different colors for: normal text; block text; 
  176.     markers and printer codes; soft CRs/hyphens, tabs, and EOF; header; menus 
  177.     and prompts; header/menu highlights; and error messages.  Each is 
  178.     specified by an "attribute byte" consisting of two hex digits, for a 
  179.     background and foreground color.  ("17" = "1", blue background, & "7", 
  180.     white text.)  You will see a color palette displayed on screen.
  181.         *0 = BLACK   4 = red      *8 = GREY           C = bright red
  182.          1 = blue    5 = magenta   9 = bright blue    D = bright magenta
  183.          2 = green   6 = brown     A = bright green   E = yellow
  184.          3 = cyan   *7 = WHITE     B = bright cyan   *F = BRIGHT WHITE
  185.     (* - All MDA screens can display black, white, and bright white; in some 
  186.     cases, grey may also be visible.)
  187.          If you have an EGA/VGA display, the palette will include all 256 
  188.     colors (00-FF).  Otherwise, you will see only 128 (00-7F); on MDA/CGA 
  189.     systems, the background attributes 8-F produce blinking video.  On some 
  190.     portable computers, colors instead produce underlining or grey shades.
  191.          (Note: if your soft CR color has the same background as normal text, 
  192.     VDE will adjust its background to match block text as well.)
  193. Border colors - you can select two border (overscan) colors to frame the text: 
  194.     one to operate within VDE, the other to restore on exit to DOS.  Each is 
  195.     one digit from the list above.  Example: to set a white border within VDE, 
  196.     then return to black on exit, enter "70".  To keep a black border at all 
  197.     times enter "00".  (Note: no border is visible under DESQview or 
  198.     UltraVision.)
  199.  
  200. Cursor type (D/B/U) - You can choose the cursor type you want during editing.  
  201.     A full "B"lock cursor is more easily visible on the LCD displays of laptop 
  202.     computers; some prefer "U"nderline.  Choose "D"efault to leave it whatever 
  203.     it was before VDE was run.  (In 40+ line mode, it is always a block.)
  204. Screen size (A-G,blank) - You can choose your default screen size; normally 
  205.     this is BLANK, " ", meaning whatever is in effect when VDE is loaded.  The 
  206.     letter codes have the same meaning as at the AltE command prompt:  "F", 
  207.     for example, automatically changes to 50 lines on entering VDE.
  208.             On VGA: A...G = 20,25,28,33,40,50,57 lines
  209.                 (UltraVision: B,D,F,G = 25,36,50,63)
  210.             On EGA: A...F = 17,25,29,35,43,50    lines
  211.                 (UltraVision: B,D,E,G = 25,34,43,60)
  212. Video board for 132 col mode (N...) - VDE's AltA command (132 column toggle) 
  213.     works only with supported types of video boards.  Choose:
  214.             "A" for ATI (e.g. "EGA Wonder, VGA Wonder")
  215.             "C" for Cardinal VGA (Chips & Tech chipset)
  216.             "D" for Diamond Speedstar Pro SVGA
  217.             "P" for Paradise VGA+
  218.             "T" for Trident SVGA
  219.             "S" for some other SVGA types
  220.          If your video board is not among the brands named, you can experiment 
  221.     to see whether any of these will work; if not, enter "N" for none -- AltA 
  222.     will work only if you are running UltraVision.
  223.          NOTE:  Users of older Paradise VGA boards may need to keep the border 
  224.     color black, to avoid a bug affecting 132 column display colors.
  225. Need to avoid "snow" (Y/N) - Normally No.  Some video boards (like old IBM 
  226.     CGAs) experience ugly "snow" or noise when programs write directly to 
  227.     video memory.  If this happens to you, select "Y", and VDE will time its 
  228.     video access according to horizontal retrace intervals.  (Display speed 
  229.     will be somewhat reduced.)
  230.  
  231. Keyboard type (A/X/T) - Normally "A" for AT; actually, VDE detects whether you 
  232.     have an AT (enhanced) or XT keyboard, and uses the appropriate input.  But 
  233.     some "popup" (TSR) programs do not work properly with AT keyboard input; 
  234.     if you have this problem, set this to "X" for XT.  (F11, F12, and a few 
  235.     other key combinations will not work.)  Finally, the Tandy 1000 uses 
  236.     different scan codes for its F11-F12 keys; set to "T" if you have a Tandy.
  237.  
  238. SPECIAL INSTALLATIONS:
  239.  
  240.      HEWLETT-PACKARD 95/100LX PALMTOP - You could run VDE on these palmtops as 
  241. IBM compatibles, but in screen sizes other than 80x25 you would have to use 
  242. the HP scroll feature to see different parts of the screen.  Choosing one of 
  243. these installations provides direct support for 40x16 and 64x18 modes.
  244.      You can pick the "colors" of your choice in these installations; other 
  245. parameters are preset.
  246.      Note that on LX's, the grey [+],[-] keys will not scroll the screen; on 
  247. the 95LX, the ^[BkSp] command will not work, and the shifted cursor keys 
  248. cannot be used to mark a block.  The 100LX's "zoom" feature should not be used 
  249. while editing.  For extended characters (ASCII 80-FF) to print properly, your 
  250. printer driver must be set to <R>oman8 font, or you must select code page 437 
  251. in the 100LX Setup.  See also remarks on narrow screens under SCREEN SIZE.
  252.      Users whose primary need is for an editor for the LX palmtops should also 
  253. consider the customized "fastWRITE" version of VDE, marketed by ACE 
  254. Technologies.  See VDE.UPD for details.
  255.  
  256.      HEWLETT-PACKARD PORTABLE PLUS - all models.  Do not try this installation 
  257. on any other computer.  All parameters are preset.
  258.  
  259.      OTRONA 8:16 - Only the Otrona model with IBM video emulation will work; 
  260. the standard model 8:16 is not supported.  This installation may also work on 
  261. other older "near-compatibles" with an 80x25 display that lack EGA/VGA BIOS 
  262. compatibility.  All parameters are preset.
  263.  
  264.  
  265. =============================  3. USER MENUBAR  ==============================
  266.  
  267.  
  268.      The "User" menu bar can be configured to your taste: to provide different 
  269. keywords for accessing functions, or to add functions that are not available 
  270. in the existing menu bars.
  271.      VINST can use Installation files to store your installation, menubar, and 
  272. user option settings.  These should have a file type of ".VDI", for ease of 
  273. identification.  VDE can load such files with its AltU command.  VINST can 
  274. access them under the INSTALLATION menu choice.
  275.  
  276. "User" menu bar - The five items on this bar are referred to as {User: item 1- 
  277.     5}.  To define each, you have to provide two things: a "keyword" and the 
  278.     "command" to execute.  (As usual you can just press [Enter] to leave the 
  279.     existing value alone.)
  280.          The keyword appears in the menu bar display, like "Driver" or 
  281.     "preView" in the "Print" menu: it describes what the item will do if 
  282.     selected, and the capital "D" or "V" indicates which key letter must be 
  283.     pressed to select it.  Your keyword can be up to 12 characters long, and 
  284.     must contain exactly ONE capitalized letter (A-Z), which will be the 
  285.     selection key.  (Each of the five entries must use a different key.)  An 
  286.     unused entry may be simply left blank, or filled with "---" if you prefer.
  287.          The command determines the function which will be performed when the 
  288.     item is selected from the menu.  (See COMMAND SUMMARY for a full listing.)  
  289.     Each command consists of one or two keystrokes.  The default user menu 
  290.     includes the sample entry "Autosave", which invokes the command ^KA if you 
  291.     press "A".
  292.          Example: The command ^OE, which makes the cursor line the top line on 
  293.     the screen, is not accessible via existing menu bars.  However, you can 
  294.     easily add this to the User menu bar:
  295.                 For   "{User: item #}"    type    "  make Top  "
  296.                 For   "Command:"          type    "^OE"
  297.     You now have a new MenuBar command, {User:make Top}, which is invoked by 
  298.     pressing ^[Esc],U,T.
  299.  
  300.  
  301. ===============================  4. OPTIONS  =================================
  302.  
  303.  
  304.      You can change a variety of default settings in your copy of VDE, 
  305. according to your taste.  "Default" means the state assumed when VDE is first 
  306. run, or in the absence of any previous user commands.
  307.      VINST can use Installation files to store your installation, menubar, and 
  308. user option settings.  These should have a file type of ".VDI", for ease of 
  309. identification.  VDE can load such files with its AltU command.  VINST can 
  310. access them under the INSTALLATION menu choice.  (Note that the file format 
  311. and screen settings below are defaults, and loading a .VDI file will not 
  312. change settings for files already being edited.)
  313.  
  314. Prompt for filename if none (Y/N) - When you invoke VDE with no filename, 
  315.     should it prompt for one?  Normally No, you get an "untitled" work area.
  316. Autosave interval (min.) - Enter your choice for the interval in minutes.  A 
  317.     value of 0 turns this feature off.
  318. Preserve BAKup files (Y/N) - Should a backup file (.BAK) be kept when you save 
  319.     over an existing file?  Choose "Y" to play safe, "N" to save disk space.
  320. Use ^Z as EOF mark (Y/N) - Should an EOF marker (^Z, 1Ah) be used to mark the 
  321.     end of an ASCII file (modes /A,U,N,C)?  MSDOS software should not require 
  322.     this, but some early programs (like their CP/M predecessors) did still use 
  323.     this convention.
  324. Filetypes to exclude - You can specify six filetypes (or type masks, using "?" 
  325.     wildcards) to "hide" from VDE.  (Originally set to ".COM" and ".EXE".)  
  326.     Such files will not show in the ^KF directory display (unless the filetype 
  327.     is specified explicitly), and cannot be edited.  This is a protection 
  328.     feature, for non-text files which can be damaged by trying to edit them.  
  329.     To leave an entry unused, type "...", NOT blanks.
  330. Default file mode - Which of the file modes (D,A,U,N,C,W,S,P,F,X,M) described 
  331.     in VDE.DOC do you want as the default?  (Originally "D"ocument.)
  332. Auto mode select filetypes - You can specify six filetypes (or type masks, 
  333.     using "?" wildcards) as exceptions to the above default: for example, you 
  334.     could declare all ".ASM" files to default automatically to "N" mode, or 
  335.     all files ".89?" to "W" mode.  To leave an entry unused, type "...".
  336.  
  337. Header on (Y/N) - Should the header (^OQ) start out ON?
  338. Ruler on (Y/N) - Should the ruler (^OT) start out ON?
  339. Function key labels on (Y/N) - Should the key labels (^OU) start out ON?
  340. Insert mode (I/W/O) - Which insert (^V) setting do you want to start out with: 
  341.     Insert, Word insert, or Overstrike (insert off)?
  342. Auto format (Y/N) - Should auto format (^OM) start out ON?
  343. Right justify (Y/N) - Should right justification (^OJ) start out ON?
  344. Double spacing (Y/N) - Should double spacing (^OS) start out ON?
  345. Proportional spacing (Y/N) - Should proportional spacing (^OK) start out ON?
  346. Hard CR/tab display (Y/N) - Should Hard CR/tab display (^OB) start out ON when 
  347.     editing in document modes?
  348. Hyphenation (Y/N) - Should hyphenation (^OH) start out ON in documents?
  349. Ignore case in searches (Y/N) - Do you want string searches (^QF) to be case 
  350.     INsensitive by default?  If Yes, specifying the "I"gnore-case option while 
  351.     using ^QF will force a case SENSITIVE search.)
  352.  
  353. Left and Right margin columns (1-255) - Default margin settings for Document 
  354.     modes.  Set both to 1 to disable wordwrap and reformatting entirely.
  355. Fixed tab display width (4,8,16) - Hard tabs display at fixed column 
  356.     intervals.  (Normally 8;  4, 8, and 16 are the ONLY legal choices.)
  357. Scroll overlap (0-255) - This is the number of lines of overlap between 
  358.     screens when scrolling: the smaller, the larger the scroll.  Originally 2, 
  359.     for a nearly full scroll.  Must be smaller than your screen size!
  360. Align new page with screen (Y/N) - When you use the page find commands ^QI, 
  361.     ^QL, ^QN, do you want the first line at the top of the screen?  Originally 
  362.     No, its position varies, as in an ordinary Find.
  363. Beep on error (Y/N) - Do you want a beep when a VDE error message displays?
  364.  
  365. Cut (AltC) deletes block (Y/N) - Should the block Cut command (AltC) delete 
  366.     the block after copying it into the cut buffer?
  367. [BkSp] destructive (Y/N) - Should the [BackSpace] key delete characters?  
  368.     Originally Yes; if No, it just moves the cursor left.
  369. [Del] deletes at cursor (Y/N) - Should the [Del] key delete the cursor 
  370.     character?  Originally Yes; if No, it deletes the previous one.
  371. [Home,End] go to screen top/bottom (Y/N) - Should [Home,End] move to the top 
  372.     or bottom of the screen?  Originally No, they move to line start or end.
  373.  
  374. Variable tab stops - Enter up to sixteen variable tab stop columns, in 
  375.     ascending order.  Fill unused values with 0.  Originally: 6, 15, 35, 55.
  376.  
  377. Show time as AM/PM (Y/N) - Do you want the time stamp to display in 12 hour 
  378.     format (AM/PM)?  Originally Yes.  If No, the time shows in 24 hour format.  
  379.     (Affects AltT command and ^T in print headers.)
  380. Show date in Euro format (day,mo,yr) (Y/N) - Do you want the date to display 
  381.     in European format?  Originally No, meaning US Format (mo,day,yr).  
  382.     (Affects AltD command and ^D in print headers.)
  383. Show date numerically (Y/N) - Do you want AltD to enter the date numerically 
  384.     (1/15/88)?  Originally No, meaning verbose (January 15, 1988).
  385. Strikeout (^PX) character - Specify the character you want to use for the 
  386.     strikeout effect when printing.  Originally "-"; some prefer "/", etc.
  387.  
  388.  
  389. =========================  5. PRINTER INSTALLATION  ==========================
  390.  
  391.  
  392.      Printers vary enormously.  VDE can accomodate two printer drivers, each 
  393. of which can be installed to take advantage of your printer's special 
  394. features.  (Within VDE, the AltV command can be used to select the driver to 
  395. use when printing.)  You can use these for two different printers, or as two 
  396. different "style sheets" to print in different formats (margins, line spacing, 
  397. etc) on the same printer.  The default installed in VDE is a "SIMPLE" driver 
  398. that can send plain text to any printer, but does not support any print 
  399. controls other than underline and strikeout.  (The "SIMPLE" driver is also 
  400. recommended for many daisy-wheel or typewriter-style printers.)  Many pre- 
  401. defined drivers for other printers can be selected from a menu within VINST.
  402.      One thing you are likely to want to modify is the printer initialization, 
  403. to which you can add codes to modify the default page margins, tab settings, 
  404. etc for your printer.
  405.      Many of the drivers in the VINST menu implement only basic codes for 
  406. print effects like italics and proportional printing; you can, however, modify 
  407. them to your taste, to implement any additional features (fonts, etc) you have 
  408. available.  After choosing a driver from the Menu, return and select "Edit 
  409. current driver".  (To modify the Alternate driver, you must switch it to the 
  410. primary one, then switch it back afterward.)
  411.      An example of a more fully configured driver is "HPLJw/PacPg25in1".  This 
  412. can be used with a Hewlett-Packard LaserJet printer (or compatible) equipped 
  413. with a Pacific Page 25-in-1 cartridge (or any other that provides the fonts 
  414. indicated below).  It offers the following effects:
  415.          CODE  EFFECT
  416.  Normal print  Prestige Elite 10 point font, printer margin set to column 6
  417.           ^OK  Times Roman 10 point proportional font
  418.      ^B,^S,^Y  Boldface, Underline, Italics (all fonts)
  419.         ^T,^V  Superscript, Subscript using 7 point Prestige font
  420.            ^D  switch to proportional Times Roman from Prestige and back
  421.         ^A,^N  switch to Courier 12 point from Prestige and back
  422.            ^Q  Mini Gothic 3.6 point
  423.            ^W  Presentation Bold 18 point
  424.            ^E  Math Elite 10 point
  425.            ^R  return to Prestige from ^Q,^W,^E
  426. The "HP LaserJet 4P" driver is also fully configured, with similar functions 
  427. (using the built-in Courier, Garamond, Gothic, and Albertus fonts).
  428.  
  429.      If your printer is not on the driver menu, but emulates or resembles one 
  430. that is, start out using that driver, and refine it as needed.  Failing this, 
  431. you can start out with the "SIMPLE" driver and, referring to your printer 
  432. manual, install all the necessary codes yourself.  (In this event, please 
  433. consider sending this information so that a new driver can be added to VINST.)  
  434. VDE does not support Adobe Postscript; but you may be able to add the codes to 
  435. switch into your printer manufacturer's native mode, then return to 
  436. Postscript, to your printer initialization and deinitialization (see below).
  437.  
  438.      VINST can use special Printer Driver files to store and retrieve other 
  439. printer definitions.  This makes it easy to save your installation and to pass 
  440. it along to others.  These files should have a type of ".VDP".  When editing 
  441. in VDE, the AltU command may be used to load such a file, putting any number 
  442. of different printer drivers at your disposal.  In VINST, you have the option 
  443. to read in or write out such a file, as well as editing the following values 
  444. individually.
  445.  
  446. Printer ID - Identify the printer you are installing.  (16 characters)
  447. Printer device - Normally "PRN", but you can choose a specific port (like 
  448.     LPT2) if your system has several printers.
  449.  
  450. Extended character set (P/R/N) - Specifies how "extended ASCII" characters 80- 
  451.     FF (graphics or foreign characters) will print.  This depends on the 
  452.     sequence of characters in your printer's fonts.  Your choices are:
  453.        <P>C8 - the standard IBM PC character set.  No translation in printing.
  454.        <R>OMAN8 - an arrangement common in laser printer fonts.  VDE will 
  455.               translate PC graphics into Roman8 equivalents where possible.
  456.        <N>one - your printer doesn't print characters in this range at all.  
  457.               VDE will "emulate" PC graphics, choosing overstruck pairs of 
  458.               standard characters that come close.
  459.     Note that if you are using a non-standard screen font that agrees with 
  460.     your printer font, whatever it may be, you should choose "P".
  461. Printer type (H/F/L/O) - Enter "H" for HP LaserJet or DeskJet compatible, "F" 
  462.     for Epson FX (9 pin) or compatible, "L" for Epson LQ (24 pin) or compat- 
  463.     ible, or "O" for any other type.
  464. Send LF after CR (Y/N) - Normally Yes.  But with a few printers, which manu- 
  465.     facture their own LineFeed on receiving a Return, you will need No here.
  466.  
  467. Page length (0-255) - The number of text lines to print on a page.  An 11" 
  468.     sheet gives 66 lines of print at a standard spacing of 6 lpi; most 
  469.     printers can actually print about 60-64 lines.  Be sure also to leave room 
  470.     on the page for the following margin settings, if used.  Default is 58.
  471. Top margin (0-255) - The number of blank lines to skip as a top margin before 
  472.     printing the number of text lines set above.  Default is 0.
  473. Top margin if header used (0-255) - The number of lines to skip instead as a 
  474.     top margin before printing the header, if one is used.  Default is 0.
  475. Lines to skip between header and text (0-255) - Blank lines to leave between 
  476.     header and text.  Also determines lines between text and bottom page 
  477.     number, if used.  Default is 2.
  478. Left margin (0-255) - Set the number of blank columns to skip as a left 
  479.     margin, shifting the entire printout to the right.  Default is 8.  (Note: 
  480.     most printers offer an Esc command to set an internal left margin in dot- 
  481.     columns or inches.  If you need a left margin, you can get more consistent 
  482.     and reliable results by including such a command in your initialization 
  483.     string.  If you can't do this, install a value here and VDE will print 
  484.     spaces for a margin.)
  485.  
  486.      The following menu choices allow you to modify the codes that are part of 
  487. your printer driver.  For all of these codes, the existing values (if any) 
  488. will display, first in more or less readable "character" form and then as a 
  489. string of hex digits, preceded by the length in parentheses.  Press [Return] 
  490. alone to leave the codes unchanged, or ^[Return] to delete them entirely, or 
  491. enter new codes -- either in hexadecimal, or as character values by pressing 
  492. the single quote ['], then a character.  Note that the double quote ["] will 
  493. duplicate the existing code.  When finished, press [Return].
  494.      Any one string can be up to 127 bytes long; the total available for use 
  495. is about 450 bytes.
  496.  
  497. [A]-Initialization, etc - This is an optional string of code to send to the 
  498.     printer before each print job, usually to set default margins, line 
  499.     spacing, font, etc.  (NOTE: the ^KP command has an option to specify 
  500.     additional codes at print time.  See PRINTING.)
  501. [B]-Deinitialization - This is another string to send after each print job, to 
  502.     restore the printer to the desired state on exit.
  503. [C]-Envelope setup - This string will be sent in place of the usual 
  504.     initialization when you address an envelope with ^KPA (see ENVELOPES).  
  505.     For many printers you will need no special codes here; or, you might find 
  506.     that a linefeed or two, perhaps also a left margin command, is useful to 
  507.     position the print properly on the envelope.  You should use a pica font 
  508.     (fixed, 10 cpi).
  509.          The setup codes in VINST's HP LaserJet drivers assume that you will 
  510.     insert the envelope end-on in the default paper tray, and consequently 
  511.     they use a landscape font (Courier 12).  They do not specify "envelope 
  512.     size" forms, so there is no need to change the form size on the printer 
  513.     panel.  If you are feeding envelopes from a different paper tray, you will 
  514.     have to add codes here to specify this tray.
  515.          You must also be sure that your deinitialization contains any codes 
  516.     necessary to return to the default tray, orientation, etc. after 
  517.     addressing an envelope.  Printing envelopes can be complicated; see your 
  518.     printer manual.
  519. [D]-Proportional (^OK) - Enter the codes needed to produce a proportionally 
  520.     spaced font when you print while in proportional mode (^OK).  Like the 
  521.     "toggles" below, you also need to supply a second string to turn this off 
  522.     and return to fixed spacing afterwards.
  523.  
  524. TOGGLES: [E]-Bold, etc - For six of the seven printer toggles (not ^X), you 
  525.     need to tell VDE the codes to send to your printer to produce the desired 
  526.     effect, then turn it off again.  The conventional meanings of the toggles 
  527.     are:      ^B  boldface         ^Y  italic/ribbon color
  528.               ^D  doublestrike     ^T  superscript
  529.               ^S  underline        ^V  subscript
  530.     but you can use them for anything you want.  Example: Epson FX printers 
  531.     require three-byte sequences to turn continuous underlining on and off:
  532.            Underline on   "Esc - 1"    hex 1B 2D 31   decimal 27 45 49
  533.                     off   "Esc - 0"        1B 2D 30           27 45 48
  534.     You can enter the data in hex or characters, or any mixture thereof:
  535.                    [G]...    :  1B 2D 31      <--- entry in hex format
  536.                    ...and off:  'Esc '- '0    <--- or by characters
  537.     You should find all necessary codes in your printer manual.
  538.          (NOTES: ^PS will underline text by overstriking with "_" if you do 
  539.     not install codes for it.  ^PX requires no installation, but see USER 
  540.     OPTIONS to specify the strikeout character.)
  541.  
  542. SWITCHES: [K]-User1, etc - The same idea, but for switches, which send the 
  543.     same codes every time they are used.  WordStar calls the switches:
  544.           ^Q,W,E,R    "user 1,2,3,4"   (no standard meaning)
  545.           ^A,N        alternate, normal pitch
  546.     But once again, you can use them for different fonts, printer bin 
  547.     selection, or anything else you like.
  548.  
  549.  
  550. =========================  6. DEFAULT FUNCTION KEYS  =========================
  551.  
  552.  
  553.      VDE has a set of 48 Function Keys, invoked by the [F1]...[F12] keys in 
  554. their normal, Shift-, Ctrl-, and Alt- usage, which can have macro definitions 
  555. assigned to them.  The default definitions are those that will be active when 
  556. you first enter VDE.  By changing these, you can easily customize VDE for an 
  557. approximate match to the standard function-key configuration for Wordstar or 
  558. Word Perfect, or to suit any special requirements of your own.  (Any keys 
  559. defined with Esc[ while using VDE will override these defaults.)
  560.  
  561.      VINST can use Function Key Definition files to store function-key sets.  
  562. These should have a file type of ".VDF".  You have the option to read in or 
  563. write out such a file, as well as editing the keys individually.  (VDF files 
  564. can also be read or written with VDE's AltU command, but only VINST can 
  565. display the definitions, or change those in VDE.EXE itself.)
  566.      VINST gives you a display much like this:
  567.  
  568.       Function keys:  (___ bytes free)  <---- note room available
  569.       F1:<>
  570.       F2:<>                             <---- "<>" means undefined
  571.       F3:<>
  572.       F4:< Scan  >[Esc];^C              <---- " Scan  " is key's label
  573.       F5:<>
  574.       F6:<QN>^OL5^M^OR60^M              <---- Quiet, No-repeat key, no label
  575.       F7:<>
  576.       F8:<EscU><Undrln ><N>^PS          <---- "EscU" also invokes this key
  577.       F9:<EscB>< Bold  ><N>^PB
  578.       F10:<QN>^QS[!v]                   <---- "[!v]" means Shift-Downarrow
  579.  
  580. You can select one of several ranges of definitions to display: Normal, 
  581. Shift(!), Ctrl(^), Alt(@), and if you have an Enhanced keyboard, a separate 
  582. additional set of 8 keys for the [F11],[F12] keys in each of those states.  Or 
  583. at any time you can press the [F]-key you want to define, and type in the new 
  584. definition.  While doing this, ^[Break] aborts; ^P must be used to enter 
  585. [Enter] (^M), [BkSp] (^H), or ^P itself.
  586.      The Esc key and special PC keys like PgUp will display by name within 
  587. brackets: [Esc], [>], [PgUp].  Shift, Ctrl, and Alt combinations are indicated 
  588. by "!", "^", and "@", as in "[!v]", "^J", "@D".  (Many of these keys merely 
  589. display as "*" at VDE's macro prompt, but VINST identifies them more clearly.)
  590.      To keep the existing definition, Esc key, label, or Q/N option, just 
  591. press [Enter].  To blank (remove) a definition, press ^[Enter].  To blank an 
  592. existing Esc key, label, or Q/N option, use [Space].
  593.      Any definition can be up to 253 bytes long; the total space available is 
  594. about 2000 bytes.
  595.  
  596.      By default, VDE comes with [F1] installed for command help (^J), [F10] 
  597. for the MenuBar (^[Esc]), and other definitions blank.  Sample function-key 
  598. files are also included; EXAMPLES.VDF contains several macros discussed in 
  599. VDE.REF:
  600.  
  601.    F1:<QN>^QR^N@D^OF                            ;put date at top right
  602.    F2:<QN>^QS^S^S[Esc]= [^D^D                   ;move to start of paragraph
  603.    F3:<QN>[Esc]~.1^S[Esc]1[Esc]~.<^D[Esc]= 2[Esc]=^M2   ;move to start
  604.             ^S^S[Esc]!1[Esc]2^D[Esc]= 2[Esc]=^M2        ;  of sentence
  605.    F4:<QN>^QS^X[Esc]= ][Esc]=^M]^S ^D[Esc]![    ;soften hard-CR paragraph
  606.  
  607. The files WS4.VDF and WP.VDF can be used to define the function keys according 
  608. to the usage of WordStar or Word Perfect.  The WordStar 4 default definitions 
  609. in WS4.VDF are:
  610.  
  611. WS4.VDF      NORMAL      SHIFT        CTRL             ALT
  612.      F1       ^J          ^OB          ^QF         Vertical bar graphic
  613.      F2       ^U          ^OC          ^QA         Horizontal bar
  614.      F3       ^PS                      ^L          Upper-left corner
  615.      F4       ^PB                      ^QI         Upper-right
  616.      F5       ^Y          ^KY          ^OL         Lower-left
  617.      F6       ^T          ^KH          ^OR         Lower-right
  618.      F7                   ^KV                      Upper T graphic
  619.      F8                   ^KC                      Lower T
  620.      F9       ^KS         ^KB          ^QS         Left T
  621.      F10      ^KD         ^KK          ^QD         Right T
  622.  
  623. The WP.VDF file will not "turn VDE into Word Perfect", but it does provide a 
  624. considerable degree of keystroke compatibility.  You can assign any other 
  625. functions desired to unused keys:
  626.  
  627. WP.VDF       NORMAL      SHIFT        CTRL             ALT
  628.      F1       ^U        [^Esc]        AltR
  629.      F2       ^QF         ^QF         AltJ             ^QA
  630.      F3       ^J                     [^Esc]V           ^OD
  631.      F4       ^OG                    [^Esc]B         [^Esc]B
  632.      F5       ^KF        AltD
  633.      F6       ^PB         ^OC                          ^OF
  634.      F7     [^Esc]F       ^KP
  635.      F8       ^PS       [^Esc]S      [^Esc]T         [^Esc]S
  636.      F9
  637.      F10      ^KS       [^Esc]F        Esc"
  638.  
  639.  
  640. ==========================  7. GRAPHICS CHARACTERS  ==========================
  641.  
  642.  
  643.      VDE allows text to contain a limited, but variable, set of 32 characters 
  644. in the range 80-FFh (see FOREIGN CHARACTERS and GRAPHICS).  In addition, the 
  645. code ^Z (1Ah) must be treated as a graphics character.  VINST lets you specify 
  646. your own default graphics set.
  647.      VINST can use Graphic Definition files to store graphic character sets.  
  648. These should have a file type of ".VDG", for ease of identification.  You have 
  649. the option to read in or write out such a file, as well as editing the keys 
  650. individually.  VDE can also write such files with its AltU command.
  651.  
  652.      You will be shown the current definitions, in the same format as the VDE 
  653. Graphics command.  You may select any entry to redefine (A-Z, 1-6) whether 
  654. vacant or not; or, you may clear them all.  In VINST, new graphic codes must 
  655. be entered by hex value, from 80 to FF (and 1A); a full list of graphics 
  656. characters (80-FF) can be displayed for your selection if you need it, by 
  657. typing "?" at the definition prompt.  Simply pressing [Enter] means "free" or 
  658. undefined.
  659.      Note that your Printer Installation determines how graphics will print.
  660.  
  661.  
  662. ===========================  8. CHARACTER WIDTHS  ============================
  663.  
  664.  
  665.      In order to judge the margins correctly when formatting, VDE's 
  666. proportional printing feature (^OK) needs to know how wide each character is 
  667. when it prints.  The default width table, based on a 10-point Times Roman 
  668. font, will probably work fairly well with any proportional font ("m" is wider 
  669. than "i", and so on).
  670.      If you would like to fine-tune this table to correspond to your favorite 
  671. font instead, use VINST to modify the width table as needed: you can select 
  672. each character, then enter its width (in units of 1/360") as a decimal value.
  673.      The easy way to determine these widths is to print out a file with lines 
  674. of 60 of each character.  (Rather than type that out by hand, you can use the 
  675. macro command to repeat each letter 60 times.)  Measure the length of each 
  676. line in inches, and multiply by 6: that is the character width in 1/360".  The 
  677. result is typically between 16 and 48.)
  678.      Note that changing the width table doesn't affect how your printer 
  679. operates -- just how VDE judges the length of each line for reformatting in 
  680. proportional mode.
  681.      VINST can use Character Width files to store width data for the 
  682. proportional font(s) you use.  These should have a file type of ".VDC", for 
  683. ease of identification.  You have the option to read in or write out such a 
  684. file, as well as editing the width table.  VDE can load such files with its 
  685. AltU command.
  686.  
  687.  
  688. ==========================  9. RESTORE DEFAULTS  =============================
  689.  
  690.  
  691.      This option on the VINST menu is provided in the event that you want to 
  692. undo any changes that have been made to your copy of VDE.  This will return 
  693. VDE.EXE to the state it was distributed in: installation for IBM PC; all User 
  694. Options restored to their original defaults; no Function Keys (except, for 
  695. convenience, [F1]=help and [F10]=menu); SIMPLE printer driver; original 
  696. Graphics characters and Character widths.  VINST prompts you to confirm that 
  697. you really want to do this before proceeding.
  698.  
  699.  
  700.  
  701. ===================================[end]======================================
  702.