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