pages may omit the <TT
CLASS="FILENAME"
><locale></TT
> substring and
store all manual pages in <TT
CLASS="FILENAME"
><mandir></TT
>. For
example, systems which only have English manual pages coded with
ASCII, may store manual pages (the
<TT
CLASS="FILENAME"
>man<section></TT
> directories) directly in
<TT
CLASS="FILENAME"
>/usr/share/man</TT
>. (That is the traditional
circumstance and arrangement, in fact.)</P
><P
>Countries for which there is a well-accepted standard character
code set may omit the <TT
CLASS="FILENAME"
>­<character-set></TT
>
field, but it is strongly recommended that it be included, especially
for countries with several competing standards.</P
><P
>Various examples:</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><A
NAME="AEN1814"
></A
><TABLE
BORDER="0"
FRAME="void"
CLASS="CALSTABLE"
><COL
WIDTH="1*"
TITLE="C1"><COL
WIDTH="1*"
TITLE="C2"><COL
WIDTH="1*"
TITLE="C3"><COL
WIDTH="1*"
TITLE="C4"><THEAD
><TR
><TH
ALIGN="LEFT"
>Language</TH
><TH
ALIGN="LEFT"
>Territory</TH
><TH
ALIGN="LEFT"
>Character Set</TH
><TH
ALIGN="LEFT"
>Directory</TH
></TR
></THEAD
><TBODY
><TR
><TD
ALIGN="LEFT"
>English</TD
><TD
ALIGN="LEFT"
>—</TD
><TD
ALIGN="LEFT"
>ASCII</TD
><TD
ALIGN="LEFT"
>/usr/share/man/en</TD
></TR
><TR
><TD
ALIGN="LEFT"
>English</TD
><TD
ALIGN="LEFT"
>United Kingdom</TD
><TD
ALIGN="LEFT"
>ISO 8859-15</TD
><TD
ALIGN="LEFT"
>/usr/share/man/en_GB</TD
></TR
><TR
><TD
ALIGN="LEFT"
>English</TD
><TD
ALIGN="LEFT"
>United States</TD
><TD
ALIGN="LEFT"
>ASCII</TD
><TD
ALIGN="LEFT"
>/usr/share/man/en_US</TD
></TR
><TR
><TD
ALIGN="LEFT"
>French</TD
><TD
ALIGN="LEFT"
>Canada</TD
><TD
ALIGN="LEFT"
>ISO 8859-1</TD
><TD
ALIGN="LEFT"
>/usr/share/man/fr_CA</TD
></TR
><TR
><TD
ALIGN="LEFT"
>French</TD
><TD
ALIGN="LEFT"
>France</TD
><TD
ALIGN="LEFT"
>ISO 8859-1</TD
><TD
ALIGN="LEFT"
>/usr/share/man/fr_FR</TD
></TR
><TR
><TD
ALIGN="LEFT"
>German</TD
><TD
ALIGN="LEFT"
>Germany</TD
><TD
ALIGN="LEFT"
>ISO 646</TD
><TD
ALIGN="LEFT"
>/usr/share/man/de_DE.646</TD
></TR
><TR
><TD
ALIGN="LEFT"
>German</TD
><TD
ALIGN="LEFT"
>Germany</TD
><TD
ALIGN="LEFT"
>ISO 6937</TD
><TD
ALIGN="LEFT"
>/usr/share/man/de_DE.6937</TD
></TR
><TR
><TD
ALIGN="LEFT"
>German</TD
><TD
ALIGN="LEFT"
>Germany</TD
><TD
ALIGN="LEFT"
>ISO 8859-1</TD
><TD
ALIGN="LEFT"
>/usr/share/man/de_DE.88591</TD
></TR
><TR
><TD
ALIGN="LEFT"
>German</TD
><TD
ALIGN="LEFT"
>Switzerland</TD
><TD
ALIGN="LEFT"
>ISO 646</TD
><TD
ALIGN="LEFT"
>/usr/share/man/de_CH.646</TD
></TR
><TR
><TD
ALIGN="LEFT"
>Japanese</TD
><TD
ALIGN="LEFT"
>Japan</TD
><TD
ALIGN="LEFT"
>JIS</TD
><TD
ALIGN="LEFT"
>/usr/share/man/ja_JP.jis</TD
></TR
><TR
><TD
ALIGN="LEFT"
>Japanese</TD
><TD
ALIGN="LEFT"
>Japan</TD
><TD
ALIGN="LEFT"
>SJIS</TD
><TD
ALIGN="LEFT"
>/usr/share/man/ja_JP.sjis</TD
></TR
><TR
><TD
ALIGN="LEFT"
>Japanese</TD
><TD
ALIGN="LEFT"
>Japan</TD
><TD
ALIGN="LEFT"
>UJIS (or EUC-J)</TD
><TD
ALIGN="LEFT"
>/usr/share/man/ja_JP.ujis</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
><P
>Similarly, provision must be made for manual pages which are
architecture-dependent, such as documentation on device-drivers or
low-level system administration commands. These must be placed under
an <TT
CLASS="FILENAME"
><arch></TT
> directory in the appropriate
<TT
CLASS="FILENAME"
>man<section></TT
> directory; for example, a man
page for the i386 ctrlaltdel(8) command might be placed in
<TT
CLASS="FILENAME"
>/usr/share/man/<locale>/man8/i386/ctrlaltdel.8</TT
>.</P
><P
>Manual pages for commands and data under
<TT
CLASS="FILENAME"
>/usr/local</TT
> are stored in
<TT
CLASS="FILENAME"
>/usr/local/man</TT
>. Manual pages for X11R6 are
stored in <TT
CLASS="FILENAME"
>/usr/X11R6/man</TT
>. It follows that all
manual page hierarchies in the system must have the same structure as
<TT
CLASS="FILENAME"
>/usr/share/man</TT
>.</P
><P
>The cat page sections (<TT
CLASS="FILENAME"
>cat<section></TT
>)
containing formatted manual page entries are also found within
subdirectories of <TT
CLASS="FILENAME"
><mandir>/<locale></TT
>,
but are not required nor may they be distributed in lieu of nroff
source manual pages.</P
><P
>The numbered sections "1" through "8" are traditionally defined.
In general, the file name for manual pages located within a particular
section end with <TT
CLASS="FILENAME"
>.<section></TT
>.</P
><P
>In addition, some large sets of application-specific manual
pages have an additional suffix appended to the manual page filename.
For example, the MH mail handling system manual pages must have
<TT
CLASS="FILENAME"
>mh</TT
> appended to all MH manuals. All X Window
System manual pages must have an <TT
CLASS="FILENAME"
>x</TT
> appended to
the filename.</P
><P
>The practice of placing various language manual pages in
appropriate subdirectories of <TT
CLASS="FILENAME"
>/usr/share/man</TT
> also
applies to the other manual page hierarchies, such as
<TT
CLASS="FILENAME"
>/usr/local/man</TT
> and
<TT
CLASS="FILENAME"
>/usr/X11R6/man</TT
>. (This portion of the standard
also applies later in the section on the optional
<TT
CLASS="FILENAME"
>/var/cache/man</TT
> structure.)</P
></DIV
></DIV
><DIV
CLASS="SECTION"
><HR><H3
CLASS="SECTION"
><A
NAME="USRSHAREMISCMISCELLANEOUSARCHITECTURE"
>/usr/share/misc : Miscellaneous architecture-independent data</A
></H3
><P
>This directory contains miscellaneous architecture-independent
files which don't require a separate subdirectory under
<TT
CLASS="FILENAME"
>/usr/share</TT
>.</P
><DIV
CLASS="SECTION"
><HR><H4
CLASS="SECTION"
><A
NAME="SPECIFICOPTIONS18"
>Specific Options</A
></H4
><P
>The following files, or symbolic links to files, must be in
<TT
CLASS="FILENAME"
>/usr/share/misc</TT
>, if the corresponding subsystem
is installed:</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><A
NAME="AEN1917"
></A
><TABLE
BORDER="0"
FRAME="void"
CLASS="CALSTABLE"
><COL
WIDTH="1*"
TITLE="C1"><COL
WIDTH="1*"
TITLE="C2"><THEAD
><TR
><TH
>File</TH
><TH
>Description</TH
></TR
></THEAD
><TBODY
><TR
><TD
><TT
CLASS="FILENAME"
>ascii</TT
></TD
><TD
>ASCII character set table (optional)</TD
></TR
><TR
><TD
><TT
CLASS="FILENAME"
>magic</TT
></TD
><TD
>Default list of magic numbers for the file command (optional)</TD
Back to home |
File page
Subscribe |
Register |
Login
| N