Initializing help system before first use

tar

Purpose
Create a TAR archive.
Synopsis
procedure tar(arc:text, dir:text, a_args:...)
Arguments
arc 
TAR file to create.
dir 
Location of the files to collect.
a_args 
List of files to include into the archive.
Example 
 tar("mytar.tar", ".", "*.txt")
   ! -> TAR mytar.tar *.txt                 (if MODE other than 'clean')
   ! -> RM mytar.tar                        (if MODE='clean')
 tar("mytar.tgz", "dir/subdir", "*.txt")
   ! -> TAR mytar.tgz dir/subdir *.txt      (if MODE other than 'clean')
   ! -> RM mytar.tgz                        (if MODE='clean')
Further information
1. The first element of the list of files is interpreted as a list of flags if it starts with a '-'.
2. The archive will be created if runmode is not "clean" and any of the source files is newer than the destination file or if the flag "-f" is used.
3. The destination files will be deleted if runmode is "clean" unless the flag "-f" is used.
4. The function will automatically compress the file if the archive file name ends with ".tar.gz" or ".tgz".
5. The file selection may include wildcard characters: in this case the selection will be done using the findfiles function. All directories are enumerated recursively.
6. Execution of the program terminates if the operation fails and exitonfail is true unless flag "-i" is used.
Related topics
zip

Parent Topic Subroutines

© 2001-2025 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.