← Back to branch summary

~n3npq/lsb/fhs-spec

« back to all changes in this revision

Viewing changes to usr.xml

  • Committer: Mats Wichmann
  • Date: 2015-04-21 20:24:55 UTC
  • Revision ID: mats@linuxfoundation.org-20150421202455-99m8xy0i5jpa05cp
apply changes related to /usr/local/man (bug 798)

Show diffs side-by-side

added added

removed removed

Lines of Context:
usr.xml
504
504
<section id='usrlocalshare1'><title>/usr/local/share : Local architecture-independent hierarchy</title>
505
505
 
506
506
<para>The requirements for the contents of this directory are the same
507
 
as for <filename>/usr/share</filename>.  The only additional constraint is
 
507
as for <filename>/usr/share</filename>.  
 
508
<!-- dropped per bug 798
 
509
The only additional constraint is
508
510
that <filename>/usr/local/share/man</filename> and
509
511
<filename>/usr/local/man</filename> directories must be synonomous
510
512
(usually this means that one of them must be a symbolic link).
 
513
-->
511
514
 
 
515
<!-- bug 798: this note removed; deprecation note added for /usr/local/man
512
516
<footnote>
513
517
<para>
514
518
<filename>/usr/local/man</filename> may be deprecated in future FHS
516
520
sensible.
517
521
</para>
518
522
</footnote>
 
523
-->
519
524
</para>
520
525
</section>
521
526
 
921
926
<filename>/usr/share/&lt;mandir&gt;/&lt;locale&gt;</filename>, unless
922
927
they are empty:
923
928
 
924
 
<footnote><para>For example, if <filename>/usr/local/man</filename>
 
929
<footnote><para>For example, if <filename>/usr/share/man</filename>
925
930
has no manual pages in section 4 (Devices), then
926
 
<filename>/usr/local/man/man4</filename> may be omitted.</para>
 
931
<filename>/usr/share/man/man4</filename> may be omitted.</para>
927
932
</footnote></para>
928
933
 
929
934
<informaltable frame='none'>
1161
1166
 
1162
1167
<para>Manual pages for commands and data under
1163
1168
<filename>/usr/local</filename> are stored in
1164
 
<filename>/usr/local/man</filename>.  It follows that all
1165
 
manual page hierarchies in the system must have the same structure as
1166
 
<filename>/usr/share/man</filename>.</para>
 
1169
<filename>/usr/local/man</filename> or
 
1170
<filename>/usr/local/share/man</filename>.
 
1171
All manual page hierarchies in the system must have the same structure as
 
1172
<filename>/usr/share/man</filename>, as this structure is expected
 
1173
by commands which consume manual page content.
 
1174
<footnote>
 
1175
<para>
 
1176
<filename>/usr/local/man</filename> is deprecated and may be
 
1177
dropped in a future version of this specification.
 
1178
</para>
 
1179
</footnote>
 
1180
</para>
1167
1181
 
1168
1182
<para>The cat page sections (<filename>cat&lt;section&gt;</filename>)
1169
1183
containing formatted manual page entries are also found within