diff options
| author | Michael Kerrisk <mtk.manpages@gmail.com> | 2007-10-23 14:48:10 +0000 |
|---|---|---|
| committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2007-10-23 14:48:10 +0000 |
| commit | f45a07b62cf3fe033d7ec5ced9ca8646cb8bc8f6 (patch) | |
| tree | 866a1ff010dcbda36c7ed7aec5ffc2af3fc657c5 /man1/intro.1 | |
| parent | ab81273bda6c7ea721251ee928ac3cf5907fb758 (diff) | |
| download | man-pages-f45a07b62cf3fe033d7ec5ced9ca8646cb8bc8f6.tar.gz | |
Added intro paragraph about section, plus a paragraph
about exit status values. Move "user intro" text to NOTES.
Diffstat (limited to 'man1/intro.1')
| -rw-r--r-- | man1/intro.1 | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/man1/intro.1 b/man1/intro.1 index 1e7d02f0da..b2088cddf0 100644 --- a/man1/intro.1 +++ b/man1/intro.1 @@ -20,10 +20,30 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" 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" .SH NAME intro \- Introduction to user commands .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 all user commands under Unix work precisely the same under Linux (and FreeBSD and lots of other Unix-like systems). |