Upload

Digital Research

CPM OPERATING SYSTEMS/CPM 68K/1.0X SOURCES/v102a/doc/cmnd/ar68

@@ -0,0 +1,91 @@
+.so macro
+.he 'AR68''AR68'
+.pr PROGRAM AR68
+ar68 - archive maintainer
+.us USAGE
+ar68 flags [pos] archive file1 file2 ...
+.fn FUNCTION
+\&'ar68' collects individual files into a single archive,
+or library file.
+It is primarily used to maintain libraries of object files
+for use by the loader,
+although it can be used with any type of file.
+.sp 1
+The flags argument determines the function that 'ar68' performs.
+One character from the set {dprtx} must be specified;
+these are the function select flags.
+The function select flags specify the following functions:
+.sp 2
+.in +8
+.ti -8
+d\ \ \ \ \ \ \ Delete the specified files from the archive.
+.sp
+.ti -8
+p\ \ \ \ \ \ \ Print the specified files.
+If the files are not printable,
+e.g. object files, havoc results.
+.sp
+.ti -8
+r\ \ \ \ \ \ \ Replace the specified files.
+If an optional position flag from the set
+{abi} is not specified new files are placed at the end of the archive.
+.sp
+.ti -8
+t\ \ \ \ \ \ \ Print a table of contents of the archive.
+If files are specified only the specified files are listed.
+.sp
+.ti -8
+x\ \ \ \ \ \ \ Extract the specified files from the archive,
+creating loose files in the current directory.
+If no files are specified, all of the files in the archive are extracted.
+Note that 'x' does not alter the archive.
+The 'd' flag must be used to delete files from an archive.
+.sp 2
+.in -8
+The files must be specified in the same order as they appear in the
+archive file,
+otherwise some of the files may not be found.
+For example, if an archive "t.a" consists of the files file1, file2
+and file3 in that order,
+the command "ar t t.a file2 file1" will cause file2 to be listed,
+but not file1.
+Instead, the message "file1 not in archive" will be printed.
+This is because 'ar68' only searches the archive once.
+Files must be specified in the order they appear in the archive.
+.sp 2
+Characters from the set {abiv} may be included in the flags argument.
+These characters have the following function:
+.in +8
+.sp 2
+.ti -8
+a\ \ \ \ \ \ \ When used with the 'r' flag, 'a' specifies that new files
+are to be inserted after the file "pos" in the archive.
+Note that the "pos" argument must be specified if and only if
+one of the characters {abi} appear in the flags argument.
+.sp
+.ti -8
+b\ \ \ \ \ \ \ 'b' has the same function as 'a', except that new files are
+inserted before the file "pos" in the archive.
+.sp
+.ti -8
+i\ \ \ \ \ \ \ 'i' has exactly the same meaning as 'b', the two characters
+can be used interchangeably (but only one must appear).
+.sp
+.ti -8
+v\ \ \ \ \ \ \ 'v' (verbose) causes a file by file description of the
+operation of 'ar68' to be printed.
+Files are either copied (c),
+replaced (r), added (a), deleted (d) or extracted (x) from an archive.
+When used with the 't' flag, 'v' causes a long listing to be printed.
+Verbose has no effect on the print function.
+.in -8
+.fl FILES
+_~ar????? (process id in octal)  - temporary file
+.dg DIAGNOSTICS
+.sa SEE ALSO
+lo68 (cmnd), ar68 (files)
+.bg BUGS
+When using any of the 'a' 'b', or 'i' flags to position the files,
+if any of the files in the namelist already exist in the archive,
+you must delete them with the delete option first. Otherwise, 'ar68'
+will make another copy of them.