aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-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