From 95e2a96ad866ee2c3ce9226da37c3f470fcba4b2 Mon Sep 17 00:00:00 2001 From: Ken Thompson Date: Wed, 10 Jan 1979 15:16:07 -0500 Subject: [PATCH] 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 Synthesized-from: v7 --- usr/man/man1/arcv.1m | 22 ++++++++++ usr/man/man1/cd.1 | 20 +++++++++ usr/man/man1/intro.1 | 44 ++++++++++++++++++++ usr/man/man1/man.1 | 99 ++++++++++++++++++++++++++++++++++++++++++++ usr/man/man1/wait.1 | 24 +++++++++++ 5 files changed, 209 insertions(+) create mode 100644 usr/man/man1/arcv.1m create mode 100644 usr/man/man1/cd.1 create mode 100644 usr/man/man1/intro.1 create mode 100644 usr/man/man1/man.1 create mode 100644 usr/man/man1/wait.1 diff --git a/usr/man/man1/arcv.1m b/usr/man/man1/arcv.1m new file mode 100644 index 0000000000..095cdb324b --- /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 index 0000000000..9160ce776b --- /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 index 0000000000..b45787a94c --- /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 index 0000000000..cadea03708 --- /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 index 0000000000..16e92f248c --- /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. -- 2.20.1