%OP%TM1
%OP%BM1
%OP%HE/%H2%Z88 Users' Club Software Library
%CO:A,12,70%%H1%%H2%List-Comp.doc%H1%%H2% R. Boam (2891) 3/9/1990

     "LIST_COMP.BAS" provides a quick and simple means of compiling 
lists of files either for use as List Files (see Multifile Documents 
in the Handbook) or as catalogues of files.
     Enter Basic and LOAD & RUN or CHAIN the program. After a brief 
delay while the program is assembled you will be offered a choice of 
4 commands:
          <>A which allows you to enter a wildcard string and then 
compiles a list (in :Ram.0/CAT-RAM.L) of all files which match this 
string. E.g. a wildcard string of :ram.*//*.bas will list all files 
in your Z-88 with the extension ".bas" while :ram.1//f* will list all 
files is :ram .1 beginning with "f".
          <>T does the same but only with regard to files which have 
been updated on that day.
          <>P allows you to procede to the next stage of the program 
without compiling a new list.
          <>Q which quits the program and leaves you with a blank 
screen.

     After implementing <>A or <>T or pressing <>P you will be 
offered a choice of 5 more commands:
          <>L which uses the CLI to load :ram.0/CAT-RAM.L as a List 
File: i.e it loads the first file on the list and gives access to the 
list file commands <>FN <>FB <>FT <>FP for moving between the files 
in the list and to the list file facilities in <>BSE anf <>BRP.
          <>C which uses the CLI to load :RAM.0/CAT-RAM.L itself so 
that the list can be viewed and edited. (N.B. if you do edit it and 
want to return to Basic and use <>L to load it is a list file or <>M 
you need to have saved it as plain text first)
          <>M which allows you to merge all the files in the list to  
a single directory: you will have to nominate the directory, say 
whether it already exists or needs to be created and whether you wish 
to have the original files erased after they have been copied into 
the directory.
          <> N which puts you back to the first part of the program 
so that you can compile another list.
          <>Q - as before.


      %H1%Customising the program%H1%: If, like me, you have expansion ram 
only in slot 1 and use :ram.0 only for temporary files it makes sense 
to alter the default wildcard string for <>T (LINE 2080) to read *CLI 
:ram.1//*.
      Additional commands can easily be integrated into the second 
stage of the program: for example if you have a discdrive for your 
Z-88 it would be convenient to be able to save all files updated in a 
day's work with a few key presses (this was the chief reason for 
writing the program). By changing lines 1950 and 1970 to allow for a 
"<>D = Save listed files to disc" one could insert as line 1985 a 
call to a PROC on the lines of PROC_MERGE which would write and 
implement a CLI file which would CHAIN the discdrive software and 
save each file on the list.

     Any suggestions for improving this program would be greatly 
appreciated. Please write to me at: The Old Post Office, Rusness, 
Sanday Orkney,KW17 2BP.
%CO:B,12,60%%CO:C,12,48%%CO:D,12,36%%CO:E,12,24%%CO:F,12,12%