ftp.barnyard.co.uk/2015.02.ftp.barnyard.co.uk.tar/ftp.barnyard.co.uk/cpm/walnut-creek-CDROM/BEEHIVE/ZSUS/Z3HELP-3.LBR/L.LBR/LUZ3.HZP/LUZ3.HLP

Text File | 2000-06-30 | 7KB | 239 lines

;

                       Library Utilities for ZCPR3
                       ---------------------------

     I - 
 Introduction 

     G - 
 LGET Tool      -- extracts files from within library files

     H - 
 LHELP Tool     -- processes HLP/HQP files from within LBR files

     L - 
 LLF Tool       -- lists files within library files

     X - 
 LX Tool        -- executes COM files within library files

:I

     INTRODUCTION TO THE ZCPR3 LIBRARY TOOLS

     Thesσá tool≤á assis⌠á thσ ZCPR│ use≥á iεá dealinτá witΦ ì
librarie≤á iεá thσ ZCPR│ environment«á  Followinτ thσá ZCPR│ ì
philosoph∙ oµ ho≈ command≤ shoulΣ bσ constructed¼á thesσ arσ ì
ful∞áá ZCPR│á tool≤á whicΦá takσá advantagσá oµá thσáá ZCPR│ ì
environment and can only run in the ZCPR3 environment.

     Thesσá tool≤ arσ writteε iε Z8░ codσ anΣ wil∞ onl∙á ruε ì
on Z80 or HD64180 microprocessors.

     Onlinσá documentatioεá fo≥ eacΦ too∞á i≤á availablσá b∙ ì
typing the name of the tool followed by two slashes:

          TOOL //

:G


 Command:   LGET 1.0


 Syntax: 
     LGET dir:library dir:afn1,dir:afn2,... o

 Options: 
     U - Unsqueeze squeezed files


 Function: 

     LGE╘á extract≤á thσ specifieΣ file≤ froφ thσá indicateΣ ì
library«á  Iµá thσá file≤á arσá prefixeΣá witΦá ßá director∙ ì
reference¼ the∙ arσ placeΣ iε thσ indicateΣ directories«  Iµ ì
thσá ╒ optioε i≤ presen⌠ anΣ thσ file≤á arσá squeezed¼á the∙ ì
will be unsqueezed during the extraction process.



 Comments: 

     File≤á iε thσ destinatioε director∙ whicΦ havσ thσ samσ ì
names as the source files will be deleted.

     Iµá thσ whee∞ bytσ i≤ no⌠á set¼á destinatioεá director∙ ì
reference≤ wil∞ bσ ignored¼á anΣ al∞ file≤ wil∞ bσ extracteΣ ì
into the current directory.


 Selected Error Messages:  None (Self-Explanatory)



 Examples of Use: 

     LGET a:SYSLIB *.HQP
          -- extract all files of type HQP from the
               file SYSLIB.LBR on disk A, current user

     LGET ROOT:COMMAND B4:L*.COM,B4:L*.HQP U
          -- from the library COMMAND.LBR in the ROOT:
               directory, extract L*.COM and L*.HQP files
               and placed them in the directory B4:;
               thσ squeezeΣ file≤ (L*.HQP⌐ wil∞ bσ
               unsqueezed and stored under their original
               names

:H


 Command:   LHELP 1.0


 Syntax: 
     LHELP topic
          -- get help on the indicated topic in the
               SYSTEM.LBR file
     LHELP topic dir:library
          -- ge⌠ hel≡ oε thσ indicateΣ topiπ iε thσ
               indicated library
     LHELP * library  -or-  LHELP topic *
          -- name of the topic is the same as the name
               of the library


 Options:  None



 Function: 
     LHEL╨á function≤á iε mucΦ thσ samσ manne≥ a≤á thσá HEL╨ ì
commanΣá (versioε 5.│ o≥ later╗á seσá HELPSYS.HLP)«á  Unlikσ ì
HELP¼á LHEL╨ work≤ froφ librar∙ files«á  I⌠ searche≤ fo≥ thσ ì
indicateΣ (o≥ implied⌐ librar∙ filσ alonτ thσ commanΣ searcΦ ì
path and in the directory named HELP.  The search path is:
          1) indicated or default directory (dir:library)
          2) command-search path
          3) HELP directory (if any)
     Oncσ thσ librar∙ filσ ha≤ beeε found¼á LHEL╨ lock≤ ont∩ ì
it¼ anΣ al∞ hel≡ file≤ referenceΣ b∙ thσ indicateΣ hel≡ filσ ì
arσ pulleΣ froφ thi≤ librar∙ file«á  Thσ filσ "topic.HLPó o≥ ì
"topic.HQPóá i≤ pulleΣ froφ thσ librar∙ file¼á unsqueezeΣ iµ ì
necessary¼á anΣá processed«á  Iµ ß selectioε i≤á madσá whicΦ ì
reference≤á anothe≥á hel≡ file¼á thσ indicateΣ hel≡ filσá i≤ ì
als∩á pulleΣá froφá thσ curren⌠ librar∙á anΣá unsqueezeΣá iµ ì
necessary.



 Comments: 

     LHELP will only run on Z80 or HD64180 microprocessors.

     Thσ command≤ whicΦ ma∙ bσ issueΣ t∩ LHEL╨ arσ identica∞ ì
