From db6642bdb2aa29b356ea61857623bc72793c3870 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phane=20Aulery?= Date: Fri, 27 Feb 2015 01:26:16 +0100 Subject: [PATCH] man-pages.7: Improve description of sections in accordance with intro pages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Stéphane Aulery Signed-off-by: Michael Kerrisk --- 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 2b705c753..0cd84daa2 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