1# man.conf from @version@
2#
3# For more information about this file, see the man pages man(1)
4# and man.conf(5).
5#
6# This file is read by man to configure the default manpath (also used
7# when MANPATH contains an empty substring), to find out where the cat
8# pages corresponding to given man pages should be stored,
9# and to map each PATH element to a manpath element.
10# It may also record the pathname of the man binary. [This is unused.]
11# The format is:
12#
13# MANBIN		pathname
14# MANPATH		manpath_element	[corresponding_catdir]
15# MANPATH_MAP		path_element	manpath_element
16#
17# If no catdir is given, it is assumed to be equal to the mandir
18# (so that this dir has both man1 etc. and cat1 etc. subdirs).
19# This is the traditional Unix setup.
20# Certain versions of the FSSTND recommend putting formatted versions
21# of /usr/.../man/manx/page.x into /var/catman/.../catx/page.x.
22# The keyword FSSTND will cause this behaviour.
23# Certain versions of the FHS recommend putting formatted versions of
24# /usr/.../share/man/[locale/]manx/page.x into
25# /var/cache/man/.../[locale/]catx/page.x.
26# The keyword FHS will cause this behaviour (and overrides FSSTND).
27# Explicitly given catdirs override.
28#
29@fsstnd@FSSTND
30@fhs@FHS
31#
32# This file is also read by man in order to find how to call nroff, less, etc.,
33# and to determine the correspondence between extensions and decompressors.
34#
35# MANBIN		/usr/local/bin/man
36#
37# Every automatically generated MANPATH includes these fields
38#
39MANPATH	/usr/share/man
40MANPATH	/usr/local/share/man
41MANPATH	/usr/X11/man
42#
43# Uncomment if you want to include one of these by default
44#
45# MANPATH	/opt/*/man
46# MANPATH	/usr/lib/*/man
47# MANPATH	/usr/share/*/man
48# MANPATH	/usr/kerberos/man
49#
50# Set up PATH to MANPATH mapping
51#
52# If people ask for "man foo" and have "/dir/bin/foo" in their PATH
53# and the docs are found in "/dir/man", then no mapping is required.
54#
55# The below mappings are superfluous when the right hand side is
56# in the mandatory manpath already, but will keep man from statting
57# lots of other nearby files and directories.
58#
59MANPATH_MAP	/bin			/usr/share/man
60MANPATH_MAP	/sbin			/usr/share/man
61MANPATH_MAP	/usr/bin		/usr/share/man
62MANPATH_MAP	/usr/sbin		/usr/share/man
63MANPATH_MAP	/usr/local/bin		/usr/local/share/man
64MANPATH_MAP	/usr/local/sbin		/usr/local/share/man
65MANPATH_MAP	/usr/X11/bin		/usr/X11/man
66MANPATH_MAP	/usr/bin/X11		/usr/X11/man
67MANPATH_MAP	/usr/bin/mh		/usr/share/man
68#
69# NOAUTOPATH keeps man from automatically adding directories that look like
70# manual page directories to the path.
71#
72#NOAUTOPATH
73#
74# NOCACHE keeps man from creating cache pages ("cat pages")
75# (generally one enables/disable cat page creation by creating/deleting
76# the directory they would live in - man never does mkdir)
77# 
78#NOCACHE
79#
80# Useful paths - note that COL should not be defined when
81# NROFF is defined as "groff -Tascii" or "groff -Tlatin1";
82# not only is it superfluous, but it actually damages the output.
83# For use with utf-8, NROFF should be "nroff -mandoc" without -T option.
84# (Maybe - but today I need -Tlatin1 to prevent double conversion to utf8.)
85#
86# If you have a new troff (version 1.18.1?) and its colored output
87# causes problems, add the -c option to TROFF, NROFF, JNROFF.
88#
89TROFF		@troff@
90NROFF		@nroff@
91JNROFF		@jnroff@
92EQN		@eqn@
93NEQN		@neqn@
94JNEQN		@jneqn@
95TBL		@tbl@
96@nocol@COL		@col@
97REFER		@refer@
98PIC		@pic@
99VGRIND		@vgrind@
100GRAP		@grap@
101PAGER		@pager@
102BROWSER		@browser@
103HTMLPAGER	@htmlpager@
104CAT		@cat@
105#
106# The command "man -a xyzzy" will show all man pages for xyzzy.
107# When CMP is defined man will try to avoid showing the same
108# text twice. (But compressed pages compare unequal.)
109#
110CMP		@cmp@
111#
112# Compress cat pages
113#
114COMPRESS	@compress@
115COMPRESS_EXT	@compress_ext@
116#
117# Default manual sections (and order) to search if -S is not specified
118# and the MANSECT environment variable is not set.
119#
120MANSECT		@sections@
121#
122# Default options to use when man is invoked without options
123# This is mainly for the benefit of those that think -a should be the default
124# Note that some systems have /usr/man/allman, causing pages to be shown twice.
125#
126#MANDEFOPTIONS	-a
127#
128# Decompress with given decompressor when input file has given extension
129# The command given must act as a filter.
130#
131.gz		@gunzip@
132.bz2		@bzip2@
133.z		@pcat@
134.Z		@zcat@
135.F		@fcat@
136.Y		@unyabba@
137