Usenet 1994 October/usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso/misc/volume7/zooman.cat/part02

Text File | 1989-07-27 | 39.1 KB | 1,614 lines

Newsgroups: comp.sources.misc
subject: v07i105: zoo 2.01 enhanced user manual, formatted (part 02/02)
from: [e-mail] (Brandon S. Allbery - comp.sources.misc)
Reply-To: [e-mail] (Rahul Dhesi)

Posting-number: Volume 7, Issue 105
Submitted-by: [e-mail] (Rahul Dhesi)
Archive-name: zooman.cat/part02

This is the second part of the posting of the formatted user manual for
zoo 2.01 by Bill Davidsen.  To extract, concatenate both parts and
follow instructions in the first part.  Any trailing garbage in part 1
or the headers in this part will be automatically ignored, so they need
not be removed before concatenation.

#BOPART
X
X     Add the file twice@tmore and view
X@t       zoo a FIZ fiz.1
X@t       Zoo:  fiz.1 --  (43%) replaced+
X
X@t       zoo a FIZ fiz.1
X@t       Zoo:  fiz.1 --  (43%) replaced+
X
X@t       zoo Ldg FIZ
X
X@t       Archive FIZ.zoo:
X@t       Length@t CF  Size Now  Date@t Time
X@t       --------@t --- --------  --------- --------
X@t@t     29@t  0%@t   29@t2 Sep 88 17:32:42    0g@t D xxx;1
X@t@t     29@t  0%@t   29@t2 Sep 88 17:47:14    0g@t   xxx;2
X@t@t     29@t  0%@t   29@t2 Sep 88 17:47:22    0g@t   xxx;3
X@t@t     29@t  0%@t   29@t2 Sep 88 17:47:30    0g@t   xxx;4
X@t@t   3849@t 43%@t 2211@t3 Feb 88 21:55:56    1g@t D fiz.1;1
X@t@t   3849@t 43%@t 2211@t3 Feb 88 21:55:56    1g@t D fiz.1;2
X@t@t   3849@t 43%@t 2211@t3 Feb 88 21:55:56    1g@t   fiz.1;3
X@t       --------@t --- --------  --------- --------
X@t@t  11663@t 42%@t 6749@t  7 files
X@t       ------------
X@t       D: deleted file.
X@t       Archive generation limit@tis 3.
X
X     After adding the file several time, note that all
X
X     generations other than the@tmost recent have been deleted.
X
X     This is just what we wanted.  Obviously if@tyou wanted to
X
X     keep a large number of generations@tof one file you@tcould set
X
X     the archive limit higher and lower@tthe limit of other files.
X
X     This is useful, if@tnot convenient.
X
X
X
X
X
X
X
X
X
X
X     page 18@t@t     For zoo 2.01      rev 1.19@t- 11/9/88
X@t@t    Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X@t  4.3  D@hD@hD@hDi@hi@hi@hir@hr@hr@hre@he@he@hec@hc@hc@hct@ht@ht@hto@ho@ho@hor@hr@hr@hry@hy@hy@hy s@hs@hs@hst@ht@ht@htr@hr@hr@hru@hu@hu@huc@hc@hc@hct@ht@ht@htu@hu@hu@hur@hr@hr@hre@he@he@hes@hs@hs@hs
X
X
X@t  Most operating systems have a@tmulti-level structure of
X
X@t  directories, and what@tare known as "subdirectories". _@hz_@ho_@ho
X
X@t  offers options about using these on the add command and the
X
X@t  extract command. Normally any@tdirectory information you
X
X@t  specify is preserved and available for use when the files
X
X@t  are extracted. By default directory information is saved
X
X@t  when a file is added,@tbut not@tused when it is@textracted.
X
X@t  These@tdefaults seem to represent the most common cases.
X
X
X@t  4.4  M@hM@hM@hMa@ha@ha@hat@ht@ht@htc@hc@hc@hch@hh@hh@hhi@hi@hi@hin@hn@hn@hng@hg@hg@hg@to@ho@ho@hof@hf@hf@hf f@hf@hf@hfi@hi@hi@hil@hl@hl@hle@he@he@hen@hn@hn@hna@ha@ha@ham@hm@hm@hme@he@he@hes@hs@hs@hs
X
X
X@t  When _@hz_@ho_@ho examines the@tfilenames on the command line, an
X
X@t  unintuitive name matching paradigm is@tused. If the name
X
X@t  contains a path delimiter, such as '/' in UNIX or '\'@tin
X
X@t  MS-DOS, only the name@tas entered is matched.
X
X
X@t  For example:
X@t       zoo D arch src/subz.c
X
X@t  Will require an exact@tmatch before the file is deleted.
X
X@t  However, if you just specify a filename without a path
X
X@t  delimiter, _@ha_@hl_@hl files of that name will be deleted, in@tany
X
X@t  directory.
X
X
X
X
X
X
X
X
X
X
X
X@t  rev 1.19 - 11/9/88@t  For zoo 2.01@t@t       Page 19
X@t@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X     Consider this archive:
X
X     Archive FIZ.zoo:
X     Length    CF  Size@tNow  Date      Time
X     --------  --- --------  --------- --------
X@t 3849  43%     2211   3@tFeb 88 21:55:56@t    fiz.1
X@t 6864  48%     3563   3@tFeb 88 21:52:16@t    fiz.c
X@t 3849  43%     2211   6@tSep 88 09:33:54@t    t1/fiz.1
X     --------  --- --------  --------- --------
X@t14562  45%     7985@t3 files
X
X     There are two files, with different dates,@tnamed "fiz.1" and
X
X     "t1/fiz.1". If you@tuse the@tdelete command on "t1/fiz.1",
X
X     only that file will be deleted. If, however, you use the
X
X     delete command with the name "fiz.1", both@tfiles of that
X
X     name will be deleted. Currently there is no way to@tdelete
X
X     just the file with@tno path@tinformation. This limitation also
X
X     applies to@tother commands which require specifying@tnames in
X
X     the archive, such as list and extract.
X
X
X     4.5  C@hC@hC@hCo@ho@ho@hom@hm@hm@hmm@hm@hm@hme@he@he@hen@hn@hn@hnt@ht@ht@hts@hs@hs@hs
X
X
X     _@hz_@ho_@ho provides two type of comments,@tone on files to@texplain
X
X     what each file does, and one on the archive as a whole to
X
X     explain what's in the archive. The@tcomment@ton the entire
X
X     archive might be something@tlike "analize heat test@tdata,"
X
X     while individual files might have comments@tlike "validate
X
X     data routine," and@t"plot graphs on@tprinter@tin graphics
X
X     mode." The@tactual commands@tused to@tdo this@tare discussed
X
X     under adding and listing data sections.
X
X
X
X
X
X
X
X     page 20@t@t     For zoo 2.01      rev 1.19@t- 11/9/88
X@t@t    Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X@t  5.  A@hA@hA@hAd@hd@hd@hdv@hv@hv@hva@ha@ha@han@hn@hn@hnc@hc@hc@hce@he@he@hed@hd@hd@hd c@hc@hc@hco@ho@ho@hom@hm@hm@hmm@hm@hm@hma@ha@ha@han@hn@hn@hnd@hd@hd@hd u@hu@hu@hus@hs@hs@hsa@ha@ha@hag@hg@hg@hge@he@he@he
X
X
X@t  5.1  a@ha@ha@had@hd@hd@hdd@hd@hd@hdi@hi@hi@hin@hn@hn@hng@hg@hg@hg d@hd@hd@hda@ha@ha@hat@ht@ht@hta@ha@ha@ha t@ht@ht@hto@ho@ho@ho a@ha@ha@han@hn@hn@hn a@ha@ha@har@hr@hr@hrc@hc@hc@hch@hh@hh@hhi@hi@hi@hiv@hv@hv@hve@he@he@he
X
X
X@t  5.1.1@t _@hM_@ho_@hv_@he__@hu_@hp_@hd_@ha_@ht_@he_@hd__@hf_@hi_@hl_@he_@hs__@ht_@ho__@ha_@hn__@ha_@hr_@hc_@hh_@hi_@hv_@he  While the novice
X
X@t  commands support the most common operations, there are
X
X@t  several things which can only@tbe done@tby the expert
X
X@t  commands. One@tof these is to update an archive and delete
X
X@t  the added files. This@tis a combination of the@t-update@tand
X
X@t  -move@tcommands.
X
X
X@t  The expert command to@tdo this@tis:
X@t       zoo aunM@tarch file1 file2
X
X@t  Note that this is a combination of options, 'u' to update
X
X@t  files@twhich are newer@tthan what's in the archive, 'n'@tfor
X
X@t  new files not@tin the archive at all, and 'M' to move the
X
X@t  added@tfiles to the archive. Files which are current in the
X
X@t  archive will not be replaced,@tsaving time (and if packing is
X
X@t  not done, file space).
X
X
X@t  5.1.2@t _@hP_@ha_@hc_@hk_@hi_@hn_@hg__@ha_@hs__@ha_@hn__@ho_@hp_@ht_@hi_@ho_@hn__@ht_@ho__@ha_@hd_@hd  Note that@tbecause@tthis
X
X@t  is an@texpert command,@tthe archive is not packed, and any
X
X@t  files@treplaced will still be in the archive. Adding the 'P'
X
X@t  option to the@tcommand@tcauses the archive to be packed, and
X
X@t  the unpacked archive to be saved as 'file.bak'.
X
X
X@t  For example:
X@t       zoo aunMP arch file1 file2
X
X@t  will pack the@tarchive@t"arch.zoo" and leave the unpacked
X
X
X
X@t  rev 1.19 - 11/9/88@t  For zoo 2.01@t@t       Page 21
X@t@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X     version as@t"arch.bak".
X
X
X     5.1.3  _@hA_@hd_@hd_@hi_@hn_@hg__@hf_@hi_@hl_@he_@hs__@hf_@hr_@ho_@hm__@hs_@hu_@hb_@hd_@hi_@hr_@he_@hc_@ht_@ho_@hr_@hi_@he_@hs  When files are in
X
X     subdirectories, one thing you can do is to@thave a separate
X
X     archive for each subdirectory. Using _@hz_@ho_@ho you may also have
X
X     files from@tseveral@tsubdirectories in anarchive. The
X
X     following examples@tshown how this is done using MS-DOS or
X
X     UNIX.
X
X
X     MS-DOS:
X@t  zoo a@tsrc doc
X
X     UNIX:
X@t  zoo a@tsrc/* doc/*
X
X     Note that the only@tdifference is that the '\' delimiter is
X
X     used in MS-DOS instead of the more@tcommon '/' used@tin UNIX.
X
X     When you list an archive created this way,@tthe listing looks
X
X     like this.
X
X
X     Subdirectory archive listing
X
X@t  Archive FIZsdir.zoo:
X@t  Length    CF@tSize Now  Date@t    Time
X@t  --------  ---@t--------  --------- --------
X@t      3849  43%@t    2211   2 Sep 88 14:29:02@t doc/fiz.1
X@t      6864  48%@t    3563   2 Sep 88 14:29:02@t src/fiz.c
X@t  --------  ---@t--------  --------- --------
X@t     10713  46%@t    5774     2 files
X
X     There are a number@tof options for extracting these@tfiles,
X
X     allowing you to use or ignore the subdirectory information.
X
X     If@tyou want to create the archive file without the@tdirectory
X
X     names saved as part of the@tfilename, the ':' option will
X
X     allow you to do this. One reason to do this is if you are
X
X
X
X     page 22@t@t     For zoo 2.01      rev 1.19@t- 11/9/88
X@t@t    Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X@t  going@tto create an archive from a subdirectory and don't
X
X@t  want to have to change to the@tdirectory, or if you know the
X
X@t  files@twill be@textracted in another directory.
X
X
X@t  Creating an archive from a subdirectory:
X@t       zoo a: arch src/* src/*
X
X@t  Gives@tlisting:
X
X@t       Archive FIZsdir.zoo:
X@t       Length@t CF  Size Now  Date@t Time
X@t       --------@t --- --------  --------- --------
X@t@t   3849@t 43%@t 2211@t2 Sep 88 14:29:02     fiz.1
X@t@t   6864@t 48%@t 3563@t2 Sep 88 14:29:02     fiz.c
X@t       --------@t --- --------  --------- --------
X@t@t  10713@t 46%@t 5774@t  2 files
X
X@t  5.1.4@t _@hG_@he_@ht_@ht_@hi_@hn_@hg__@ht_@hh_@he__@hl_@hi_@hs_@ht__@ho_@hf__@hf_@hi_@hl_@he_@hs__@hf_@hr_@ho_@hm__@ha_@hn_@ho_@ht_@hh_@he_@hr__@hs_@ho_@hu_@hr_@hc_@he@tIf
X
X@t  you're storing a large number@tof files in an archive,@tit may
X
X@t  be inconvenient to type in the names of the files each time
X
X@t  you work on the archive. _@hz_@ho_@ho allows you to take the files
X
X@t  list from a file using the 'I' option. This option may be
X
X@t  applied to a number of commands, but typically you use it
X
X@t  with the 'a' command when creating a new archive, or the
X
X@t  'aun'@tcommand@twhen updating an archive.
X
X
X@t  Example of file list for a file
X@t       zoo aI arch < files.lst
X
X@t  Where@tthe file "files.lst" has been created with a list of
X
X@t  the files you're maintaining in this archive.@tSince this is
X
X@t  a simple text@tfile, you can create it@twith an@teditor,@tand
X
X@t  program, or by typing@tit in.
X
X
X@t  If you are on@ta system which supports@tpipes between
X
X
X
X@t  rev 1.19 - 11/9/88@t  For zoo 2.01@t@t       Page 23
X@t@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X     commands, you can use a program to@tgenerate a list@tand send
X
X     it@tinto _@hz_@ho_@ho without saving@tit in a@tfile. The commands "find"
X
X     on@tUNIX and "scan"@ton MS-DOS are useful.
X
X
X     File list by pipes@t- UNIX:
X
X@t  find . -type f -mtime@t-4 -print | zoo@taI thisweek
X
X     File list by pipes@t- MS-DOS:
X
X@t  scan -R *.doc@t| zoo aI thisweek
X
X     5.1.5  _@hA_@hd_@hd_@hi_@hn_@hg__@hc_@ho_@hm_@hm_@he_@hn_@ht_@hs__@ht_@ho__@ht_@hh_@he__@ha_@hr_@hc_@hh_@hi_@hv_@he  Comments may be the
X
X     entire archive or on individual files, or both. The concept
X
X     is@tdiscussed in detail in the "Other Concepts" section.
X
X     Comments may be added to a@tfile at@tthe time the file is
X
X     added to the archive.  This is done by the@t'c' option. Here
X
X     is@tan example of adding data to and archive with a@tcomment
X
X     on@teach file, then@tadding a comment to the@tarchive@tas a
X
X     whole.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X     page 24@t@t     For zoo 2.01      rev 1.19@t- 11/9/88
X@t@t    Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X@t       zoo ac htanal *.for
X
X@t       Zoo:  main.for@t --  ( 0%) added
X@t       [Enter comment for main.for then@ttype /END]
X@t       Read four heat treat test results files and prepare a graph on the
X@t       dot matrix printer.
X@t       /end
X@t       Zoo:  plot.for@t --  ( 0%) added
X@t       [Enter comment for plot.for then@ttype /END]
X@t       Convert X,Y data@tto plot@tpoints in 240dpi mode
X@t       /end
X@t       Zoo:  screen.for@t --  ( 0%) added
X@t       [Enter comment for screen.for then type /END]
X@t       FORTRAN version of curses, handle screen@tdisplay@tand buffering.
X@t       /end
X@t       Zoo:  strings.for --  ( 0%) added
X@t       [Enter comment for strings.for then type@t/END]
X@t       String manipulation package
X@t       /end
X
X
X@t       zoo cA htanal
X
X@t       [Enter archive comment for htanal.zoo then type /END]
X@t       Heat treat analysis program, prepare plot of results on the dot
X@t       matrix printer
X@t       /end
X
X@t  The first command adds all of@tthe FORTRAN files to the
X
X@t  archive, each@twith a comment.@tA comment is then added@tto the
X
X@t  entire archive which describes the function of the package.
X
X@t  If you want to modify@tthe comments already in@tthe archive,
X
X@t  either file or archive, you may use the type a new comment
X
X@t  or just press@tRETURN to keep the existing comment.
X
X
X@t  5.1.6@t _@hU_@hs_@hi_@hn_@hg__@hg_@he_@hn_@he_@hr_@ha_@ht_@hi_@ho_@hn_@hs  Generations@tare really useful as a
X
X@t  way to keep back versions of files handy in case you have to
X
X@t  roll back, or@tfix a bug in an@tolder version. Here's how it
X
X@t  works.
X
X
X
X
X
X@t  rev 1.19 - 11/9/88@t  For zoo 2.01@t@t       Page 25
X@t@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X     There is a@tlimit on the number of generations of a@tfile
X
X     which will@tbe kept, set on@teach individual@tfile, and by
X
X     default zero. This@tdoesn't@tmean that no generations are
X
X     saved, it means that there's no limit.  There's also a limit
X
X     on@tthe whole archive, called the archive limit, and that's
X
X     set by default to one. The@tmaximum@tnumber of generations
X
X     saved is the lower@tof the two limits for any given@tfile.
X
X
X     There are three ways to set up an archive with generations.
X
X     The simplest is to@tleave the file limits at the default
X
X     (zero) and@tset the@tarchive@tlimit. What you@tdo is to create
X
X     an@tarchive@tusing the 'a+' command to add files and@tturn on
X
X     generations. Then you use the 'glA=' command to set the
X
X     limit on generations for the whole@tarchive.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X     page 26@t@t     For zoo 2.01      rev 1.19@t- 11/9/88
X@t@t    Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X@t  It's easier than it sounds, here's an@texample:
X
X@t       zoo a+ demo foo1
X@t       Zoo:  foo1 --  (67%) added
X
X@t       zoo glA=3 demo
X@t       Archive generation limit@tis now 3
X
X@t       Now we have an archive with one generation of files,
X@t       and no more than@tthree generations of files to be saved
X@t       for any file. After changing the@tfile and adding@tnew
X@t       versions@tto the archive,@there's what the@tarchive@tlooks
X@t       like. Notice that deleted files haven't been removed,
X@t       to make it easy to see what's happening.
X
X
X@t       zoo Ldg demo
X
X@t       Archive demo.zoo:
X@t       Length@t CF  Size Now  Date@t Time
X@t       --------@t --- --------  --------- --------
X@t@t   5074@t 67%@t 1690  18 Oct 88 10:36:52    0g@t D foo1;1
X@t@t   5103@t 67%@t 1705  18 Oct 88 10:45:10    0g@t   foo1;2
X@t@t   5132@t 67%@t 1715  18 Oct 88 10:45:14    0g@t   foo1;3
X@t@t   5161@t 67%@t 1725  18 Oct 88 10:45:20    0g@t   foo1;4
X@t       --------@t --- --------  --------- --------
X@t@t  20470@t 67%@t 6835@t  4 files
X@t       ------------
X@t       D: deleted file.
X@t       Archive generation limit@tis 3.
X
X@t  Remember that@tthere are three@tways to@tuse generations. The
X
X@t  second is if I have one file which does not require many
X
X@t  generations. In that case I would set@tthe archive generation
X
X@t  limit@tto the value for all the rest of the files in the
X
X@t  archive, and then set@tthe limit on the one file which@tneeds
X
X@t  a special value.
X
X
X
X
X
X
X
X
X
X
X
X@t  rev 1.19 - 11/9/88@t  For zoo 2.01@t@t       Page 27
X@t@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X     It@twould look like@tthis:
X@t  zoo a+ demo foo1 foo2@tfoo3
X@t  Zoo:@tfoo1 --@t (67%) added
X@t  Zoo:@tfoo2 --@t (21%) added
X@t  Zoo:@tfoo3 --@t (77%) added
X
X@t  zoo glA=5 demo
X@t  Archive generation limit is now 5
X
X@t  zoo gl=2 demo@tfoo2
X@t  Zoo: foo2;1@t       -- adjusted to 2
X
X     The final way to manage generations is to set the archive
X
X     limit to zero, allowing any number@tof versions as default,
X
X     and then setting the limit@ton each@tfile individually. This
X
X     is@talmost never needed, but it does allow you to control the
X
X     generation@tlimit of each file completely.
X
X
X     5.2  L@hL@hL@hLi@hi@hi@his@hs@hs@hst@ht@ht@hti@hi@hi@hin@hn@hn@hng@hg@hg@hg t@ht@ht@hth@hh@hh@hhe@he@he@he a@ha@ha@har@hr@hr@hrc@hc@hc@hch@hh@hh@hhi@hi@hi@hiv@hv@hv@hve@he@he@he
X
X
X     5.2.1  _@hG_@he_@hn_@he_@hr_@ha_@ht_@hi_@ho_@hn__@hi_@hn_@hf_@ho_@hr_@hm_@ha_@ht_@hi_@ho_@hn  There are several options
X
X     which will@thelp you work with generations.@tThe simplist is
X
X     to@tuse the@t'L' command instead of the 'l'.@tHere is@ta simple
X
X     archive, listed in@ttwo ways.
X
X
X     Listed with 'l':
X
X@t  Archive FIZ.zoo:
X@t  Length    CF@tSize Now  Date@t    Time
X@t  --------  ---@t--------  --------- --------
X@t      6864  48%@t    3563   3 Feb 88 21:52:16@t fiz.c;1
X@t@t29   0%@t      29  31 Aug 88 16:29:04@t xxx;2
X@t  --------  ---@t--------  --------- --------
X@t      6893  48%@t    3592     2 files
X
X
X
X
X
X
X
X
X
X     page 28@t@t     For zoo 2.01      rev 1.19@t- 11/9/88
X@t@t    Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X@t  Listed with 'L':
X
X@t       Archive FIZ.zoo:
X@t       Length@t CF  Size Now  Date@t Time
X@t       --------@t --- --------  --------- --------
X@t@t   6864@t 48%@t 3563@t3 Feb 88 21:52:16     fiz.c;1
X@t@t     29@t  0%@t   29  31 Aug 88 16:29:04     xxx;1
X@t@t     29@t  0%@t   29  31 Aug 88 16:29:04     xxx;2
X@t       --------@t --- --------  --------- --------
X@t@t   6922@t 48%@t 3621@t  3 files
X
X@t  Note that using 'l' only the most current version is
X
X@t  displayed, while if you use 'L' all non-deleted versions are
X
X@t  listed.
X
X
X@t  If you set limits on generations of individual files,@tthen
X
X@t  you will want@tto see those limits. The option@tto do this is
X
X@t  'g', display generation info.@tWithout@tthat option the
X
X@t  archive and file generation limits will not be displayed,
X
X@t  although the 'L' command will@tdisplay@tundeleted versions.
X
X
X@t  An archive with generations, using 'L':
X
X@t       Archive FIZ.zoo:
X@t       Length@t CF  Size Now  Date@t Time
X@t       --------@t --- --------  --------- --------
X@t@t   6864@t 48%@t 3563@t3 Feb 88 21:52:16     fiz.c;1
X@t@t     29@t  0%@t   29  31 Aug 88 16:29:04     xxx;1
X@t@t     29@t  0%@t   29  31 Aug 88 16:29:04     xxx;2
X@t       --------@t --- --------  --------- --------
X@t@t   6922@t 48%@t 3621@t  3 files
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X@t  rev 1.19 - 11/9/88@t  For zoo 2.01@t@t       Page 29
X@t@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X     An@tarchive@twith generations, using@t'Lg':
X
X@t  Archive FIZ.zoo:
X@t  Length    CF@tSize Now  Date@t    Time
X@t  --------  ---@t--------  --------- --------
X@t      6864  48%@t    3563   3 Feb 88 21:52:16@t0g   fiz.c;1
X@t@t29   0%@t      29  31 Aug 88 16:29:04@t0g   xxx;1
X@t@t29   0%@t      29  31 Aug 88 16:29:04@t0g   xxx;2
X@t  --------  ---@t--------  --------- --------
X@t      6922  48%@t    3621     3 files
X@t  ------------
X@t  Archive generation limit is 3.
X
X     5.2.2  _@hL_@hi_@hs_@ht_@hi_@hn_@hg__@hd_@he_@hl_@he_@ht_@he_@hd__@hf_@hi_@hl_@he_@hs  If you have modified@tan
X
X     archive with the expert commands, and have@tnot yet@tpacked
X
X     the archive to remove deleted files, you may view those
X
X     files using the 'd' option@tto the 'l' or 'L' commands.
X
X
X     This is what the listing looks like with 'L':
X
X@t  Archive FIZsim.zoo:
X@t  Length    CF@tSize Now  Date@t    Time
X@t  --------  ---@t--------  --------- --------
X@t      6864  48%@t    3563   3 Feb 88 21:52:16@t fiz.c
X@t      3849  43%@t    2211   3 Feb 88 21:55:56@t fiz.1
X@t  --------  ---@t--------  --------- --------
X@t     10713  46%@t    5774     2 files
X@t  ------------
X@t  There@tis 1 deleted file.
X
X     And this listing used 'Ld':
X
X@t  Archive FIZsim.zoo:
X@t  Length    CF@tSize Now  Date@t    Time
X@t  --------  ---@t--------  --------- --------
X@t      3849  43%@t    2211   3 Feb 88 21:55:56@tD fiz.1
X@t      6864  48%@t    3563   3 Feb 88 21:52:16@t  fiz.c
X@t      3849  43%@t    2211   3 Feb 88 21:55:56@t  fiz.1
X@t  --------  ---@t--------  --------- --------
X@t     14562  45%@t    7985     3 files
X@t  ------------
X@t  D: deleted file.
X
X     Note that the listing without the 'd' option simply informs
X
X     you of the@tnumber of selected files, while@tthe listing with
X
X
X
X     page 30@t@t     For zoo 2.01      rev 1.19@t- 11/9/88
X@t@t    Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X@t  'd' shows you@tthe file information just as it@tdoes the
X
X@t  undeleted files.
X
X
X@t  5.2.3@t _@hL_@hi_@hs_@ht_@hi_@hn_@hg__@hm_@hu_@hl_@ht_@hi_@hp_@hl_@he__@ha_@hr_@hc_@hh_@hi_@hv_@he_@hs  The@tcommand@t'L' allows
X
X@t  more than one@tarchive@tto be listed. In fact the general form
X
X@t  allows for any number@tof archives to be specified, each
X
X@t  affected by the options of the 'L' command. The restriction
X
X@t  is that you can't just list some files, you get a listing of
X
X@t  all undeleted@tfiles in all archives.
X
X
X@t  Command "zoo L FIZ FIZsim":
X
X@t       Archive FIZ.zoo:
X@t       Length@t CF  Size Now  Date@t Time
X@t       --------@t --- --------  --------- --------
X@t@t   6864@t 48%@t 3563@t3 Feb 88 21:52:16     fiz.c;1
X@t@t     29@t  0%@t   29  31 Aug 88 16:29:04     xxx;1
X@t@t     29@t  0%@t   29  31 Aug 88 16:29:04     xxx;2
X@t       --------@t --- --------  --------- --------
X@t@t   6922@t 48%@t 3621@t  3 files
X
X@t       Archive FIZsim.zoo:
X@t       Length@t CF  Size Now  Date@t Time
X@t       --------@t --- --------  --------- --------
X@t@t   6864@t 48%@t 3563@t3 Feb 88 21:52:16     fiz.c
X@t@t   3849@t 43%@t 2211@t3 Feb 88 21:55:56     fiz.1
X@t       --------@t --- --------  --------- --------
X@t@t  10713@t 46%@t 5774@t  2 files
X@t       ------------
X@t       There is@t1 deleted file.
X
X@t  5.2.4@t _@hC_@hr_@he_@ha_@ht_@hi_@hn_@hg__@ha__@hs_@hi_@hm_@hp_@hl_@he__@ha_@hr_@hc_@hh_@hi_@hv_@he__@hd_@ha_@ht_@ha_@hb_@ha_@hs_@he__@hf_@hi_@hl_@he  The 'a' and
X
X@t  'q' options may be used to create a database file which may
X
X@t  be used as input to your favorite database program, or just
X
X@t  sorted and viewed on the screen or paper.
X
X
X
X
X
X
X
X@t  rev 1.19 - 11/9/88@t  For zoo 2.01@t@t       Page 31
X@t@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X     Creating a@tsimple files list from several archives:
X
X@t  zoo Laq FIZ FIZsim
X
X@t      6864  48%@t    3563   3 Feb 88 21:52:16@t FIZ.zoo fiz.c;1
X@t@t29   0%@t      29  31 Aug 88 16:29:04@t FIZ.zoo xxx;1
X@t@t29   0%@t      29  31 Aug 88 16:29:04@t FIZ.zoo xxx;2
X@t      6864  48%@t    3563   3 Feb 88 21:52:16@t FIZsim.zoo fiz.c
X@t      3849  43%@t    2211   3 Feb 88 21:55:56@t FIZsim.zoo fiz.1
X
X     the 'a' option causes the name of the archive to be listed
X
X     on@teach line, instead at the start@tof the listing.@tThe 'q'
X
X     option suppresses the headings and@tsummaries, leaving just
X
X     one line per file.
X
X
X     The eighth@tfield is the archive name, and the ninth is the
X
X     file name.@t The file may be sorted@ton either of those, or
X
X     the size, date modified, etc. Any or all of those fields may
X
X     be@tused a indices for a real database program, if the number
X
X     of@tfiles and archives is large enough to warrant that.
X
X
X     5.2.5  _@hL_@hi_@hs_@ht_@hi_@hn_@hg__@hc_@ho_@hm_@hm_@he_@hn_@ht_@hs  An archive is normally listed using
X
X     the 'l' command, and only the actual contents are shown. If
X
X     the 'v' option is added, or if 'v'@tis used@tas a command, the
X
X     comment at@tthe start of the archive which describes the
X
X     package as@ta whole@tis displayed. If the 'V' option@tor
X
X     command is@tused, the comments on individual files are shown
X
X     as@twell. Here are examples@tof listing an archive, first with
X
X     just the descriptive archive comment, and then with the
X
X     comments on the individual@tfiles as well.
X
X
X
X
X
X
X     page 32@t@t     For zoo 2.01      rev 1.19@t- 11/9/88
X@t@t    Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X@t       zoo v htanal
X
X@t       Archive htanal.zoo:
X@t       >> Heat treat analysis program, prepare plot of results
X@t       Length@t CF  Size Now  Date@t Time
X@t       --------@t --- --------  --------- --------
X@t@t     29@t  0%@t   29  17 Oct 88 17:23:24   C main.for
X@t@t     29@t  0%@t   29  17 Oct 88 17:23:24   C plot.for
X@t@t     29@t  0%@t   29  17 Oct 88 17:23:24   C screen.for
X@t@t     29@t  0%@t   29  17 Oct 88 17:23:24   C strings.for
X@t       --------@t --- --------  --------- --------
X@t@t    116@t  0%@t  116@t  4 files
X@t       ------------
X@t       C: file has attached comment.
X
X
X
X
X@t       zoo V htanal
X
X@t       Archive htanal.zoo:
X@t       >> Heat treat analysis program, prepare plot of results
X@t       Length@t CF  Size Now  Date@t Time
X@t       --------@t --- --------  --------- --------
X@t@t     29@t  0%@t   29  17 Oct 88 17:23:24   C main.for
X@t@t|Read four heat@ttreat test results files and prepare a graph on@tthe
X@t@t|dot matrix printer.
X@t@t     29@t  0%@t   29  17 Oct 88 17:23:24   C plot.for
X@t@t|Convert X,Y data to plot points in 240dpi mode
X@t@t     29@t  0%@t   29  17 Oct 88 17:23:24   C screen.for
X@t@t|FORTRAN version of curses, handle screen display and buffering.
X@t@t     29@t  0%@t   29  17 Oct 88 17:23:24   C strings.for
X@t@t|String@tmanipulation package
X@t       --------@t --- --------  --------- --------
X@t@t    116@t  0%@t  116@t  4 files
X@t       ------------
X
X@t  5.3  E@hE@hE@hEx@hx@hx@hxt@ht@ht@htr@hr@hr@hra@ha@ha@hac@hc@hc@hct@ht@ht@hti@hi@hi@hin@hn@hn@hng@hg@hg@hg f@hf@hf@hfi@hi@hi@hil@hl@hl@hle@he@he@hes@hs@hs@hs
X
X
X@t  5.3.1@t _@hE_@hx_@ht_@hr_@ha_@hc_@ht_@hi_@hn_@hg__@ht_@ho__@ha__@hs_@hu_@hb_@hd_@hi_@hr_@he_@hc_@ht_@ho_@hr_@hy  Since the _@hz_@ho_@ho default
X
X@t  is to@tsave directory information, you@tmay want to use@tthat
X
X@t  information at some time. The@tdefault@tis to extract all
X
X@t  files@tinto the current directory. If the option '/' is added
X
X@t  to the expert@textract@tcommand, the files will@tbe extracted
X
X@t  into their original directories, _@hi_@hf _@ha_@hn_@hd _@ho_@hn_@hl_@hy _@hi_@hf _@ht_@hh_@he
X
X
X@t  rev 1.19 - 11/9/88@t  For zoo 2.01@t@t       Page 33
X@t@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X     _@hd_@hi_@hr_@he_@hc_@ht_@ho_@hr_@hi_@he_@hs _@he_@hx_@hi_@hs_@ht.@tIf you want to create the directories,
X
X     the '//' option will do that, creating any@tneeded
X
X     directories as the@tfiles are extracted.
X
X
X     Consider the archive:
X
X@t  Archive myarch.zoo:
X@t  Length    CF@tSize Now  Date@t    Time
X@t  --------  ---@t--------  --------- --------
X@t      3849  43%@t    2211   2 Sep 88 14:29:02@t doc/fiz.1
X@t      6864  48%@t    3563   2 Sep 88 14:29:02@t src/fiz.c
X@t  --------  ---@t--------  --------- --------
X@t     10713  46%@t    5774     2 files
X
X     And the command:
X@t  zoo
X
X     The files "fiz.1" and "fiz.c" will@tbe extracteded in the
X
X     current directory.@t To extract the@tfiles in their original
X
X     directories, the option '//' may be used.
X
X
X     Creating directories and extracting:
X
X@t  zoo x// myarch
X
X     Finally the '/' option extractes files into their original
X
X     directories if the@tdirectories exist. In the case where some
X
X     directories exist and others don't@tonly the files for which
X
X     you have directories will be extracted, and you will get a
X
X     warning for each file not restored.
X
X
X     5.3.2  _@hE_@hx_@ht_@hr_@ha_@hc_@ht_@hi_@hn_@hg__@hq_@hu_@hi_@he_@ht_@hl_@hy@tThe 'q'@tcommand@tmay be used with
X
X     the 'x' command to@textract@tfiles without a@tmessage@tfor each
X
X     file. Although most people@twant a message to assure them
X
X     that the file was extracted, this may be useful if@tthe
X
X     extract affects a number of files and only@tthe error
X
X
X     page 34@t@t     For zoo 2.01      rev 1.19@t- 11/9/88
X@t@t    Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X@t  messages (if any) are@tneeded.
X
X
X@t  5.3.3@t _@hU_@hs_@hi_@hn_@hg__@hw_@hi_@hl_@hd_@hc_@ha_@hr_@hd_@hs__@hf_@ho_@hr__@he_@hx_@ht_@hr_@ha_@hc_@ht  In general wildcards may
X
X@t  be used to extract files as well as save them.  However, on
X
X@t  some systems where wildcard names are@texpanded before@tthe
X
X@t  command is executed, it will be necessary to use the correct
X
X@t  escape sequence to prevent the name from being changed.
X
X
X@t  Extract on MS-DOS
X
X@t       zoo x arch *.doc
X
X@t  Extract on UNIX
X
X@t       zoo x arch
X
X@t  Since@tthe UNIX system@texpands@tthe wildcard names for you,
X
X@t  zoo is a special case, and you must quote the@tname. Quoting
X
X@t  is not needed@ton MS-DOS and VMS.
X
X
X@t  5.3.4@t _@hE_@hx_@ht_@hr_@ha_@hc_@ht_@hi_@hn_@hg__@hd_@he_@hl_@he_@ht_@he_@hd__@hf_@hi_@hl_@he_@hs  Although careful use@tof
X
X@t  generations will avoid the need to recover the deleted
X
X@t  versions of files, you may at@tsome time have an archive
X
X@t  which@tcontains a deleted file, and wish to recover it.
X
X@t  Consider the archive below.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X@t  rev 1.19 - 11/9/88@t  For zoo 2.01@t@t       Page 35
X@t@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X     An@tarchive@twith a deleted file:
X
X@t  zoo ld FIZ
X
X@t  Archive FIZ.zoo:
X@t  Length    CF@tSize Now  Date@t    Time
X@t  --------  ---@t--------  --------- --------
X@t      3849  43%@t    2211   3 Feb 88 21:55:56@t  fiz.1
X@t      6864  48%@t    3563   3 Feb 88 16:21:36@tD fiz.c
X@t      6864  48%@t    3563   3 Feb 88 21:52:16@t  fiz.c
X@t      3849  43%@t    2211   6 Sep 88 09:33:54@t  t1/fiz.1
X@t  --------  ---@t--------  --------- --------
X@t     21426  46%@t   11548     4 files
X@t  ------------
X@t  D: deleted file.
X
X     To@tmake the situation worse, there@tis also@tan undeleted file
X
X     by@tthe same name. What you@tneed to@tdo is to recover the the
X
X     older version of the file which has been deleted. Note that
X
X     if@tyou had@tused the novice@tversion@tof the add command it
X
X     would have@tpacked the archive and the deleted file@twould be
X
X     gone. I could be found in the "FIZ.bak" copy of the archive,
X
X     however.
X
X
X     The extract command may be@tused with the 'd' option, which
X
X     allows _@hz_@ho_@ho@tto extract deleted files as well as active files,
X
X     or@tthe 'dd' option, which forces extraction of _@ho_@hn_@hl_@hy deleted
X
X     files. Since you have an active file of the same name, you
X
X     will want the 'dd'@toption.@tDon't forget to@tdelete whatever
X
X     version of@tthe file is in your current directory, or you
X
X     will need to use still more options.
X
X
X     Extracting@tthe deleted file:
X
X@t  zoo xdd FIZ fiz.c
X@t  Zoo:@tfiz.c@t       -- extracted
X
X
X
X     page 36@t@t     For zoo 2.01      rev 1.19@t- 11/9/88
X@t@t    Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X@t  The message indicates@tthat the deleted version of the@tfile
X
X@t  has been recovered. Note that@tthe generations@tfeature@tis
X
X@t  intended to eliminate@tthe need to do this type of operation.
X
X
X@t  5.3.5@t _@hE_@hx_@ht_@hr_@ha_@hc_@ht__@ha_@hn_@hd__@ho_@hv_@he_@hr_@hw_@hr_@hi_@ht_@he
X
X@t     "You are lost in a@ttwisty maze of options,@tall alike"
X
X
X@t  There@tare three options which@tallow you to extract files
X
X@t  from an archive without deleting all of the files in your
X
X@t  current directory structure.@tThese are generally useful
X
X@t  only when the@texisting file have become damaged in some way,
X
X@t  such as trying to make changes to source or documentation
X
X@t  with a new editor, etc.
X
X
X@t  The 'O' option allows@t_@hz_@ho_@ho to overwrite existing files.
X
X@t  Without this option _@hz_@ho_@ho will ask permission to overwrite an
X
X@t  existing file@tbefore replacing it. While this@tis useful as a
X
X@t  safety measure, there@tare times when you will@twant to@t"just
X
X@t  do it." When the 'O' option is specified, existing file will
X
X@t  be replaced unless they are newer than the file in the
X
X@t  archive or read-only.@tUsing the option "OO" instead of 'O'
X
X@t  allows _@hz_@ho_@ho to@toverwrite "read-only" files. If@tyou want to
X
X@t  replace existing files you must use one of these two
X
X@t  options.
X
X
X@t  Even when using the 'O' option, an existing file will@tnot be
X
X@t  overwritten if it is newer than the version in the archive.
X
X@t  This would happen if you extracted a file, changed it, and
X
X
X@t  rev 1.19 - 11/9/88@t  For zoo 2.01@t@t       Page 37
X@t@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X     then found@tthat the changes were incorrect. To allow _@hz_@ho_@ho to
X
X     replace a newer files, you@tneed the option@tspecified
X
X     unconditionally.
X
X
X     5.3.6  _@hE_@hx_@ht_@hr_@ha_@hc_@ht_@hi_@hn_@hg__@hg_@he_@hn_@he_@hr_@ha_@ht_@hi_@ho_@hn_@hs  If you have@tan archive with
X
X     previous generations, at some time@tyou will want to extract
X
X     a generation older@tthan the most current. To do this you
X
X     specify the generation number as part of the filename in the
X
X     'x' command.
X
X
X     Let's look@tat the listing of an archive with generations, and then@tthe
X     command to@textract@tan old generation:
X
X@t  zoo Ldg demo
X
X@t  Archive demo.zoo:
X@t  Length    CF@tSize Now  Date@t    Time
X@t  --------  ---@t--------  --------- --------
X@t      5074  67%@t    1690  18 Oct 88 10:36:52@t0g  D foo1;1
X@t      5103  67%@t    1705  18 Oct 88 10:45:10@t0g    foo1;2
X@t      5132  67%@t    1715  18 Oct 88 10:45:14@t0g    foo1;3
X@t      5161  67%@t    1725  18 Oct 88 10:45:20@t0g    foo1;4
X@t  --------  ---@t--------  --------- --------
X@t     20470  67%@t    6835     4 files
X@t  ------------
X@t  D: deleted file.
X@t  Archive generation limit is 3.
X
X
X@t  zoo x@tdemo foo1;2
X@t  Zoo: foo1;2@t      -- extracted
X
X     Notice that the characters@t';' or ':' may be used to
X
X     separate the filename from@tthe generation.@tThe ';'@tis
X
X     customary in VMS, while it's inconvenient in UNIX,@twhere the
X
X     ':' may be@tused. At this time there's no way to bypass the
X
X     generation@tcharacter and access a file with either@tcharacter
X
X     in@tits name.
X
X
X     page 38@t@t     For zoo 2.01      rev 1.19@t- 11/9/88
X@t@t    Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X@t  6.  I@hI@hI@hIn@hn@hn@hnd@hd@hd@hde@he@he@hex@hx@hx@hx
X
X@t  + option, enable generations@t11
X@t  -add command,@tadd files  4
X@t  -delete command, delete files@t 8
X@t  -extract command, extract for@tarchive@t 7
X@t  -freshen command, update existing files  4
X@t  -freshen  5
X@t  -list@tcommand, default format@tfile listing  6
X@t  -move@tcommand, move files into archive  5
X@t  -update command, add new or changed files  5
X@t  -update  5
X@t  / option, extract to subdirectory  24
X@t  D command, delete files  8
X@t  L command, list all generations  20
X@t  L command, listing multiple archives@t22
X@t  LBR  1
X@t  M option, move files into archive  5
X@t  MS-DOS  1,14,16,17,25
X@t  O option, overwrite existing files  26
X@t  P command, pack archive  10
X@t  P option, pack after executing command  10
X@t  S option, overwrite read-only@tfiles  27
X@t  SQ  1
X@t  UNIX@t1,14,16,17,25
X@t  VMS  11
X@t  a command, add files@t4
X@t  adding file to an archive  4
X@t  adding files and packing  15
X@t  adding files from subdirectories  16
X@t  adding lists of files@t 17
X@t  adding new files only@t 5
X@t  advanced concepts  10
X@t  archive filename  2
X@t  archive  1
X@t  aun command, add new or changed files@t 5
X@t  combining update and move  15
X@t  comments, adding  17
X@t  comments, listing  23
X@t  comments  15
X@t  compress  1
X@t  content listsings, creating  22
X@t  creating archive content listings  22
X@t  d option, extracting deleted files  26
X@t  d option, list deleted files@t10
X@t  d option, listing deleted files  21
X@t  database input files,@tcreating  22
X@t  delete after archiving  5
X@t  deleted files, listing  21
X@t  deleted files, novice@tpacking@t 10
X@t  deleting files  8
X
X
X@t  rev 1.19 - 11/9/88@t  For zoo 2.01@t@t       Page 39
X@t@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X     expert commands  2
X     extract file from archive@t7
X     extract using wildcards  25
X     extracting@tdeleted@tfiles  26
X     extracting@tfiles from subdirectories  16
X     extracting@tgenerations  27
X     extracting@tread-only files@t 27
X     extracting@tselected files@t8
X     extracting@tto a subdirectory  24
X     extracting@twith overwrite@t26
X     f option, fast listing  6
X     filename limitations  2
X     filesnames, reading from standard input  17
X     g option, list generation limits  20
X     generation@tdelimiters  27
X     generation@tlimit setting  11
X     generation@tlimit  18
X     generation@tlimits,@tlisting@t 20
X     generations, enabling  11
X     generations, extracting  27
X     generations, listing  12,20
X     generations  11,18
X     headings, list without, q option  6
X     introduction  1
X     l command,@tlist archive contents  6
X     limitations, filename  2
X     listing comments  23
X     listing deleted files  21
X     listing details  6
X     listing generations  20
X     listing multiple archives@t22
X     move, combining and update@t 15
X     multiple archives,@tlisting@t 22
X     n option, add new files only  4
X     n option, add new files  5
X     new files,@tadding@t5
X     novice commands  2
X     overwrite files on@textract@t 26
X     overwriting newer files on@textract@t 27
X     packing archives  10
X     packing while adding files@t 15
X     q command,@tquiet operation@t 25
X     q option, list without headings  6
X     quiet extract  25
X     read-only files, extracting  27
X     reading a listing@t6
X     standard input, reading filenames from  17
X     subdirectories and@twildcards  14
X     subdirectories, adding files from@t16
X     subdirectories  14,16
X     subdirectory name matching@tlimitations  14
X
X
X     page 40@t@t     For zoo 2.01      rev 1.19@t- 11/9/88
X@t@t    Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X@t  subdirectory,@textracting files from  16
X@t  subdirectory,@textracting to  24
X@t  totals line  6
X@t  u option, update existing files  4
X@t  update and move, combining  15
X@t  updating files  4
X@t  using@tsubdirectories@t14
X@t  wildcards and@tsubdirectories@t14
X@t  wildcards, extract using  25
X@t  wildcards  3
X@t  x command, extract from archive  7
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X@t  rev 1.19 - 11/9/88@t  For zoo 2.01@t@t       Page 41
X@t@t@t Advanced features and commands
X
X
X
X
#EOF
cat >/dev/null << \#FMARK
#FMARK
#EOR
echo Checking CRC codes for errors...
brik -C << \#EOCRC
#BOCRC
# Whole file CRCs generated by Brik v2.0.  Use "brik -C" to verify them.

# CRC-32        filename
# ------        --------

 434332680      uguide.prn
#EOCRC
if test $? -eq 0
then
   echo "No errors"
   exit 0
else
   echo 'Oops! Errors occurred'
   exit 1
fi

Rahul Dhesi <[e-mail]>
UUCP:    ...!{iuvax,pur-ee}!bsu-cs!dhesi