Research V7 development

Work on file usr/man/man1/cd.1
Work on file usr/man/man1/arcv.1m
Work on file usr/man/man1/man.1
Work on file usr/man/man1/wait.1
Work on file usr/man/man1/intro.1

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

diff --git a/usr/man/man1/arcv.1m b/usr/man/man1/arcv.1m
new file mode 100644 (file)
index 0000000..095cdb3
--- /dev/null
+++ b/usr/man/man1/arcv.1m
@@ -0,0 +1,22 @@
+.TH ARCV 1M
+.SH NAME
+arcv \- convert archives to new format
+.SH SYNOPSIS
+.B arcv
+file ...
+.SH DESCRIPTION
+.I Arcv
+converts archive files
+(see
+.IR ar (1),
+.IR ar (5))
+from 6th edition to 7th edition format.
+The conversion is done in place, and the command
+refuses to alter a file not in old archive format.
+.PP
+Old archives are marked with a magic number of 0177555 at the start;
+new archives have 0177545.
+.SH FILES
+/tmp/v*, temporary copy
+.SH SEE ALSO
+ar(1), ar(5)

diff --git a/usr/man/man1/cd.1 b/usr/man/man1/cd.1
new file mode 100644 (file)
index 0000000..9160ce7
--- /dev/null
+++ b/usr/man/man1/cd.1
@@ -0,0 +1,20 @@
+.TH CD 1 
+.SH NAME
+cd \- change working directory
+.SH SYNOPSIS
+.B cd
+directory
+.SH DESCRIPTION
+.I Directory
+becomes the new working directory.
+The process must have execute (search)
+permission in
+.IR directory .
+.PP
+Because a new process is created to execute each command,
+.I cd
+would be ineffective if it were written as a
+normal command.  It is therefore recognized and executed
+by the Shell.
+.SH "SEE ALSO"
+sh(1), pwd(1), chdir(2)

diff --git a/usr/man/man1/intro.1 b/usr/man/man1/intro.1
new file mode 100644 (file)
index 0000000..b45787a
--- /dev/null
+++ b/usr/man/man1/intro.1
@@ -0,0 +1,44 @@
+.TH INTRO 1 
+.SH NAME
+intro \- introduction to commands
+.SH DESCRIPTION
+This section describes publicly accessible commands
+in alphabetic order.
+Certain distinctions of purpose are made in the headings:
+.TP
+(1)
+Commands of general utility.
+.TP
+(1C)
+Commands for communication with other systems.
+.TP
+(1G)
+Commands used primarily for graphics and computer-aided design.
+.TP
+(1M)
+Commands used primarily for system maintenance.
+.PP
+The word `local' at the foot of a page means that the
+command is not intended for general distribution.
+.SH SEE ALSO
+.SH DIAGNOSTICS
+Section (6) for computer games.
+.PP
+.I How to get started,
+in the Introduction.
+.SH DIAGNOSTICS
+Upon termination each command returns two bytes of status,
+one supplied by the system giving the cause for
+termination, and (in the case of `normal' termination)
+one supplied by the program,
+see
+.I wait
+and
+.IR exit (2).
+The former byte is 0 for normal termination, the latter
+is customarily 0 for successful execution, nonzero
+to indicate troubles such as erroneous parameters, bad or inaccessible data,
+or other inability to cope with the task at hand.
+It is called variously `exit code', `exit status' or
+`return code', and is described only where special
+conventions are involved.

diff --git a/usr/man/man1/man.1 b/usr/man/man1/man.1
new file mode 100644 (file)
index 0000000..cadea03
--- /dev/null
+++ b/usr/man/man1/man.1
@@ -0,0 +1,99 @@
+.TH MAN 1
+.SH NAME
+man \- print sections of this manual
+.SH SYNOPSIS
+.B man
+[ option ... ] [ chapter ] title ...
+.SH DESCRIPTION
+.I Man
+locates and prints the section of this manual named
+.I title
+in the specified
+.IR chapter .
+(In this context, the word `page' is often used as a synonym for `section'.)\ 
+The
+.I title
+is entered in lower case.
+The
+.I chapter
+number does not need a letter suffix.
+If no
+.I chapter
+is specified, the whole manual is searched for
+.I title
+and all occurrences of it are printed.
+.PP
+.I Options
+and their meanings are:
+.TP 
+.B \-t
+Phototypeset the section using
+.IR troff (1).
+.TP
+.B \-n
+Print the section on the standard output using
+.IR nroff (1).
+.TP
+.B \-k
+Display the output on a Tektronix 4014 terminal using
+.IR troff (1)
+and
+.IR tc (1).
+.TP
+.B \-e
+Appended or prefixed to any of the above
+causes the manual section to be preprocessed by
+.I neqn
+or
+.IR eqn (1);
+.B \-e
+alone means
+.BR \-te .
+.TP
+.B \-w
+Print the path names of the manual sections,
+but do not print the sections themselves.
+.TP
+(default)
+Copy an already formatted manual section to the terminal,
+or, if none is available, act as
+.BR \-n .
+It may be necessary to use a filter to adapt the output to
+the
+particular terminal's characteristics.
+.PP
+Further
+.I options,
+e.g. to specify the kind of terminal you have,
+are passed on to
+.IR troff (1)
+or
+.IR nroff .
+.I Options
+and
+.I chapter
+may be changed before each
+.IR title .
+.PP
+For example:
+.IP
+man man
+.PP
+would reproduce this section,
+as well as any other sections named
+.I man
+that may exist in other chapters of the manual, e.g. 
+.IR man (7).
+.SH FILES
+/usr/man/man?/\(**
+.br
+/usr/man/cat?/\(**
+.SH "SEE ALSO"
+nroff(1),
+eqn(1),
+tc(1),
+man(7)
+.SH BUGS
+The manual is supposed to be reproducible either on
+a phototypesetter or on a terminal.
+However, on a terminal some information is necessarily lost.

diff --git a/usr/man/man1/wait.1 b/usr/man/man1/wait.1
new file mode 100644 (file)
index 0000000..16e92f2
--- /dev/null
+++ b/usr/man/man1/wait.1
@@ -0,0 +1,24 @@
+.TH WAIT 1 
+.SH NAME
+wait \- await completion of process
+.SH SYNOPSIS
+.B wait
+.SH DESCRIPTION
+Wait until all processes started with
+.B &
+have completed,
+and report on abnormal terminations.
+.PP
+Because the
+.IR  wait (2)
+system call
+must be executed in the parent process,
+the Shell itself executes
+.I wait,
+without creating a new process.
+.SH "SEE ALSO"
+sh(1)
+.SH BUGS
+Not all the processes of a 3- or more-stage
+pipeline are children of the Shell, and
+thus can't be waited for.