%OP%PS1
%OP%AMM
%OP%DP0
%OP%TM2
%OP%LM10
%OP%HE//ZFU Program Documentation//
%OP%FO///Page @P@/
%CO:A,12,72%%C%%H1%Notes on release 0.90%H1%

    Version 0.90 is in effect a pre-release of ZFU. While fully 
functional within its abilities, it suffers from the following 
restrictions:











   Version 1.0 will support better error handling, and incorporate a 
couple of different forms of data compression, a general purpose form, 
and a pipe dream specific form.


%H1%Introduction:%H1%

  The program ZFU is a utility to allow for the archiving of many files 
into a single file. The individual files can later be extracted from 
the archive into their original state (excepting dates). Files can be 
added to the archive using any allowable Z88 wild cards, see the 
section on adding files for more information on the exact format.

    One of the main features of ZFU is its ability to add files to the 
archive by date. Most of the ways to save data from the Z88 (such 
as cassette tape, PDD disk drives, or copying to other machines) suffer 
from the lack of easily storing files across many directories, or 
storing many small files, or storing by date. At last count a fully 
expanded Z88 could hold over 24000 files (albeit small ones). Backing 
up all your files every time you go somewhere is very awkward if you do 
use many small files spread across several directories. With ZFU you 
can simply set the modification date limit to the last time you saved 
everything, then create a single .zfu file with all of the modified 
files by specifying :*//* as the files to be added. This single .zfu 
file can then be saved to tape, or disk, or whatever.

%H1%Shareware:%H1%

    This program is distributed under the shareware concept, meaning it 
is distributed freely, but if you use it you are under obligation to 
register it with the author. Registration supports the development of 
the program, and offers the following advantages. Registered users are 
informed of the next upgrade following the version they registered, 
and registered users can obtain a copy of the latest version (see the 
section on updates for more information). To register ZFU, send $25.00 
(US) to:






Registration covers the current and all future shareware versions of 
ZFU.


%H1%Disclaimer:%H1%

    This product is provided as is, without any warranty either 
expressed or implied, including but not limited to implied warranties 
of merchantability and fitness for a particular purpose. In no event 
shall the author be liable for any loss of profit or any other damage 
caused by the use or misuse of the program, including but not limited 
to special, incidental, consequential or other damages.

%H1%Running ZFU:%H1%

    ZFU is written entirely in assembly language, and is run as a BASIC 
program simply by being read in at the tail of a short BASIC program 
which then calls ZFU proper. The only user consequence of this is that 
ZFU should be loaded, then RUN, and %H2%NEVER%H2% saved back out as a BASIC 
program. If it is, only the BASIC header is saved, ZFU proper is lost, 
and trying to run it subsequently will result in a crash. (It will be 
obvious if you do this, since the saved file will only be on the order 
of a 100 bytes long).

    When ZFU is first started, a information screen is displayed, and 
you are asked for the name of an archive file. If the file does not 
exist a new one will be created. The main menu is then displayed, all 
operations from this point work on the same archive file, to use a new 
archive file, exit the program and run it again. Each of the main menu 
options is described in the follow sections.

%H1%Adding Files:%H1%

    Selecting the add files option prompts for the names of the files 
to be added to the archive, full use of the Z88 wild cards is allowed, 
with one addition. If the input file specification includes a directory 
or device specification, the full file name will be saved in the 
archive, and when the file is extracted, it will be extracted into the 
same location (device and directory). If only a file name is specified, 
only the file name will be included in the archive, and when extracted 
will be extracted into the current directory. For example, specifying 
/* would save all of the files from the root directory, which when 
extracted would go back into the root directory of the same device, 
while specifying * would save all of the files from the current 
directory, which would when extracted go into the current directory at 
the time of the extraction. The files will be added or skipped 
according to the creation and modification dates of the file, see the 
section on dates for more information.

%H1%Extracting Files:%H1%

    This option extracts all of the files from the archive, if the full 
path name was saved with the file, it will be extracted into that 
location, provided the directory exists. %H2%ZFU will not create the 
%H2%directory for the file to go into.%H2%

%H1%Listing:%H1%

    The list option simply lists out all of the files saved in the 
archive. The listing is not paged, depress the shift and the diamond 
key at the same time to hold the display.

%H1%Information:%H1%

     The information screen simply lists the name of the current 
archive file, and the current option settings.

%H1%Dates:%H1%

    One of the major features of ZFU, and in fact the original 
motivation behind it, is the ability to add files to the archive based 
on the creation and modification dates. These are set from the options 
menu. Only files with dates on or after the specified dates will be 
added to the archive. By default the creation date is set to some time 
in the future, and the modification date to the remote past so that all 
files will be selected. Simply changing the modification date then 
gives control over all modified files. 

%H1%Updates:%H1%

    Registered users can receive 1 update (as long as ZFU is being 
maintained as an active Shareware product), free of charge by sending a 
blank EPROM cartridge in a self addressed and stamped package to the 
author at the registration address. The EPROM will be erased so if you 
do this make sure you have nothing you want on it.
%CO:B,60,60%





No file compression, data is saved as is.
Limited error handling, errors simply re-prompt with no 
error message given, or exit ZFU.
No partial extraction.
No file delete capabilities
No checksum verification for files
File dates and times are not restored (they are saved in 
the archive file just not used at this point).
Listing only gives file name information.





































Richard Haw
P.O. Box 732
E. Lansing, MI.
48826
USA