home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / help / printhlp.lbr / PRINTHLP.DQC / PRINTHLP.DOC
Encoding:
Text File  |  1986-10-31  |  3.0 KB  |  64 lines
  1.  
  2.                        Print Help Files
  3.                        ----------------
  4.  
  5.  
  6. 1.0 Description
  7.  
  8.     This program will print ZCPR V3.0 help files on your printer. It
  9.     will also print help file references within the top level help file
  10.     so if the file you are printing has a line "::NEXTHLP.HLP" in it,
  11.     this file will be opened and printed. It can also be configured to
  12.     use an enhanced print mode of your printer. When so configured
  13.     characters in the help file that display in "standout" mode will also
  14.     "standout" in the printed output. Additionally, the program paginates
  15.     the file and expands tabs to every 8th column.
  16.  
  17. 2.0 Usage
  18.  
  19.     I wrote this program especially for the SYSLIB documentation. Since
  20.     I wanted to refer back to it now and then and didn't want to exit the
  21.     editor to go into HELP to find the information I needed. So I will
  22.     use the SYSLIB file as an example. To print a help file you can type
  23.     either
  24.                 PRINTHLP SYSLIB.HLP <CR>
  25.     or
  26.                 PRINTHLP <cr>
  27.                 Enter Help file to Print : SYSLIB.HLP <CR>
  28.  
  29.     The program will take it from there. Note that after printing all of
  30.     various SYSLIB files it came out to 106 pages so be careful about
  31.     arbitrairily picking top level help files.
  32.  
  33. 3.0 Configuration
  34.  
  35.     The .COM file that is included in the library was compiled with
  36.     Turbo Pascal V2.0 to run in a 32K TPA. It does not use ANY printer
  37.     features. If at all possible, I reccomend you set up the constants
  38.     for your printer and recompile it. If you have a TPA that is less
  39.     than 32K you will have to recompile it anyway. Included in the
  40.     comments is an example of a setup for the Mannesmann Tally MT160.
  41.     The Lst_Init variable puts it into Letter Quality 12 CPI mode, and
  42.     the BF_on and BF_Off do what they are supposed to. Note that escape
  43.     is represented as ^[ (circumflex-left bracket) OUTSIDE of the single
  44.     quote. This is a clue to the Turbo compiler that you really mean
  45.     Control-Bracket (e.g. escape);
  46.  
  47. 4.0 Notes and Bugs
  48.  
  49.     To really get the benefit of the program you should set it up for
  50.     your printer and recompile it. (I know, not everyone has Turbo)
  51.     The page headings look really nice on Help indexed files, but
  52.     are single letters on User Indexed files. (For a good discussion
  53.     on the difference between the two see ZCPR3 : The Manual pp 126-127)
  54.     There really isn't any clean way to hash the user menu for doing the
  55.     "right" thing and connecting the letters to the "right" header.
  56.     If I can think of a way to do it I will add it later. If your printer
  57.     can support underline the program will under line Information Section
  58.     titles for you.
  59.  
  60.     This program was written by Charles McManis, of Sunnyvale CA, and
  61.     is released to the Public Domain. Do with it what you will but don't
  62.     come bitchin to me!
  63.  
  64.