to those which may be issued to HELP.


 Selected Error Messages:  None (Self-Explanatory)



 Examples of Use: 

     LHELP SYSLIB *
          -- pull SYSLIB.HLP or SYSLIB.HQP from SYSLIB.LBR
               once SYSLIB.LBR is found via a search

     LHELP CMD1
          -- pull CMD1.HLP or CMD1.HQP from SYSTEM.LBR
               once SYSTEM.LBR is found via a search

     LHELP Z3LIB1 A:Z3LIB
          -- pull Z3LIB1.HLP or Z3LIB1.HQP from Z3LIB.LBR,
               starting the search from disk A, current user

:L


 Command:   LLF 1.0 (List Library Files)


 Syntax: 
     LLF dir:library
          -- list all files in library
     LLF dir:library /o...
          -- list all files in library with options
     LLF dir:library afn1,afn2,...
          -- lis⌠ selecteΣ file≤ iε librar∙
     LLF dir:library afn1,afn2,... o...
          -- list selected files in library with options


 Options: 
     C    Print CRCs of each file in listing
     G    Group files by file type and name (default is
               by file name and type)
     I    Print starting indices of files
     P    Send listing to printer as well as console



 Function: 

     LL╞ display≤ ß director∙ oµ ß librar∙á file«á  Specifiπ ì
file≤ ma∙ bσ selecteΣ b∙ specifyinτ ß lis⌠ oµ ambiguou≤ filσ ì
names«á  Thσá listinτá ma∙á bσ sen⌠ t∩ thσá consolσá o≥á thσ ì
printer«á  Filσá size≤á (iε term≤ oµ record≤ anΣá neares⌠á ╦ ì
bytes) are indicated in listing.


 Comments: 

     LL╞ wil∞ onl∙ ruε oε thσ Z8░ o≥ HD64180.


 Selected Error Messages:  None (Self-Explanatory)



 Examples of Use: 

     LLF A:SYSLIB
          -- list all files in A:SYSLIB.LBR

     LLF ROOT:COMMAND *.COM,*.HQP CPI
          -- list *.COM and *.HQP files from COMMAND.LBR
               in the directory ROOT:; include CRCs and
               starting indices; send output to console
               and printer

     LLF ROOT:COMMAND /P
          -- list all files in COMMAND.LBR in the ROOT:
               directory; send output to the printer


:X


 Command:   LX 1.0


 Syntax: 

     LX command_line
          -- execute command line, extracting command verb
               from ROOT:COMMAND.LBR

     LX -dir:library command_line
          -- execute command line, extracting command verb
               from the indicated library file


 Options:  None



 Function: 

     L╪á perform≤ ß completσ parsσ oµ thσ indicateΣá commanΣ ì
linσ a≤ thσ ZCPR│ commanΣ processo≥ would«á  NameΣ director∙ ì
reference≤á arσá resolved¼á etc¼á anΣ thσ Externa∞á FC┬á (iµ ì
available)¼á FC┬ ▒ (a⌠ 5CH)¼á FC┬ ▓ (a⌠ 6CH)¼á anΣ TBUF╞ (a⌠ ì
80H) are loaded as though the ZCPR3 CP had done so.


 Comments: 
     LX will only run on Z80 and HD64180 microprocessors.
     L╪á doe≤ no⌠ perforφ ß commanΣ searcΦ fo≥ thσá library«  ì
Thσá librar∙ mus⌠ residσ iε thσ indicateΣ directory¼á o≥á L╪ ì
will fail.
     Fo≥ security¼á director∙ reference≤ arσ ignoreΣ iµá thσ ì
wheel byte is not set.
     Thσá namσ oµ thσ defaul⌠ librar∙ (ROOT:COMMAND.LBR⌐ caε ì
be easily changed by patching or reassembly.


 Selected Error Messages:  None (Self-Explanatory)


 Examples of Use: 

     LX -A1:ASM LIB80
          -- run LIB80.COM from ASM.LBR in A1:

     LX XD HELP:*.*
          -- run XD.COM from ROOT:COMMAND.LBR; properly
               parsσ anΣ proces≤ thσ commanΣ tai∞
               ó HELP:*.*"

-╚#├Æ,σ!.4ß╔σ╒═⌐,╤ß╔═.╩2-δ#═A.G~■A┌╬,╓@╕╥√,2.#~■ ╚═á-╪σ~■ ╩Φ,═á-┌·,#┬╤,~■ ┬·,ß═^.O═l-╣╥√,2.»╔ß»=╔σ╒