@H
@T0
USAGE
    tar <function> <tarfile> [<file> . . .]

DESCRIPTION
    Builds and extracts from Unix tape archive files.  The <function>
parameter consists of a one-letter function specifier with one or more
option characters.  <tarfile> is the file to be used for the archive.
If <tarfile> is specified as -, then Stdin or Stdout will be used, as
appropriate.  <file> is one or more filenames to be used by the extract
or create operations.
@D1
Function_Specifiers : 2
Examples : 3
Bugs_and_Info : 4
@T2
FUNCTION SPECIFIERS
    t   Output a table of all files in the archive.

        Recognized Options:
        v  Verbose mode.  Display file permissions, sizes, 
           and modification dates and times.

    x   Extract the named files from the archive.  Wildcard characters
        * and ? may be used in filename specifications.

        Recognized Options:
        v  Verbose mode.  Display a message for each file extracted.
        m  Do not restore modification dates.  Instead, use current
           date and time as modification date for each extracted file.
        u  convert LF -> CR (for UNIX text files)
        b  Set copy buffer size (number of tape blocks).
           The number is specified directly after the options.

    c   Create a new archive file and include the named files.  A directory
        name means to recursively include all files in that directory.

        Recognized Options:
        v  Verbose mode.  Display a message for each file added to the archive.
        u  convert CR -> LF (for UNIX text files)
        b  Set copy buffer size (number of tape blocks).
           The number is specified directly after the options.
        d  copy contents of several floopy disks to one tar archive

    All of the functions will also accept an 'f' option, which is ignored
    and included only for compatibility with the Unix 'tar' program.
@T3
EXAMPLES

1)   tar c - /d0 >/t2
    Archive all of the files on drive /d0, and send the resultant archive
    to stdout, which is redirected to /t2.

2)   tar tv sample.tar
    Will produce a verbose listing of the files in the archive.

3)   tar xmb 100 sample.tar a*.c text
    Will extract 'text' and all files matching the pattern a*.c from
    the archive sample.tar, ignoring the stored modification dates.
    Use a buffer of 100 tape blocks.

4)   tar xvb 50 sample.tar subdir
    Will extract all files from the directory 'subdir'. If 'subdir' doesn't
    exist it will be created. Buffer size is set to 50 blocks.

5)   tar xu /mt0 test.c
    Will extract the file test.c from a tape written on a UNIX machine,
    all LF characters will be converted to CRs.

6)   tar cu /mt0 test.c
    Will write the file test.c to a tape streamer converting all CR to LF for
    usage on a UNIX system.

@T4
BUGS
    This program is much simpler than the standard Unix tar program, and
lacks much of its functionality.   It cannot add files to a pre-existing
archive.  It cannot extract anything but the last occurence when more than
one copy of a file appears in the archive.  There may be problems
with very long file names.

AUTHOR
     Michael Huisjes
     Ported to OS9/6809 by Simmy Turner(simmy@nu.cs.fsu.edu)
     Ported to OS9/68k & improved by Stephan Paschedag 
                             (stp@ethz.uucp  ..!mcvax!cernvax!chx400!ethz!stp)
