aboutsummaryrefslogtreecommitdiffstats
path: root/man7/man-pages.7
diff options
context:
space:
mode:
authorStéphane Aulery <saulery@free.fr>2015-02-27 01:26:16 +0100
committerMichael Kerrisk <mtk.manpages@gmail.com>2015-03-02 17:25:57 +0100
commitdb6642bdb2aa29b356ea61857623bc72793c3870 (patch)
treea0f22a642581e01c4ca79b98de4a7dddddf5b851 /man7/man-pages.7
parentf8db29e89c3fa7ec1354c38871f77d755bc0965a (diff)
downloadman-pages-db6642bdb2aa29b356ea61857623bc72793c3870.tar.gz
man-pages.7: Improve description of sections in accordance with intro pages
Signed-off-by: Stéphane Aulery <saulery@free.fr> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man7/man-pages.7')
-rw-r--r--man7/man-pages.724
1 files changed, 13 insertions, 11 deletions
diff --git a/man7/man-pages.7 b/man7/man-pages.7
index 2b705c753e..0cd84daa2f 100644
--- a/man7/man-pages.7
+++ b/man7/man-pages.7
@@ -48,32 +48,34 @@ for authors writing man pages for other projects.
.PP
The manual Sections are traditionally defined as follows:
.TP 10
-.B 1 Commands (Programs)
+.B 1 User commands (Programs)
Those commands that can be executed by the user from within
a shell.
.TP
.B 2 System calls
-Those functions which must be performed by the kernel.
+Those functions which wrap operations performed by the kernel.
.TP
.B 3 Library calls
-Most of the
+All library functions excluding the system call wrappers
+(Most of the
.I libc
-functions.
+functions).
.TP
.B 4 Special files (devices)
Files found in
-.IR /dev .
+.I /dev
+which allow to access to devices through the kernel.
.TP
-.B 5 File formats and conventions
-The format for
-.I /etc/passwd
-and other human-readable files.
+.B 5 File formats and configuration
+Describes various human-readable file formats and configuration files.
.TP
.B 6 Games
+Games and funny little programs available on the system.
.TP
.B 7 Overview, conventions, and miscellaneous
-Overviews of various topics, conventions and protocols,
-character set standards, and miscellaneous other things.
+Overviews or descriptions of various topics, conventions and protocols,
+character set standards, the standard filesystem layout, and miscellaneous
+other things.
.TP
.B 8 System management commands
Commands like