build: Better Build System

1 files changed, 166 insertions, 0 deletions

diff --git a/static/unix-v10/man1/mc68ar.1 b/static/unix-v10/man1/mc68ar.1
new file mode 100755
index 00000000..374c5e43
--- /dev/null
+++ b/static/unix-v10/man1/mc68ar.1
@@ -0,0 +1,166 @@
+.TH MC68AR 1 "630 MTG"
+.SH NAME
+mc68ar \- archive and library maintainer for portable archives
+.SH SYNOPSIS
+.B mc68ar
+key [ posname ] afile name ...
+.SH DESCRIPTION
+.I Mc68ar\^
+maintains groups of files
+combined into a single archive file.
+Its main use
+is to create and update library files as used by the link editor.
+It can be used, though, for any similar purpose.
+.PP
+When
+.I mc68ar\^
+creates an archive, it creates headers in a format that is portable across
+all machines.  The portable archive's format and structure are described in
+detail in
+.IR ar (4).
+The archive symbol table [described in
+.IR ar (4)]
+is used by the link editor
+[\f2mc68ld(1)\f1]
+to effect multiple passes over libraries of
+object files in an efficient manner.
+Whenever the 
+.IR mc68ar (1)
+command is used to create or update the contents of an archive, the
+symbol table is rebuilt.  The symbol table can be forced to be rebuilt
+by the
+.BR s
+option described below.
+.PP
+.I Key\^
+is one character from the set
+.BR drqtpmx ,
+optionally concatenated with
+one or more of
+.BR vuaibcls .
+.I Afile\^
+is the archive file.
+The
+.I names\^
+are constituent files in the archive file.
+The meanings of the
+.I key\^
+characters are:
+.TP
+.B d
+Deletes the named files from the archive file.
+.TP
+.B r
+Replaces the named files in the archive file.
+If the optional character
+.B u
+is used with
+.BR r ,
+then only those files with
+modified dates later than
+the archive files are replaced.
+If an optional positioning character from the set
+.B abi
+is used, then the
+.I posname\^
+argument must be present
+and specifies that new files are to be placed
+after
+.RB ( a )
+or before
+.RB ( b
+or
+.BR i )
+.IR posname .
+Otherwise
+new files are placed at the end.
+.TP
+.B q
+Quickly appends the named files to the end of the archive file.
+Optional positioning characters are invalid.
+The command does not check whether the added members
+are already in the archive.
+Useful only to avoid quadratic behavior when creating a large
+archive piece-by-piece.
+.TP
+.B t
+Prints a table of contents of the archive file.
+If no names are given, all files in the archive are tabled.
+If names are given, only those files are tabled.
+.TP
+.B p
+Prints the contents of named files in the archive.
+.TP
+.B m
+Moves the named files to the end of the archive.
+If a positioning character is present,
+then the
+.I posname\^
+argument must be present and,
+as in
+.BR r ,
+specifies where the files are to be moved.
+.TP
+.B x
+Extracts the named files.
+If no names are given, all files in the archive are
+extracted.
+In neither case does
+.B x
+alter the archive file.
+.bp
+.TP
+.B v
+Verbose.
+Under the verbose option,
+.I mc68ar\^
+gives a file-by-file
+description of the making of a
+new archive file from the old archive and the constituent files.
+When used with
+.BR t ,
+it gives a long listing of all information about the files.
+When used with
+.BR x ,
+it precedes each file with a name.
+.TP
+.B c
+Create.
+Normally,
+.I mc68ar\^
+will create
+.I afile\^
+when it needs to.
+The create option suppresses the
+normal message that is produced when
+.I afile\^
+is created.
+.TP
+.B l
+Local.
+Normally,
+.I mc68ar\^
+places its temporary files in the directory
+.BR /tmp .
+This option causes them to be placed in the local directory.
+.TP
+.B s
+Symbol table creation.
+Forces the regeneration of the archive symbol table even if 
+.IR mc68ar (1) 
+is not invoked with a command which will modify the archive contents.
+This command is useful to restore the archive symbol table after the
+.IR mc68strip (1)
+command has been used on the archive.
+.SH FILES
+/tmp/ar\(**	temporaries
+.SH SEE ALSO
+mc68ld(1),
+mc68lorder(1),
+mc68strip(1).
+.br
+a.out(4), ar(4) in the \f2UNIX System V Programmer's Reference
+Manual\f1.
+.SH BUGS
+If the same file is mentioned twice in an argument list,
+it may be put in the archive twice.