makes copies of files specified on its standard input.
It is normally run either as a channel feed under
or by a script before
reads the named
file, or standard input if no file is given.
The input is taken as a set of lines.
Blank lines and lines starting with a number sign (``#'') are ignored.
All other lines should specify the name of a file to archive.
If a filename is not an absolute pathname, it is taken to be relative to
Files are copied to a directory within the archive directory,
The default is to create a hierarchy that mimics the input files;
intermediate directories will be created as needed.
For example, the input file
(article 2211 in the newsgroup comp.sources.unix) will be copied to
If the ``-a'' flag is used then its argument specifies the directory to
archive in instead of the default.
If the ``-f'' flag is used, then all directory names will be
flattened out, replacing the slashes with periods.
In this case, the file would be copied to
If the ``-i'' flag is used, then
will append one line to the specified
file for each article that it copies.
This line will contain the destination name and the Message-ID and
Files are copied by making a link.
If that fails a new file is created.
If the ``-m'' flag is used, then the file will be copied to the
destination, and the input file will be replaced with a symbolic
link pointing to the new file.
sets its standard error to
To suppress this redirection, use the ``-r'' flag.
If the input is exhausted,
will exit with a zero status.
If an I/O error occures, it will try to spool its input, copying it to a file.
If there was no input filename, the standard input will be copied to
and the program will exit.
If an input filename was given, a temporary file named
is an absolute pathname)
(if the filename does not begin with a slash) is created.
Once the input is copied,
will try to rename this temporary file to be the name of the input file,
and then exit.
entry to archive most source newsgroups is as follows: