Added intro paragraph about section, plus a paragraph

about exit status values.  Move "user intro" text to NOTES.
This commit is contained in:
Michael Kerrisk 2007-10-23 14:48:10 +00:00
parent ab81273bda
commit f45a07b62c
1 changed files with 20 additions and 0 deletions

View File

@ -20,10 +20,30 @@
.\" Formatted or processed versions of this manual, if unaccompanied by .\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" 2007-10-23 mtk Added intro paragraph about section, plus a paragraph
.\" about exit status values.
.\"
.TH INTRO 1 2002-08-06 "Linux" "Linux User's Manual" .TH INTRO 1 2002-08-06 "Linux" "Linux User's Manual"
.SH NAME .SH NAME
intro \- Introduction to user commands intro \- Introduction to user commands
.SH DESCRIPTION .SH DESCRIPTION
Section 1 of the manual describes user commands and tools,
for example, file manipulation tools, shells, compilers,
web browsers, file and image viewers and editors, and so on.
All commands yield a status value on termination.
This value can be tested (e.g., in most shells the variable
.I $?
contains the status of the last executed command)
to see whether the command completed successfully.
A zero exit status is conventionally used to indicate success,
and a non-zero status means that the command was unsuccessful.
(Details of the exit status can be found in
.BR wait (2).)
A non-zero exit status can be in the range 1 to 255, and some commands
use different non-zero status values to indicate the reason why the
command failed.
.SH NOTES
Linux is a flavor of Unix, and as a first approximation Linux is a flavor of Unix, and as a first approximation
all user commands under Unix work precisely the same under all user commands under Unix work precisely the same under
Linux (and FreeBSD and lots of other Unix-like systems). Linux (and FreeBSD and lots of other Unix-like systems).