home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / r.lbr / RESOLVE.HZP / RESOLVE.HLP
Encoding:
Text File  |  1991-11-18  |  3.6 KB  |  75 lines
  1. ;
  2.                                  RESOLVE.COM                                  
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                3k (20)   6A72  1.4        H. Goldstein 8/89        Z3COM5
  6.  
  7.   1- Usage  2- Notes  3- Examples of Use                                      
  8.  
  9.  
  10.    RESOLVE will resolve  a multiple-command  line passed to  it and place that
  11. command line in  the Multiple-Command Line Buffer in memory.   It will resolve
  12. references to shell variables, registers, and System File names.
  13. :1
  14.  Usage 
  15.  
  16.    RESOLVE recognizes the following flags:
  17.  
  18.    %<text>           Shell variable name.
  19.    $R<n>             Register number.  (n = 0-31)
  20.    $D                Current disk letter.
  21.    $U                Current user number.
  22.    $F<n>             System File name.  (n = 1-4)
  23.    $N<n>             System File name, chars 1-8 only.  (n = 1-4)
  24.    $T<n>             System File name, extension only.  (n = 1-4)
  25.    $|                Substitute multiple-command separator.
  26.  
  27.    The QUIET flag  is  adhered  to;  the program  will not  print its  sign-on
  28. message or error messages if the QUIET flag is set.
  29.  
  30.    If there is no room for the command-line generated,  the ERROR flag will be
  31. set,  and an error message may be printed,  depending upon  the  state  of the 
  32. QUIET flag.  Uninterpretable '$' parameters will also set the error flag. 
  33. :2
  34.  RESOLVE Notes - 1/2 
  35.  
  36.    a. Version 1.4 updates:
  37.       - Removed all checking of quiet flag.  Program banner now only displayed
  38.         when help requested.   Error handler is  now invoked  on  command line 
  39.         overflow.   Error flag now  set on  unresolved shell variables and the 
  40.         leading '%' is no longer  returned in that case.   Editing on register 
  41.         numbers  for the  $r flag has  been  tightened  up.   Code  cleaned up 
  42.         somewhat; now requires version 4 SYSLIB and Z3LIB.  This is now a type
  43.         3 program but I do not recommend linking it  for high-memory execution 
  44.         since the Z3VARLIB routines don't check for top of TPA.
  45.  
  46.    b. Version 1.3 updates:
  47.       - Changed to allow register references up to register 32 (0-31).
  48.  
  49.    c. Version 1.2 updates:
  50.       - Fixed register expansion so it doesn't clobber nesting depth stored in
  51.         B.  Changed program banner to read "1.2"
  52.  RESOLVE Notes - 2/2 
  53.  
  54.    d. Version 1.1 updates:
  55.       - Fixed error in which a shell variable reference in the first character
  56.         of another shell variable wasn't being expanded.  Also changed so that
  57.         a single '$', when followed by an unrecognized flag, is not dropped.
  58. :3
  59.  Examples of Use 
  60.  
  61.    a. HELP:;ROOT:dir14 *.hlp h;ROOT:quiet s;ROOT:getvar ghelp enter   <<
  62.       desired help file by name -;ROOT:resolve hlp %ghelp;ROOT:quiet r;$d$u:
  63.  
  64.       - 'GH' (Get Help) alias defined in Z-NEWS #507 (11 Aug '86):
  65.  
  66.       Log into HELP directory and run DIR14 from ROOT: directory on help files
  67.       with mask to show files of type HLP.   Go into  quiet mode  to  suppress
  68.       utility  headers  and messages.   With files  showing on screen,  prompt
  69.       operator for one to use,  "enter desired help file  by name - ".  GETVAR
  70.       places  operator's response into variable  name 'ghelp' which is located
  71.       automatically in ROOT file SH.VAR.   RESOLVE sets up main command string
  72.       consisting  of HLP  (HELP53.COM renamed) followed  by  expanded  'ghelp'
  73.       variable (operator's  chosen  HLP file).   Reset quiet  flag  for normal
  74.       operation and log back into original directory.  
  75.