CLASS="FILENAME"
><mandir></TT
>,
<TT
CLASS="FILENAME"
><locale></TT
>,
<TT
CLASS="FILENAME"
><section></TT
>, and
<TT
CLASS="FILENAME"
><arch></TT
> is given below.</P
><P
>A description of each section follows:</P
><P
></P
><UL
><LI
STYLE="list-style-type: disc"
><P
><TT
CLASS="FILENAME"
>man1</TT
>: User programs
Manual pages that describe publicly accessible commands are contained in
this chapter. Most program documentation that a user will need to use
is located here.</P
></LI
><LI
STYLE="list-style-type: disc"
><P
><TT
CLASS="FILENAME"
>man2</TT
>: System calls
This section describes all of the system calls (requests for the
kernel to perform operations).</P
></LI
><LI
STYLE="list-style-type: disc"
><P
><TT
CLASS="FILENAME"
>man3</TT
>: Library functions and subroutines
Section 3 describes program library routines that are not direct calls
to kernel services. This and chapter 2 are only really of interest to
programmers.</P
></LI
><LI
STYLE="list-style-type: disc"
><P
><TT
CLASS="FILENAME"
>man4</TT
>: Special files
Section 4 describes the special files, related driver functions, and
networking support available in the system. Typically, this includes
the device files found in <TT
CLASS="FILENAME"
>/dev</TT
> and the kernel interface to
networking protocol support.</P
></LI
><LI
STYLE="list-style-type: disc"
><P
><TT
CLASS="FILENAME"
>man5</TT
>: File formats
The formats for many data files are documented in the
section 5. This includes various include files, program output files,
and system files.</P
></LI
><LI
STYLE="list-style-type: disc"
><P
><TT
CLASS="FILENAME"
>man6</TT
>: Games
This chapter documents games, demos, and generally trivial programs.
Different people have various notions about how essential this is.</P
></LI
><LI
STYLE="list-style-type: disc"
><P
><TT
CLASS="FILENAME"
>man7</TT
>: Miscellaneous
Manual pages that are difficult to classify are designated as being
section 7. The troff and other text processing macro packages are found
here.</P
></LI
><LI
STYLE="list-style-type: disc"
><P
><TT
CLASS="FILENAME"
>man8</TT
>: System administration
Programs used by system administrators for system operation and
maintenance are documented here. Some of these programs are also
occasionally useful for normal users.</P
></LI
></UL
></DIV
><DIV
CLASS="SECTION"
><HR><H4
CLASS="SECTION"
><A
NAME="SPECIFICOPTIONS17"
>Specific Options</A
></H4
><P
>The following directories, or symbolic links to directories,
must be in
<TT
CLASS="FILENAME"
>/usr/share/<mandir>/<locale></TT
>, unless
they are empty:
<A
NAME="AEN1741"
HREF="#FTN.AEN1741"
><SPAN
CLASS="footnote"
>[32]</SPAN
></A
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><A
NAME="AEN1745"
></A
><TABLE
BORDER="0"
FRAME="void"
CLASS="CALSTABLE"
><COL><COL><THEAD
><TR
><TH
>Directory</TH
><TH
>Description</TH
></TR
></THEAD
><TBODY
><TR
><TD
><TT
CLASS="FILENAME"
>man1</TT
></TD
><TD
>User programs (optional)</TD
></TR
><TR
><TD
><TT
CLASS="FILENAME"
>man2</TT
></TD
><TD
>System calls (optional)</TD
></TR
><TR
><TD
><TT
CLASS="FILENAME"
>man3</TT
></TD
><TD
>Library calls (optional)</TD
></TR
><TR
><TD
><TT
CLASS="FILENAME"
>man4</TT
></TD
><TD
>Special files (optional)</TD
></TR
><TR
><TD
><TT
CLASS="FILENAME"
>man5</TT
></TD
><TD
>File formats (optional)</TD
></TR
><TR
><TD
><TT
CLASS="FILENAME"
>man6</TT
></TD
><TD
>Games (optional)</TD
></TR
><TR
><TD
><TT
CLASS="FILENAME"
>man7</TT
></TD
><TD
>Miscellaneous (optional)</TD
></TR
><TR
><TD
><TT
CLASS="FILENAME"
>man8</TT
></TD
><TD
>System administration (optional)</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
><P
>The component <TT
CLASS="FILENAME"
><section></TT
> describes the
manual section.</P
><P
>Provisions must be made in the structure of
<TT
CLASS="FILENAME"
>/usr/share/man</TT
> to support manual pages which are
written in different (or multiple) languages. These provisions must
take into account the storage and reference of these manual pages.
Relevant factors include language (including geographical-based
differences), and character code set.</P
><P
>This naming of language subdirectories of
<TT
CLASS="FILENAME"
>/usr/share/man</TT
> is based on Appendix E of the
POSIX 1003.1 standard which describes the locale identification string
— the most well-accepted method to describe a cultural
environment. The <TT
CLASS="FILENAME"
><locale></TT
> string
is:</P
><P
><TT
CLASS="FILENAME"
><language>[_<territory>][.<character-set>][,<version>]</TT
></P
><P
>The <TT
CLASS="FILENAME"
><language></TT
> field must be taken
from ISO 639 (a code for the representation of names of languages).
It must be two characters wide and specified with lowercase letters
only.</P
><P
>The <TT
CLASS="FILENAME"
><territory></TT
> field must be the
two-letter code of ISO 3166 (a specification of representations of
countries), if possible. (Most people are familiar with the
two-letter codes used for the country codes in email addresses.) It
must be two characters wide and specified with uppercase letters
only.
<A
NAME="AEN1797"
HREF="#FTN.AEN1797"
><SPAN
CLASS="footnote"
>[33]</SPAN
></A
></P
><P
>The <TT
CLASS="FILENAME"
><character-set></TT
> field must
represent the standard describing the character set. If the
<TT
CLASS="FILENAME"
>­<character-set></TT
> field is just a
numeric specification, the number represents the number of the
international standard describing the character set. It is
recommended that this be a numeric representation if possible (ISO
standards, especially), not include additional punctuation symbols,
and that any letters be in lowercase.</P
><P
>A parameter specifying a <TT
CLASS="FILENAME"
><version></TT
> of
the profile may be placed after the
<TT
CLASS="FILENAME"
>­<character-set></TT
> field, delimited by a
comma. This may be used to discriminate between different cultural
needs; for instance, dictionary order versus a more systems-oriented
collating order. This standard recommends not using the
<TT
CLASS="FILENAME"
><version></TT
> field, unless it is
necessary.</P
><P
>Systems which use a unique language and code set for all manual