;
                                 LBRHLP.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
LHC.COM        5k (40)   29F0  2.0        Howard Goldstein 9/91    Z3COM11
LHQ.COM        5k (37)   166D  2.0        Howard Goldtsein 9/91    Z3COM11

  1- Syntax  2- Usage  3- Notes  4- Examples of Use                           


   LBRHLP consists of two programs for displaying help files from within LBRs.
LHC.COM is for crunched files and LHQ.COM is for squeezed files.   Both  prog-
rams can also handle uncompressed files in libraries.  Both set the error flag
on errors and reset it when you type Ctrl-C. 

   Original (2/6/88) by Bob Peddicord, derived from HELP53 by R. Conn.
:1
 Syntax   LBRHLP [-dir:][library] [helpfn]

   LBRHLP allows you to specify a different  Library and or help file from the
command line.

   The (-) must be included if Lbr is specified.
   If no dir is given, the [-Library] is used.
:2
 Usage 

   LHC.COM can only be used with  crunched files (sorry no squeezed).  This is
due to trying to keep the code size down.   Uncrunch uses 22k of buffer space,
which leaves  about  25k+  for  files,  so there may be  a few help files that
cannot be used with this program.  
 
   The default LBR name is HLPFILES
   The default DIR name is HELP
   The default DU is A15
   The default filename is MENU

   These can be changed with Zpatch, patch or some other file editor.

   The Locations are:
   DIR - 116h (HELP)
   DU  - 11Eh (disk) 0=A, 1=B etc.
   DU  - 11Fh (user)
   FILE  120h (MENU)
   LBR - 128h (HLPFILES)
:3
 LBRHLP Notes - 1/3 

   a. Vs 2.0 updates (09/16/91, Howard Goldstein):
      - Modified the clear screen routine to print a CRLF if the  CLS function
        is not available, e.g., no TCAP loaded.
      - Made CIN routine public.

   b. Vs 1.9 updates (08/07/91, Howard Goldstein):
      - Fixed a navigation problem.  The  M  command would not  return  to the
        menu if the menu was in a higher level file.  
      - Also added code to cause the program to exit if not  running  under Z-
        System and fixed a potential problem in the unsqueeze routine.

   c. Vs 1.8 updates (02/20/91, Terry Hazen)
      - Added printer-ready test (can be turned off with ZCNFG).

   d. Vs 1.7 updates (02/08/91, Howard Goldstein):
      - Modified file loading routines to  clear  high  bit on all characters.
        This enables LBRHLP to work  correctly  with files created in Wordstar
        Document Mode.
      - Added wheel byte control of print options.
 LBRHLP Notes - 2/4 

      - Made a few changes to the built-in help message.
      - LHC.COM and LHQ.COM can be configured using ZCNFG.

   e. Vs 1.6 updates (08/27/90, Howard Goldstein):
      - Fixed an initialization problem in the uncrunch routine.  This problem
        didn't manifest itself very  often,  but when it  did the results were 
        strange indeed!   This version was linked with the latest test version 
        of the libraries, 4.3.

   f. Vs 1.5 updates (06/20/90, Howard Goldstein):
      - Fixed  a problem that caused the program to search the wrong drive for
        the help library under certain conditions.

   g. Vs 1.4 updates (06/18/90, Howard Goldstein):
      - Improved buffer allocation.   Uncrunched files in libraries may now be
        24k larger than previously.   (If a crunched file is too large for the
        program, put it in the LBR uncrunched.)
      - A colon,  (:),  is no longer dispayed  at the  beginning  of each info
        section in help-inexed files.
      - Terminal de-init routine now called on program exit.
 LBRHLP Notes - 3/4 

      - Print routines improved:  tabs expanded; stack bug fixed.
      - Screen-full logic improved.  Can now handle one more line per screen.
      - Lines per screen and lines per page now obtained from environment.
      - Built-in usage message reflects patchable values for file names, etc.
      - Linked with latest versions of libraries.

   h. Vs 1.3 updates (02/13/88, Bob Peddicord):
      - Fixed  a Ctrlc bug,  still sets  error flag on errors and resets error
        flag when you type ctrlc.

   i. Vs 1.2 updates (02/10/88, Bob Peddicord):
      - Renamed file to LHC (the 'C' stands for crunched files).
      - Fixed a bug that was introduced in ver 1.1
      - Created a file that will unsqueeze library files,  (this is similar to 
        lhelp), but has more versatility.  The name is LHQ.COM (the 'Q' stands 
        for squeezed files).   A new  help file that  handles  crunched files, 
        based on HELP53, will soon be released.

   j. Vs 1.1 updates
     - Now sets error flag on most errors, so different program can be called.
:4
 Examples of Use 

   a. lbrhlp -c15:special syslib

      - we want a different library on c15 and a help file called syslib.  
        The (-) must precede the drive/user or library name, if the default  
        D/U is wanted.

   b. lbrhlp syslib

      - we want the default LBR with the filename syslib.

   c. lbrhlp -helps

      - we are specifing just the library, using the default DU/DIR and 
        default filename.
