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