[schilytools] man page sections

[Friedhelm Mehnert]

Looking at the various man pages I find that these sometimes use
"strange" section numbers like "1L".

This is what "man man" says on Linux:

> The table below shows the section numbers of the manual followed by
> the  types  of  pages they contain.
>
>        1   Executable programs or shell commands
>        2   System calls (functions provided by the kernel)
>        3   Library calls (functions within program libraries)
>        4   Special files (usually found in /dev)
>        5   File formats and conventions, e.g. /etc/passwd
>        6   Games
>        7   Miscellaneous (including macro packages and conventions), e.g. man(7), groff(7)
>        8   System administration commands (usually only for root)
>        9   Kernel routines [Non standard]

Looking at the BSDs, this is what I find at the net:

> The man utility finds and displays online manual documentation pages.
> If mansect is provided, man restricts the search to the specific
> section of the manual.
>
>      The sections of the manual are:
>            1.   FreeBSD General Commands Manual
>            2.   FreeBSD System Calls Manual
>            3.   FreeBSD Library Functions Manual
>            4.   FreeBSD Kernel Interfaces Manual
>            5.   FreeBSD File Formats Manual
>            6.   FreeBSD Games Manual
>            7.   FreeBSD Miscellaneous Information Manual
>            8.   FreeBSD System Manager's Manual
>            9.   FreeBSD Kernel Developer's Manual

Solaris used to have different sections, but they switched a long time
ago to be compatible with the above systems.

Don't know about other systems.

I think the man pages should be changed to conform to the above if
possible.

Also I noticed, that Jörg has put programs and daemons that require root
like "btcflash" or "rscsi" into section 1 and titled it "User Commands".
I think these should go into section 8 instead.


Best Regards
Friedhelm