Research V6 development

Work on file usr/doc/man/man1/cref.1
Work on file usr/doc/man/man1/chdir.1
Work on file usr/doc/man/man1/ar.1

Co-Authored-By: Dennis Ritchie <dmr@research.uucp>
Synthesized-from: v6

diff --git a/usr/doc/man/man1/ar.1 b/usr/doc/man/man1/ar.1
new file mode 100644 (file)
index 0000000..7867110
--- /dev/null
+++ b/usr/doc/man/man1/ar.1
@@ -0,0 +1,104 @@
+.th AR I 3/15/72
+.sh NAME
+ar \*- archive and library maintainer
+.sh SYNOPSIS
+.bd ar
+key afile name ...
+.sh DESCRIPTION
+.it Ar
+maintains groups of files
+combined into a single archive file.
+Its main use
+is to create and update library files as used by the loader.
+It can be used, though, for any similar purpose.
+.s3
+.it Key
+is one character from the set
+.bd drtux,
+optionally concatenated with
+.bd v.
+.it Afile
+is the archive file.
+The
+.it names
+are constituent files in the archive file.
+The meanings of the
+.it key
+characters are:
+.s3
+.bd d
+means delete the named files from the archive file.
+.s3
+.bd r
+means replace the named files in the archive file.
+If the archive file does not exist,
+.bd r
+creates it.
+If the named files are not in the archive file, they are appended.
+.s3
+.bd 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.
+.s3
+.bd u
+is similar to
+.bd r
+except that only those
+files that have been modified are replaced.
+If no names are given, all files in the archive that
+have been modified are replaced by the modified version.
+.s3
+.bd x
+extracts the named files.
+If no names are given, all files in the archive are
+extracted.
+In neither case does
+.bd x
+alter the archive file.
+.s3
+.bd v
+means verbose.
+Under the verbose option,
+.it ar
+gives a file-by-file
+description of the making of a
+new archive file from the old archive and the constituent files.
+The following abbreviations
+are used:
+.s3
+.bd "   c"
+copy
+.bd "   a"
+append
+.bd "   d"
+delete
+.bd "   r"
+replace
+.bd "   x"
+extract
+.sh FILES
+/tmp/vtm?      temporary
+.sh "SEE ALSO"
+ld (I), archive (V)
+.sh BUGS
+Option
+.bd tv
+should be implemented as a table with more information.
+.s3
+There should be a way to specify the placement
+of a new file in an archive.
+Currently, it is placed at the end.
+.s3
+Since
+.it ar
+has not been rewritten to
+deal properly with the new file system
+modes,
+extracted files have mode 666.
+.s3
+For the same reason,
+only the first 8 characters of file names are significant.
+.s3
+If the same file is mentioned twice in an argument list,
+it may be put in the archive twice.

diff --git a/usr/doc/man/man1/chdir.1 b/usr/doc/man/man1/chdir.1
new file mode 100644 (file)
index 0000000..5f51452
--- /dev/null
+++ b/usr/doc/man/man1/chdir.1
@@ -0,0 +1,21 @@
+.th CHDIR I 5/15/74
+.sh NAME
+chdir \*- change working directory
+.sh SYNOPSIS
+.bd chdir
+directory
+.sh DESCRIPTION
+.it Directory
+becomes the new working directory.
+The process must have execute (search)
+permission in
+.it directory.
+.s3
+Because a new process is created to execute each command,
+.it chdir
+would be ineffective if it were written as a
+normal command.  It is therefore recognized and executed
+by the Shell.
+.sh "SEE ALSO"
+sh (I), pwd (I)
+.sh BUGS

diff --git a/usr/doc/man/man1/cref.1 b/usr/doc/man/man1/cref.1
new file mode 100644 (file)
index 0000000..cb13b19
--- /dev/null
+++ b/usr/doc/man/man1/cref.1
@@ -0,0 +1,142 @@
+.th CREF I 2/5/73
+.sh NAME
+cref  \*-  make cross reference listing
+.sh SYNOPSIS
+.bd cref
+[
+.bd \*-acilostux123
+] name ...
+.sh DESCRIPTION
+.it Cref
+makes a cross reference listing
+of program files in assembler or C format. The files
+named as arguments in the command
+line are searched for symbols 
+in the appropriate syntax.
+.s3
+The output report is in four columns:
+.nf
+.s3
+(1)    (2)     (3)     (4)
+symbol file    see     text as it appears in file
+               below
+.s3
+.fi
+.it Cref
+uses either an
+.it ignore
+file or an
+.it only
+file.
+If the
+.bd \*-i
+option is given, the next
+argument is taken to be an
+.it ignore
+file; if the
+.bd \*-o
+option is given, the next
+argument is taken to be
+an
+.it only
+file.
+.it Ignore
+and
+.it only
+files are lists of symbols separated by new lines.
+All symbols in an
+.it ignore
+file
+are ignored in columns (1) and (3) of the output.
+If an
+.it only
+file is given, only symbols in that
+file appear in column (1).
+At most one of
+.bd \*-i
+and
+.bd \*-o
+may be used.
+The default setting
+is
+.bd \*-i.
+Assembler predefined symbols or C keywords are ignored.
+.s3
+The
+.bd \*-s
+option causes current symbols to be
+put in column 3.
+In the assembler, the current symbol
+is the most recent name symbol;
+in C, the current function name.
+The
+.bd \*-l
+option causes the line number within the file
+to be put in column 3.
+.s3
+The
+.bd \*-t
+option causes the next available argument
+to be used as the name
+of the intermediate temporary
+file (instead of /tmp/crt??).
+The file is created and
+is not removed at the end of the process.
+.s3
+Options:
+.s3
+.lp +5 3
+\fBa\fR        assembler format (default)
+.lp +5 3
+\fBc\fR        C format input
+.lp +5 3
+\fBi\fR        use
+.it ignore
+file (see above)
+.lp +5 3
+\fBl\fR        put line number in col. 3 (instead of current symbol)
+.lp +5 3
+\fBo\fR        use
+.it only
+file (see above)
+.lp +5 3
+\fBs\fR        current symbol in col. 3 (default)
+.lp +5 3
+\fBt\fR        user supplied temporary file
+.lp +5 3
+\fBu\fR        print only symbols that occur exactly once
+.lp +5 3
+\fBx\fR        print only C external symbols
+.lp +5 3
+\fB1\fR        sort output on column 1 (default)
+.lp +5 3
+\fB2\fR        sort output on column 2
+.lp +5 3
+\fB3\fR        sort output on column 3
+.s3
+.i0
+.sh FILES
+.dt
+/tmp/crt??     temporaries
+.br
+/usr/lib/aign  default assembler 
+.it ignore
+file
+.br
+/usr/lib/cign  default C
+.it ignore
+file
+.br
+/usr/bin/crpost        post processor
+.br
+/usr/bin/upost post processor for
+.bd \*-u
+option
+.br
+/bin/sort      used to sort temporaries
+.br
+.s3
+.fi
+.sh "SEE ALSO"
+as (I), cc (I)
+.sh BUGS