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

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



From: Stéphane Aulery <saulery@xxxxxxx>

Signed-off-by: Stéphane Aulery <saulery@xxxxxxx>
---
 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@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux