Thread (1 message) 1 message, 1 author, 2015-02-27
DORMANTno replies

[patch] man-pages.7: improve the definition of sections in accordance with intro pages

From: <hidden>
Date: 2015-02-27 00:26:16
Subsystem: the rest · Maintainer: Linus Torvalds

Possibly related (same subject, not in this thread)

From: Stéphane Aulery <redacted>

Signed-off-by: Stéphane Aulery <redacted>
---
 man7/man-pages.7 | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)
diff --git a/man7/man-pages.7 b/man7/man-pages.7
index ceead84..e17434e 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
-- 
2.1.4

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help