|Purpose:||Add, update, or delete files in a .tar archive|
|Format:||TAR [/= /A:[[-][+]rhsdaecjot] /A /C /D /F /G /M /O:[-]acdeginorstuz /Q /R /TEST /U /V] tararchive [@file] file...|
|tararchive||The tar file to work with|
|file||The files(s) to be added to the tar archive|
See also UNTAR.
File Completion Syntax:
The default filename completion syntax is::  dirs tar [2*] *
TAR is compatible with archives created by the Linux / UNIX tar utility. Unless you use the /G option, the tar file will be uncompressed. If you don't specify any arguments, TAR will display its command dialog.
You can specify a pathname for tararchive. If you don't provide an extension, and the filename as entered doesn't exist, TAR adds ".tar". If you don't specify an operation, TAR will default to Add.
TAR supports connected web folders. If an HTML file (i.e., with an .htm or .html extension) is compressed, TAR will look for a folder in the same directory with the same name and an extension of ".files". If it is found, the .files directory will be be added the TAR archive.
TAR sets two internal variables:
|%_tar_files||The number of files archived|
|%_tar_errors||The number of errors|
|/=||Display the TAR command dialog to help you set the filename and command line options. The /= option can be anywhere on the line; additional options will set the appropriate fields in the command dialog.|
|/A:...||Select only those files that have the specified attribute(s) set. See Attribute Switches for information on the attributes which can follow /A:. Do not use /A: with @file lists. See @file lists for details.|
You can specify /A:= to display a dialog to help you set individual attributes.
|/F||Update only those files that currently exist in the tar file, and which are older than the files on disk.|
|/G||When all the files have been added to the archive, compress the entire archive using gzip compression and create a .tar.gz archive.|
You may use any combination of the sorting options below. If multiple options are used, the files will be sorted with the first sort option as the primary key, the next as the secondary key, and so on:
|n||Sort by filename and extension, unless e is explicitly included. This is the default.|
|-||Reverse the sort order for the next sort key|
|a||Sort names and extensions in standard ASCII order, instead of numerically when numeric substrings are included in the name or extension.|
|c||Sort by compression ratio|
|d||Sort by date and time (oldest first); also see /T:acw|
|e||Sort by extension|
|g||Group subdirectories first, then files|
|i||Sort by description|
|o||Sort by owner|
|r||Reverse the sort order for all options|
|s||Sort by size|
|t||Same as d|
|z||Same as s|
|/R||If the argument is a subdirectory, copy all of the files in that subdirectory and all of its subdirectories to the tar archive.|
|/TEST||Test the integrity of the TAR file (header and contents). Any errors will be displayed on STDERR.|