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

["Michael Kerrisk (man-pages)" <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>]

On 02/27/2015 01:26 AM, saulery-GANU6spQydw@public.gmane.org wrote:
> From: Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org>

Thanks, Stéphane. Applied.

Cheers,

Michael


> Signed-off-by: Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org>
> ---
>  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
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
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