head 1.30; access; symbols netbsd-9-4-RELEASE:1.27 netbsd-10-0-RELEASE:1.30 netbsd-10-0-RC6:1.30 netbsd-10-0-RC5:1.30 netbsd-10-0-RC4:1.30 netbsd-10-0-RC3:1.30 netbsd-10-0-RC2:1.30 netbsd-10-0-RC1:1.30 netbsd-10:1.30.0.2 netbsd-10-base:1.30 netbsd-9-3-RELEASE:1.27 cjep_sun2x-base1:1.27 cjep_sun2x:1.27.0.24 cjep_sun2x-base:1.27 cjep_staticlib_x-base1:1.27 netbsd-9-2-RELEASE:1.27 cjep_staticlib_x:1.27.0.22 cjep_staticlib_x-base:1.27 netbsd-9-1-RELEASE:1.27 phil-wifi-20200421:1.27 phil-wifi-20200411:1.27 is-mlppp:1.27.0.20 is-mlppp-base:1.27 phil-wifi-20200406:1.27 netbsd-8-2-RELEASE:1.27 netbsd-9-0-RELEASE:1.27 netbsd-9-0-RC2:1.27 netbsd-9-0-RC1:1.27 phil-wifi-20191119:1.27 netbsd-9:1.27.0.18 netbsd-9-base:1.27 phil-wifi-20190609:1.27 netbsd-8-1-RELEASE:1.27 netbsd-8-1-RC1:1.27 pgoyette-compat-merge-20190127:1.27 pgoyette-compat-20190127:1.27 pgoyette-compat-20190118:1.27 pgoyette-compat-1226:1.27 pgoyette-compat-1126:1.27 pgoyette-compat-1020:1.27 pgoyette-compat-0930:1.27 pgoyette-compat-0906:1.27 netbsd-7-2-RELEASE:1.24.6.1 pgoyette-compat-0728:1.27 netbsd-8-0-RELEASE:1.27 phil-wifi:1.27.0.16 phil-wifi-base:1.27 pgoyette-compat-0625:1.27 netbsd-8-0-RC2:1.27 pgoyette-compat-0521:1.27 pgoyette-compat-0502:1.27 pgoyette-compat-0422:1.27 netbsd-8-0-RC1:1.27 pgoyette-compat-0415:1.27 pgoyette-compat-0407:1.27 pgoyette-compat-0330:1.27 pgoyette-compat-0322:1.27 pgoyette-compat-0315:1.27 netbsd-7-1-2-RELEASE:1.24.6.1 pgoyette-compat:1.27.0.14 pgoyette-compat-base:1.27 netbsd-7-1-1-RELEASE:1.24.6.1 matt-nb8-mediatek:1.27.0.12 matt-nb8-mediatek-base:1.27 perseant-stdc-iso10646:1.27.0.10 perseant-stdc-iso10646-base:1.27 netbsd-8:1.27.0.8 netbsd-8-base:1.27 prg-localcount2-base3:1.27 prg-localcount2-base2:1.27 prg-localcount2-base1:1.27 prg-localcount2:1.27.0.6 prg-localcount2-base:1.27 pgoyette-localcount-20170426:1.27 bouyer-socketcan-base1:1.27 pgoyette-localcount-20170320:1.27 netbsd-7-1:1.24.6.1.0.6 netbsd-7-1-RELEASE:1.24.6.1 netbsd-7-1-RC2:1.24.6.1 netbsd-7-nhusb-base-20170116:1.24.6.1 bouyer-socketcan:1.27.0.4 bouyer-socketcan-base:1.27 pgoyette-localcount-20170107:1.27 netbsd-7-1-RC1:1.24.6.1 pgoyette-localcount-20161104:1.27 netbsd-7-0-2-RELEASE:1.24.6.1 localcount-20160914:1.27 netbsd-7-nhusb:1.24.6.1.0.4 netbsd-7-nhusb-base:1.24.6.1 pgoyette-localcount-20160806:1.27 pgoyette-localcount-20160726:1.27 pgoyette-localcount:1.27.0.2 pgoyette-localcount-base:1.27 netbsd-7-0-1-RELEASE:1.24.6.1 netbsd-7-0:1.24.6.1.0.2 netbsd-7-0-RELEASE:1.24.6.1 netbsd-7-0-RC3:1.24.6.1 netbsd-7-0-RC2:1.24.6.1 netbsd-7-0-RC1:1.24.6.1 netbsd-5-2-3-RELEASE:1.20 netbsd-5-1-5-RELEASE:1.20 netbsd-6-0-6-RELEASE:1.21 netbsd-6-1-5-RELEASE:1.21 netbsd-7:1.24.0.6 netbsd-7-base:1.24 yamt-pagecache-base9:1.24 yamt-pagecache-tag8:1.20.34.2 netbsd-6-1-4-RELEASE:1.21 netbsd-6-0-5-RELEASE:1.21 tls-earlyentropy:1.24.0.4 tls-earlyentropy-base:1.24 riastradh-xf86-video-intel-2-7-1-pre-2-21-15:1.24 riastradh-drm2-base3:1.24 netbsd-6-1-3-RELEASE:1.21 netbsd-6-0-4-RELEASE:1.21 netbsd-5-2-2-RELEASE:1.20 netbsd-5-1-4-RELEASE:1.20 netbsd-6-1-2-RELEASE:1.21 netbsd-6-0-3-RELEASE:1.21 netbsd-5-2-1-RELEASE:1.20 netbsd-5-1-3-RELEASE:1.20 netbsd-6-1-1-RELEASE:1.21 riastradh-drm2-base2:1.24 riastradh-drm2-base1:1.24 riastradh-drm2:1.24.0.2 riastradh-drm2-base:1.24 netbsd-6-1:1.21.0.8 netbsd-6-0-2-RELEASE:1.21 netbsd-6-1-RELEASE:1.21 netbsd-6-1-RC4:1.21 netbsd-6-1-RC3:1.21 agc-symver:1.22.0.6 agc-symver-base:1.22 netbsd-6-1-RC2:1.21 netbsd-6-1-RC1:1.21 yamt-pagecache-base8:1.22 netbsd-5-2:1.20.0.36 netbsd-6-0-1-RELEASE:1.21 yamt-pagecache-base7:1.22 netbsd-5-2-RELEASE:1.20 netbsd-5-2-RC1:1.20 matt-nb6-plus-nbase:1.21 yamt-pagecache-base6:1.22 netbsd-6-0:1.21.0.6 netbsd-6-0-RELEASE:1.21 netbsd-6-0-RC2:1.21 tls-maxphys:1.22.0.2 tls-maxphys-base:1.24 matt-nb6-plus:1.21.0.4 matt-nb6-plus-base:1.21 netbsd-6-0-RC1:1.21 yamt-pagecache-base5:1.22 yamt-pagecache-base4:1.21 netbsd-6:1.21.0.2 netbsd-6-base:1.21 netbsd-5-1-2-RELEASE:1.20 netbsd-5-1-1-RELEASE:1.20 yamt-pagecache-base3:1.20 yamt-pagecache-base2:1.20 yamt-pagecache:1.20.0.34 yamt-pagecache-base:1.20 cherry-xenmp:1.20.0.32 cherry-xenmp-base:1.20 bouyer-quota2-nbase:1.20 bouyer-quota2:1.20.0.30 bouyer-quota2-base:1.20 matt-mips64-premerge-20101231:1.20 matt-nb5-mips64-premerge-20101231:1.20 matt-nb5-pq3:1.20.0.28 matt-nb5-pq3-base:1.20 netbsd-5-1:1.20.0.26 netbsd-5-1-RELEASE:1.20 netbsd-5-1-RC4:1.20 matt-nb5-mips64-k15:1.20 netbsd-5-1-RC3:1.20 netbsd-5-1-RC2:1.20 netbsd-5-1-RC1:1.20 netbsd-5-0-2-RELEASE:1.20 matt-nb5-mips64-premerge-20091211:1.20 matt-premerge-20091211:1.20 matt-nb5-mips64-u2-k2-k4-k7-k8-k9:1.20 matt-nb4-mips64-k7-u2a-k9b:1.20 matt-nb5-mips64-u1-k1-k5:1.20 matt-nb5-mips64:1.20.0.24 netbsd-5-0-1-RELEASE:1.20 jym-xensuspend-nbase:1.20 netbsd-5-0:1.20.0.22 netbsd-5-0-RELEASE:1.20 netbsd-5-0-RC4:1.20 netbsd-5-0-RC3:1.20 netbsd-5-0-RC2:1.20 jym-xensuspend:1.20.0.20 jym-xensuspend-base:1.20 netbsd-5-0-RC1:1.20 netbsd-5:1.20.0.18 netbsd-5-base:1.20 matt-mips64-base2:1.20 matt-mips64:1.20.0.16 mjf-devfs2:1.20.0.14 mjf-devfs2-base:1.20 netbsd-4-0-1-RELEASE:1.19 wrstuden-revivesa-base-3:1.20 wrstuden-revivesa-base-2:1.20 wrstuden-fixsa-newbase:1.19 wrstuden-revivesa-base-1:1.20 yamt-pf42-base4:1.20 yamt-pf42-base3:1.20 hpcarm-cleanup-nbase:1.20 yamt-pf42-baseX:1.20 yamt-pf42-base2:1.20 wrstuden-revivesa:1.20.0.12 wrstuden-revivesa-base:1.20 yamt-pf42:1.20.0.10 yamt-pf42-base:1.20 keiichi-mipv6-nbase:1.20 keiichi-mipv6:1.20.0.8 keiichi-mipv6-base:1.20 matt-armv6-nbase:1.20 matt-armv6-prevmlocking:1.20 wrstuden-fixsa-base-1:1.19 netbsd-4-0:1.19.0.10 netbsd-4-0-RELEASE:1.19 cube-autoconf:1.20.0.6 cube-autoconf-base:1.20 netbsd-4-0-RC5:1.19 netbsd-4-0-RC4:1.19 netbsd-4-0-RC3:1.19 netbsd-4-0-RC2:1.19 netbsd-4-0-RC1:1.19 matt-armv6:1.20.0.4 matt-armv6-base:1.20 matt-mips64-base:1.20 hpcarm-cleanup:1.20.0.2 hpcarm-cleanup-base:1.20 netbsd-3-1-1-RELEASE:1.16 netbsd-3-0-3-RELEASE:1.16 wrstuden-fixsa:1.19.0.8 wrstuden-fixsa-base:1.19 abandoned-netbsd-4-base:1.19 abandoned-netbsd-4:1.19.0.4 netbsd-3-1:1.16.0.12 netbsd-3-1-RELEASE:1.16 netbsd-3-0-2-RELEASE:1.16 netbsd-3-1-RC4:1.16 netbsd-3-1-RC3:1.16 netbsd-3-1-RC2:1.16 netbsd-3-1-RC1:1.16 netbsd-4:1.19.0.6 netbsd-4-base:1.19 chap-midi-nbase:1.19 netbsd-3-0-1-RELEASE:1.16 chap-midi:1.19.0.2 chap-midi-base:1.19 netbsd-3-0:1.16.0.10 netbsd-3-0-RELEASE:1.16 netbsd-3-0-RC6:1.16 netbsd-3-0-RC5:1.16 netbsd-3-0-RC4:1.16 netbsd-3-0-RC3:1.16 netbsd-3-0-RC2:1.16 netbsd-3-0-RC1:1.16 netbsd-2-0-3-RELEASE:1.16 netbsd-2-1:1.16.0.8 netbsd-2-1-RELEASE:1.16 netbsd-2-1-RC6:1.16 netbsd-2-1-RC5:1.16 netbsd-2-1-RC4:1.16 netbsd-2-1-RC3:1.16 netbsd-2-1-RC2:1.16 netbsd-2-1-RC1:1.16 netbsd-2-0-2-RELEASE:1.16 netbsd-3:1.16.0.6 netbsd-3-base:1.16 netbsd-2-0-1-RELEASE:1.16 netbsd-2:1.16.0.4 netbsd-2-base:1.16 netbsd-2-0-RELEASE:1.16 netbsd-2-0-RC5:1.16 netbsd-2-0-RC4:1.16 netbsd-2-0-RC3:1.16 netbsd-2-0-RC2:1.16 netbsd-2-0-RC1:1.16 netbsd-2-0:1.16.0.2 netbsd-2-0-base:1.16 netbsd-1-6-PATCH002-RELEASE:1.14 netbsd-1-6-PATCH002:1.14 netbsd-1-6-PATCH002-RC4:1.14 netbsd-1-6-PATCH002-RC3:1.14 netbsd-1-6-PATCH002-RC2:1.14 netbsd-1-6-PATCH002-RC1:1.14 netbsd-1-6-PATCH001:1.14 netbsd-1-6-PATCH001-RELEASE:1.14 netbsd-1-6-PATCH001-RC3:1.14 netbsd-1-6-PATCH001-RC2:1.14 netbsd-1-6-PATCH001-RC1:1.14 fvdl_fs64_base:1.15 netbsd-1-6-RELEASE:1.14 netbsd-1-6-RC3:1.14 netbsd-1-6-RC2:1.14 netbsd-1-6-RC1:1.14 netbsd-1-6:1.14.0.2 netbsd-1-6-base:1.14 netbsd-1-5-PATCH003:1.8 netbsd-1-5-PATCH002:1.8 netbsd-1-5-PATCH001:1.8 netbsd-1-5-RELEASE:1.8 netbsd-1-5-BETA2:1.8 netbsd-1-5-BETA:1.8 netbsd-1-4-PATCH003:1.5.2.1 netbsd-1-5-ALPHA2:1.8 netbsd-1-5:1.8.0.2 netbsd-1-5-base:1.8 minoura-xpg4dl-base:1.7 minoura-xpg4dl:1.7.0.2 netbsd-1-4-PATCH002:1.5 wrstuden-devbsize-19991221:1.7 wrstuden-devbsize:1.6.0.4 wrstuden-devbsize-base:1.7 comdex-fall-1999:1.6.0.2 comdex-fall-1999-base:1.6 netbsd-1-4-PATCH001:1.5 netbsd-1-4-RELEASE:1.5 netbsd-1-4:1.5.0.2 netbsd-1-4-base:1.5 netbsd-1-3-PATCH003:1.4 netbsd-1-3-PATCH003-CANDIDATE2:1.4 netbsd-1-3-PATCH003-CANDIDATE1:1.4 netbsd-1-3-PATCH003-CANDIDATE0:1.4 netbsd-1-3-PATCH002:1.4 netbsd-1-3-PATCH001:1.4 netbsd-1-3-RELEASE:1.4 netbsd-1-3-BETA:1.4 netbsd-1-3:1.4.0.2 netbsd-1-3-base:1.4 netbsd-1-2-PATCH001:1.3 netbsd-1-2-RELEASE:1.3 netbsd-1-2-BETA:1.3 netbsd-1-2:1.3.0.6 netbsd-1-2-base:1.3 netbsd-1-1-PATCH001:1.3 netbsd-1-1-RELEASE:1.3 netbsd-1-1:1.3.0.2 netbsd-1-1-base:1.3 lite-2:1.1.1.1 lite-1:1.1.1.1 CSRG:1.1.1 netbsd-1-0-PATCH06:1.2 netbsd-1-0-PATCH05:1.2 netbsd-1-0-PATCH04:1.2 netbsd-1-0-PATCH03:1.2 netbsd-1-0-PATCH02:1.2 netbsd-1-0-PATCH1:1.2 netbsd-1-0-PATCH0:1.2 netbsd-1-0-RELEASE:1.2 netbsd-1-0:1.2.0.2 netbsd-1-0-base:1.2 BOSTIC-1:1.1; locks; strict; comment @# @; 1.30 date 2022.06.19.18.51.06; author gutteridge; state Exp; branches; next 1.29; commitid 5AFHNh9mxKiMiGID; 1.29 date 2022.06.18.13.41.12; author uwe; state Exp; branches; next 1.28; commitid sRwSJOPO3lHLDwID; 1.28 date 2022.06.18.02.19.07; author gutteridge; state Exp; branches; next 1.27; commitid wK5fQxCKKyQEQsID; 1.27 date 2016.06.16.15.11.43; author abhinav; state Exp; branches; next 1.26; commitid KGhO7pdziHL4DHaz; 1.26 date 2015.04.07.10.17.21; author plunky; state Exp; branches; next 1.25; commitid gw76Rs3quyXk0Egy; 1.25 date 2015.03.03.17.59.32; author christos; state Exp; branches; next 1.24; commitid bVehw7YsXMNlHbcy; 1.24 date 2013.06.28.10.13.18; author wiz; state Exp; branches 1.24.6.1; next 1.23; commitid Xa5cMpbhupUaPmVw; 1.23 date 2013.06.27.21.55.10; author jdf; state Exp; branches; next 1.22; commitid gUoarPE2qr8EJiVw; 1.22 date 2012.04.29.03.46.43; author christos; state Exp; branches 1.22.2.1; next 1.21; 1.21 date 2011.12.27.13.15.55; author apb; state Exp; branches; next 1.20; 1.20 date 2007.02.10.19.27.39; author reed; state Exp; branches 1.20.34.1; next 1.19; 1.19 date 2006.04.13.21.15.50; author wiz; state Exp; branches; next 1.18; 1.18 date 2006.04.10.16.20.46; author chuck; state Exp; branches; next 1.17; 1.17 date 2006.04.10.14.02.57; author chuck; state Exp; branches; next 1.16; 1.16 date 2003.08.07.11.15.10; author agc; state Exp; branches; next 1.15; 1.15 date 2002.09.30.10.32.16; author grant; state Exp; branches; next 1.14; 1.14 date 2002.03.08.22.18.04; author wiz; state Exp; branches; next 1.13; 1.13 date 2002.03.08.22.12.22; author jdolecek; state Exp; branches; next 1.12; 1.12 date 2002.02.08.01.36.28; author ross; state Exp; branches; next 1.11; 1.11 date 2001.12.01.20.35.54; author wiz; state Exp; branches; next 1.10; 1.10 date 2001.12.01.16.43.19; author wiz; state Exp; branches; next 1.9; 1.9 date 2001.06.25.21.37.24; author lukem; state Exp; branches; next 1.8; 1.8 date 2000.05.27.21.33.26; author jdolecek; state Exp; branches; next 1.7; 1.7 date 99.11.19.22.29.26; author kristerw; state Exp; branches 1.7.2.1; next 1.6; 1.6 date 99.04.04.16.27.28; author dante; state Exp; branches 1.6.4.1; next 1.5; 1.5 date 98.01.09.08.06.05; author perry; state Exp; branches 1.5.2.1; next 1.4; 1.4 date 97.10.19.05.07.06; author lukem; state Exp; branches; next 1.3; 1.3 date 95.01.16.09.29.12; author mycroft; state Exp; branches; next 1.2; 1.2 date 93.12.21.03.05.17; author cgd; state Exp; branches; next 1.1; 1.1 date 93.12.21.02.59.36; author cgd; state Exp; branches 1.1.1.1; next ; 1.24.6.1 date 2015.04.14.04.33.46; author snj; state Exp; branches; next ; commitid Wh4Mtqh1zUEhTvhy; 1.22.2.1 date 2014.08.20.00.05.00; author tls; state Exp; branches; next ; commitid jTnpym9Qu0o4R1Nx; 1.20.34.1 date 2012.04.17.00.09.36; author yamt; state Exp; branches; next 1.20.34.2; 1.20.34.2 date 2012.05.23.10.08.26; author yamt; state Exp; branches; next 1.20.34.3; 1.20.34.3 date 2014.05.22.11.42.46; author yamt; state Exp; branches; next ; commitid cG7DCbrDdiE9MwBx; 1.7.2.1 date 2000.06.23.16.39.48; author minoura; state Exp; branches; next ; 1.6.4.1 date 99.12.27.18.37.05; author wrstuden; state Exp; branches; next ; 1.5.2.1 date 2000.04.30.11.30.11; author he; state Exp; branches; next ; 1.1.1.1 date 95.01.16.09.35.28; author mycroft; state Exp; branches; next ; desc @@ 1.30 log @man.conf.5: improve wording on searching alternate machine paths As requested by uwe@@. Hopefully this is clearer now. @ text @.\" $NetBSD: man.conf.5,v 1.29 2022/06/18 13:41:12 uwe Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @@(#)man.conf.5 8.5 (Berkeley) 1/2/94 .\" .Dd June 18, 2022 .Dt MAN.CONF 5 .Os .Sh NAME .Nm man.conf .Nd configuration file for manual pages .Sh DESCRIPTION The .Nm file contains the default configuration used by .Xr man 1 , .Xr apropos 1 , .Xr whatis 1 , .Xr catman 8 , and .Xr makemandb 8 to find manual pages and information about manual pages (e.g., the .Xr whatis 1 database). .Pp Manual pages are located by searching an ordered set of directories called the .Dq man path for a file that matches the name of the requested page. Each directory in the search path usually has a set of subdirectories in it (though this is not required). When subdirectories are used, there are normally two subdirectories for each section of the manual. One subdirectory contains formatted copies of that section's manual pages that can be directly displayed to a terminal, while the other section subdirectory contains unformatted copies of the pages (see .Xr nroff 1 and .Xr mdoc 7 ) . Formatted manual pages are normally named with a trailing .Ql \&.0 suffix. .Pp The .Nm file contains comment and configuration lines. Comment lines start with the .Ql # character. Blank lines are also treated as comment lines. Configuration lines consist of a configuration keyword followed by a configuration string. There are two types of configuration keywords: control keywords and section keywords. Control keywords must start with the .Ql _ character. The following control keywords are currently defined: .Bl -tag -width Ic .It Ic _build Identifies the set of suffixes used for manual pages that must be formatted for display and the command that should be used to format them. Manual file names, regardless of their format, are expected to end in a .Dq \&.* pattern, i.e. a .Ql \&. followed by some suffix. The first field of a .Ic _build line contains a man page suffix specification. The suffix specification may contain the normal shell globbing characters .Po .Em not including csh-style curly braces .Pc . The rest of the .Ic _build line is a shell command line whose standard output is a formatted manual page that can be directly displayed to the user. There should be exactly one occurrence of the string .Ql %s in the shell command line, and it will be replaced by the name of the file which is being formatted. .It Ic _crunch Used by .Xr catman 8 to determine how to crunch formatted pages which originally were compressed man pages. The first field lists a suffix which indicates what kind of compression was used to compress the man page. The rest of the line must be a shell command line, used to compress the formatted pages. There should be exactly one occurrence of the string .Ql %s in the shell command line, and it will be replaced by the name of the output file. .It Ic _default Contains the system-wide default man path used to search for man pages. .It Ic _mandb Defines the full pathname (not just a directory path) for a database to be used by the .Xr apropos 1 and .Xr whatis 1 commands. The pathname may contain the normal shell globbing characters, including csh-style curly braces; to escape a shell globbing character, precede it with a backslash .Pq Ql \e . .It Ic _subdir Contains the list (in search order) of section subdirectories which will be searched in any man path directory named with a trailing slash .Pq Ql / character. This list is also used, even if there is no trailing slash character, when a path is specified to the .Xr man 1 utility by the user, by the .Ev MANPATH environment variable, or by the .Fl M and .Fl m options. .It Ic _suffix identifies the set of suffixes used for formatted man pages (the .Ql \&.0 suffix is normally used here). Formatted man pages can be directly displayed to the user. Each suffix may contain the normal shell globbing characters .Po .Em not including csh-style curly braces .Pc . .It Ic _version Contains the version of the configuration file. .It Ic _ Ns Aq Ar machine Defines additional paths to be searched for the particular .Ar machine hardware name whose literal value is taken from .Xr uname 1 .Fl m . For example, on an amd64, the .Ic _amd64 control keyword is used, where .Ql x86 is supplied by default as an alternate machine path to also search. .El .Pp Section configuration lines in .Nm consist of a section keyword naming the section and a configuration string that defines the directory or subdirectory path that the section's manual pages are located in. The path may contain the normal shell globbing characters, including csh-style curly braces; to escape a shell globbing character, precede it with a backslash .Pq Ql \e . Section keywords must not start with the .Ql _ character. .Pp A section path may contain either a list of absolute directories or a list of relative directories (but not both). Relative directory paths are treated as a list of subdirectories that are appended to the current man path directory being searched. Section configuration lines with absolute directory paths (starting with .Ql / ) completely replace the current man search path directory with their content. .Pp Section configuration lines with absolute directory paths ending with a trailing slash character are expected to contain subdirectories of manual pages, (see the keyword .Ic _subdir above). The .Ic _subdir subdirectory list is not applied to absolute section directories if there is no trailing slash. .Pp In addition to the above rules, the .Xr man 1 command also always checks in each directory that it searches for a subdirectory with the same name as the current machine type. If a machine-specific subdirectory is found, it is also searched before the parent directory is. This allows the manual to contain machine-specific man pages. Note that the machine subdirectory does not need to be specified in the .Nm file. .Pp Multiple specifications for all types of .Nm configuration lines are cumulative and the entries are used in the order listed in the file; multiple entries may be listed per line, as well. .Sh FILES .Bl -tag -width Pa -compact .It Pa /etc/man.conf Standard manual configuration file. .El .Sh EXAMPLES Given the following .Nm file: .Bd -literal -offset indent _version BSD.2 _subdir cat[123] _suffix .0 _build .[1-9] nroff -man %s _build .tbl tbl %s | nroff -man _i386 x86 _default /usr/share/man/ sect3 /usr/share/man/{old/,}cat3 .Ed .Pp By default, the command .Dq Li man mktemp will search for .Pa mktemp. Ns Aq Ar digit and .Pa mktemp.tbl in the directories .Pa /usr/share/man/cat1 , .Pa /usr/share/man/cat2 , and .Pa /usr/share/man/cat3 . If on a machine of type .Dq vax , the subdirectory .Pa vax in each directory would be searched as well, before the directory was searched. .Pp If .Pa mktemp.tbl was found first, the command .Dq Li tbl Ao Ar manual page Ac Li \&| nroff -man would be run to build a man page for display to the user. .Pp The command .Dq Li man sect3 mktemp would search the directories .Pa /usr/share/man/old/cat3 and .Pa /usr/share/man/cat3 , in that order, for the mktemp manual page. If a subdirectory with the same name as the current machine type existed in any of them, it would be searched as well, before each of them were searched. .Sh SEE ALSO .Xr apropos 1 , .Xr machine 1 , .Xr man 1 , .Xr whatis 1 , .Xr whereis 1 , .Xr fnmatch 3 , .Xr glob 3 , .Xr catman 8 , .Xr makemandb 8 @ 1.29 log @man.conf(5): Tweak formatting for prettier PS output. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.28 2022/06/18 02:19:07 gutteridge Exp $ d173 1 a173 1 For example on an amd64, d177 1 a177 1 is commonly supplied as an alternate machine path to also search. @ 1.28 log @man.conf.5: add details about the machine line and search order Also, tweak some grammar, style, and markup while here. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.27 2016/06/16 15:11:43 abhinav Exp $ d67 1 a67 1 .Dq \.0 d74 1 a74 1 .Dq # d82 1 a82 1 .Dq _ d85 2 a86 2 .Bl -tag -width XXmachineX .It _build d91 1 a91 1 .Dq \.* d93 1 a93 1 .Dq \&\. d95 3 a97 1 The first field of a _build line contains a man page suffix specification. d99 7 a105 3 (NOT including curly braces .Pq Dq {} ) . The rest of the _build line is a shell command line whose standard d109 1 a109 1 .Dq %s d112 1 a112 1 .It _crunch d122 1 a122 1 .Dq %s d125 1 a125 1 .It _default d127 1 a127 1 .It _mandb d129 1 a129 2 be used by the d135 1 a135 2 including curly braces .Pq Dq {} ; d138 2 a139 2 .Pq Dq \e . .It _subdir d142 1 a142 1 .Pq Dq / d154 1 a154 1 .It _suffix d157 1 a157 1 .Dq \.0 d160 6 a165 4 Each suffix may contain the normal shell globbing characters (NOT including curly braces .Pq Dq {} ) . .It _version d167 1 a167 1 .It _ Ns Aq machine d169 1 a169 1 .Dv machine d173 4 a176 5 For example on an .Dv amd64 , .Dv _amd64 is used, where .Dq x86 d186 1 a186 2 including curly braces .Pq Dq {} ; d189 1 a189 1 .Pq Dq \e . d191 1 a191 1 .Dq _ d199 1 a199 1 .Dq / ) d206 1 a206 1 .Dq _subdir d209 1 a209 1 .Dq _subdir d231 1 a231 1 .Bl -tag -width /etc/man.conf -compact d253 1 a253 1 .Dq mktemp. Ns Aq any_digit d255 1 a255 1 .Dq mktemp.tbl d257 2 a258 2 .Dq Pa /usr/share/man/cat1 , .Dq Pa /usr/share/man/cat2 , d260 1 a260 1 .Dq Pa /usr/share/man/cat3 . d264 1 a264 1 .Dq vax d270 1 a270 1 .Dq mktemp.tbl d272 1 a272 1 .Dq Li tbl Ao manual page Ac | nroff -man d278 1 a278 1 .Dq Pa /usr/share/man/old/cat3 d280 1 a280 1 .Dq Pa /usr/share/man/cat3 , @ 1.27 log @Replace makewhatis(8) with makemandb(8) in SEE ALSO. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.26 2015/04/07 10:17:21 plunky Exp $ d32 1 a32 1 .Dd June 16, 2016 d48 3 a50 2 to find manual pages and information about manual pages (e.g. the whatis database). d110 3 a112 2 which originally were compressed man pages: The first field lists a suffix which indicates what kind of compression were used to compress the man page. d164 1 a164 1 whose literal value is taken from d170 3 a172 1 is used. d191 1 a191 1 a list of or relative directories (but not both). d213 2 a214 1 If the machine-specific directory is found, it is also searched. @ 1.26 log @change _whatdb => _mandb as that is the correct keyword here, and move it to the correct position in the list. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.25 2015/03/03 17:59:32 christos Exp $ d32 1 a32 1 .Dd March 3, 2015 d286 1 a286 1 .Xr makewhatis 8 @ 1.25 log @there is no more makewhatis; it has been replaced by makemandb @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.24 2013/06/28 10:13:18 wiz Exp $ d119 14 a158 14 .It _whatdb Defines the full pathname (not just a directory path) for a database to be used by the .Xr apropos 1 and .Xr whatis 1 commands. The pathname may contain the normal shell globbing characters, including curly braces .Pq Dq {} ; to escape a shell globbing character, precede it with a backslash .Pq Dq \e . @ 1.24 log @Prefer Aq to \*[Lt] etc. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.23 2013/06/27 21:55:10 jdf Exp $ d32 1 a32 1 .Dd April 28, 2012 d47 1 a47 1 .Xr makewhatis 8 @ 1.24.6.1 log @Pull up following revision(s) (requested by christos in ticket #676): usr.bin/man/man.conf.5: revision 1.25 usr.sbin/makemandb/makemandb.8: revision 1.8 mention that this replaces makewhatis(8) -- there is no more makewhatis; it has been replaced by makemandb @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.24 2013/06/28 10:13:18 wiz Exp $ d32 1 a32 1 .Dd March 3, 2015 d47 1 a47 1 .Xr makemandb 8 @ 1.23 log @ * adjust indentation of list block * fix capitalization * remove superfluous word ('The') Patch supplied by Bug Hunting. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.22 2012/04/29 03:46:43 christos Exp $ d84 1 a84 1 .Bl -tag -width "_\*[Lt]machine\*[Gt]" d159 1 a159 1 .It _\*[Lt]machine\*[Gt] d244 1 a244 1 .Dq mktemp.\*[Lt]any_digit\*[Gt] d263 1 a263 1 .Dq Li tbl \*[Lt]manual page\*[Gt] | nroff -man @ 1.22 log @document _machine @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.21 2011/12/27 13:15:55 apb Exp $ d84 1 a84 1 .Bl -tag -width "_version" d86 1 a86 1 identifies the set of suffixes used for manual pages that must be d106 1 a106 1 used by d118 1 a118 1 contains the system-wide default man path used to search for man pages. d120 1 a120 1 contains the list (in search order) of section subdirectories which will d144 1 a144 1 contains the version of the configuration file. d146 1 a146 1 defines the full pathname (not just a directory path) for a database to d160 1 a160 1 The defines additional paths to be searched for the particular @ 1.22.2.1 log @Rebase to HEAD as of a few days ago. @ text @d1 1 a1 1 .\" $NetBSD$ d84 1 a84 1 .Bl -tag -width XXmachineX d86 1 a86 1 Identifies the set of suffixes used for manual pages that must be d106 1 a106 1 Used by d118 1 a118 1 Contains the system-wide default man path used to search for man pages. d120 1 a120 1 Contains the list (in search order) of section subdirectories which will d144 1 a144 1 Contains the version of the configuration file. d146 1 a146 1 Defines the full pathname (not just a directory path) for a database to d159 2 a160 2 .It _ Ns Aq machine Defines additional paths to be searched for the particular d244 1 a244 1 .Dq mktemp. Ns Aq any_digit d263 1 a263 1 .Dq Li tbl Ao manual page Ac | nroff -man @ 1.21 log @Document the reality that the _build and _crunch commands should each contain exactly one "%s". The previous description allowed any number of "%s" in the _build command, but that does not match the actual behaviour of either man(1) or catman(8). @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.20 2007/02/10 19:27:39 reed Exp $ d32 1 a32 1 .Dd December 27, 2011 d159 10 d236 1 @ 1.20 log @Add "catman" to the SEE ALSO. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.19 2006/04/13 21:15:50 wiz Exp $ d32 1 a32 1 .Dd April 10, 2006 d101 1 a101 1 Any occurrences of the string d103 1 a103 1 in the shell command line will d113 4 @ 1.20.34.1 log @sync with head @ text @d1 1 a1 1 .\" $NetBSD$ d32 1 a32 1 .Dd December 27, 2011 d101 1 a101 1 There should be exactly one occurrence of the string d103 1 a103 1 in the shell command line, and it will a112 4 There should be exactly one occurrence of the string .Dq %s in the shell command line, and it will be replaced by the name of the output file. @ 1.20.34.2 log @sync with head. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.20.34.1 2012/04/17 00:09:36 yamt Exp $ d32 1 a32 1 .Dd April 28, 2012 a158 10 .It _\*[Lt]machine\*[Gt] The defines additional paths to be searched for the particular .Dv machine whose literal value is taken from .Xr uname 1 .Fl m . For example on an .Dv amd64 , .Dv _amd64 is used. a225 1 _i386 x86 @ 1.20.34.3 log @sync with head. for a reference, the tree before this commit was tagged as yamt-pagecache-tag8. this commit was splitted into small chunks to avoid a limitation of cvs. ("Protocol error: too many arguments") @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.20.34.2 2012/05/23 10:08:26 yamt Exp $ d84 1 a84 1 .Bl -tag -width XXmachineX d86 1 a86 1 Identifies the set of suffixes used for manual pages that must be d106 1 a106 1 Used by d118 1 a118 1 Contains the system-wide default man path used to search for man pages. d120 1 a120 1 Contains the list (in search order) of section subdirectories which will d144 1 a144 1 Contains the version of the configuration file. d146 1 a146 1 Defines the full pathname (not just a directory path) for a database to d159 2 a160 2 .It _ Ns Aq machine Defines additional paths to be searched for the particular d244 1 a244 1 .Dq mktemp. Ns Aq any_digit d263 1 a263 1 .Dq Li tbl Ao manual page Ac | nroff -man @ 1.19 log @Bump date for previous. New sentence, new line. Remove trailing whitespace. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.18 2006/04/10 16:20:46 chuck Exp $ d270 1 @ 1.18 log @fix .Xr to invalid man page that i put in by mistake @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.17 2006/04/10 14:02:57 chuck Exp $ d32 1 a32 1 .Dd June 26, 2001 d41 1 a41 1 file contains the default configuration used by d47 1 a47 1 .Xr makewhatis 8 d55 1 a55 1 Each directory in the search path usually has a set of subdirectories d60 3 a62 3 pages that can be directly displayed to a terminal, while the other section subdirectory contains unformatted copies of the pages (see .Xr nroff 1 d66 1 a66 1 .Dq \.0 d71 2 a72 2 file contains comment and configuration lines. Comment lines start with the d74 3 a76 3 character. Blank lines are also treated as comment lines. Configuration lines consist of a configuration keyword followed by a d86 4 a89 4 identifies the set of suffixes used for manual pages that must be formatted for display and the command that should be used to format them. Manual file names, regardless of their format, are expected to end in a d95 1 a95 1 The suffix specification may contain the normal shell globbing characters d98 2 a99 2 The rest of the _build line is a shell command line whose standard output is a formatted manual page that can be directly displayed to d106 1 a106 1 used by d116 1 a116 1 contains the list (in search order) of section subdirectories which will d123 1 a123 1 utility by the user, by the d132 1 a132 1 (the d142 1 a142 1 defines the full pathname (not just a directory path) for a database to d157 1 a157 1 Section configuration lines in d174 1 a174 1 Relative directory paths are treated as a list of subdirectories that d188 1 a188 1 subdirectory list is not applied to absolute section directories d191 1 a191 1 In addition to the above rules, the d196 3 a198 3 This allows the manual to contain machine-specific man pages. Note that the machine subdirectory does not need to be specified in the d202 1 a202 1 Multiple specifications for all types of d204 2 a205 2 configuration lines are cumulative and the entries are used in the order listed in the file; @ 1.17 log @rework the wording in these man pages (mainly in man.conf.5) based on some old notes I found to make it clearer and easier to understand how the man stuff works (hopefully!). @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.16 2003/08/07 11:15:10 agc Exp $ d64 1 a64 1 .Xr mandoc 7 ) . @ 1.16 log @Move UCB-licensed code from 4-clause to 3-clause licence. Patches provided by Joel Baker in PR 22365, verified by myself. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.15 2002/09/30 10:32:16 grant Exp $ d37 1 a37 2 .Nd configuration file for .Xr man 1 d40 2 d44 19 a62 1 .Xr whatis 1 d64 4 a67 9 .Xr makewhatis 8 commands search for manual pages or their database files as specified by the .Nm file. Manual pages are normally expected to be preformatted (see .Xr nroff 1 ) and named with a trailing .Dq \.0 . d71 13 a83 54 file contains two types of lines. .Pp The first type of line is a .Dq section line, which contains a section name followed by one or more directory paths. The directory paths may contain the normal shell globbing characters, including curly braces .Pq Dq {} ; to escape a shell globbing character, precede it with a backslash .Pq Dq \e . Lines in this format specify that manual pages for the section may be found in the following directories. .Pp Section lines may contain either absolute directory paths or relative directory paths (but not both). Relative directory paths are treated as a list of subdirectories to append to the current directory search path. Section lines with absolute directory paths (starting with .Dq / ) completely replace the current directory search path with their content. Absolute directory paths named with a trailing slash character are expected to contain subdirectories of manual pages, (see the keyword .Dq _subdir below) instead of man pages. These subdirectories are searched instead of the directory. .Pp Before searching any directory for a manual page, the .Xr man 1 command always searches the subdirectory with the same name as the current machine type, if it exists. No specification of these subdirectories is necessary in the .Nm file. .Pp Section names are unrestricted except for the reserved words specified below; in general, you should avoid anything with a leading underscore .Pq Dq _ to avoid future incompatibilities. .Pp The section named .Dq _default is the list of directories that will be searched if no section is specified by the user. .Pp The second type of line is preceded with a .Dq keyword . The possible keywords and their meanings are as follows: .Pp d86 4 a89 2 Man file names, regardless of their format, are expected to end in a d94 3 a96 5 The first field of a _build line lists a suffix which indicates files which need to be reformatted or manipulated in some way before being displayed to the user. The suffix may contain the normal shell globbing characters (NOT including curly braces d98 3 a100 3 The rest of the line must be a shell command line, the standard output of which is the manual page in a format which may be directly displayed to the user. d104 1 a104 1 be replaced by the name of the file which is being reformatted. d106 3 a108 3 The .Dq _crunch section is used by catman to know how to crunch cat pages d113 2 d116 2 a117 2 The list (in search order) of subdirectories which will be searched in any directory named with a trailing slash d120 2 a121 1 This list is also used when a path is specified to the d123 1 a123 1 utility by the user, using the d125 1 a125 1 environment variable or the d131 5 a135 9 Man file names, regardless of their format are expected to end in a .Dq \.* pattern, i.e. a .Dq \&\. followed by some suffix. Each field of a _suffix line is a suffix which indicates files which do not need to be reformatted or manipulated in any way, but which may be directly displayed to the user. d140 1 a140 1 The version of the configuration file. d142 2 a143 1 The full pathname (not just a directory path) for a database to be used d157 50 a206 8 Multiple specifications for all types of lines are cumulative and the entries are used in the order listed in the file; multiple entries may be listed per line, as well. .Pp Empty lines or lines whose first non-whitespace character is a hash mark .Pq Dq # are ignored. d210 1 a210 1 Standard manual directory search path. @ 1.15 log @New sentence, new line. Some mdoc cleanup. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.14 2002/03/08 22:18:04 wiz Exp $ d14 1 a14 5 .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors @ 1.14 log @Xr makewhatis 8, not 1. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.13 2002/03/08 22:12:22 jdolecek Exp $ d56 2 a57 1 and named with a trailing ``.0''. d63 3 a65 1 The first type of line is a ``section'' line, which contains a d68 5 a72 2 including curly braces (``{}''); to escape a shell globbing character, precede it with a backslash (``\e''). d77 2 a78 1 directory paths (but not both). Relative directory paths are treated d80 6 a85 3 path. Section lines with absolute directory paths (starting with ``/'') completely replace the current directory search path with their content. Absolute directory paths named with a trailing slash d87 4 a90 1 the keyword ``_subdir'' below) instead of man pages. These d103 2 a104 1 (``_'') to avoid future incompatibilities. d106 3 a108 1 The section named ``_default'' is the list of directories that will d111 2 a112 1 The second type of line is preceded with a ``keyword''. d118 5 a122 1 a ``.*'' pattern, i.e. a ``.'' followed by some suffix. d127 2 a128 1 including curly braces (``{}'')). d132 3 a134 1 Any occurrences of the string ``%s'' in the shell command line will d137 3 a139 1 The ``_crunch'' section is used by catman to know how to crunch cat pages d146 3 a148 1 any directory named with a trailing slash (``/'') character. d160 5 a164 1 a ``.*'' pattern, i.e. a ``.'' followed by some suffix. d169 2 a170 1 including curly braces (``{}'')). d181 5 a185 2 including curly braces (``{}''); to escape a shell globbing character, precede it with a backslash (``\e''). d193 3 a195 1 mark (``#'') are ignored. d218 3 a220 1 ``mktemp.\*[Lt]any_digit\*[Gt]'' and ``mktemp.tbl'' d226 5 a230 1 If on a machine of type ``vax'', the subdirectory ``vax'' in each d234 3 a236 1 If ``mktemp.tbl'' was found first, the command @ 1.13 log @xref makewhatis(8), it now uses man.conf too @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.12 2002/02/08 01:36:28 ross Exp $ a207 1 .Xr makewhatis 1 , d212 2 a213 1 .Xr glob 3 @ 1.12 log @Generate <>& symbolically. I'm avoiding .../dist/... directories for now. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.11 2001/12/01 20:35:54 wiz Exp $ d47 1 d49 1 a49 1 .Xr whatis 1 d208 1 @ 1.11 log @Sort sections. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.10 2001/12/01 16:43:19 wiz Exp $ d179 1 a179 1 ``mktemp.'' and ``mktemp.tbl'' d190 1 a190 1 .Dq Li tbl | nroff -man @ 1.10 log @Whitespace cleanup. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.9 2001/06/25 21:37:24 lukem Exp $ d157 5 a203 5 .Sh FILES .Bl -tag -width /etc/man.conf -compact .It Pa /etc/man.conf Standard manual directory search path. .El @ 1.9 log @_whatdb has supported glob(3)ing pathnames for over 3 years ... @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.8 2000/05/27 21:33:26 jdolecek Exp $ d176 2 a177 2 .Dq Pa /usr/share/man/cat1 , .Dq Pa /usr/share/man/cat2 , @ 1.8 log @allow to specify relative paths for sections in man.conf - they are used similarily to _subdir, but only when appropriate fix -m handling, so that e.g. "man -m . 3 printf" works as it should add new -S flag, to specify a string the result path has to contain g/c some unused stuff Written by Chuck Cranor, with only cosmetic changes & const poisoning by me. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.7 1999/11/19 22:29:26 kristerw Exp $ d36 1 a36 1 .Dd January 2, 1994 d146 3 @ 1.7 log @Typos (from OpenBSD) @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.6 1999/04/04 16:27:28 dante Exp $ d69 9 a77 4 Directories named with a trailing slash character (``/'') are expected to contain subdirectories of manual pages, (see the keyword ``_subdir'' below) instead of manual pages. These subdirectories are searched instead of the directory. @ 1.7.2.1 log @Sync w/ netbsd-1-5-base. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.8 2000/05/27 21:33:26 jdolecek Exp $ d69 4 a72 9 Section lines may contain either absolute directory paths or relative directory paths (but not both). Relative directory paths are treated as a list of subdirectories to append to the current directory search path. Section lines with absolute directory paths (starting with ``/'') completely replace the current directory search path with their content. Absolute directory paths named with a trailing slash character are expected to contain subdirectories of manual pages, (see the keyword ``_subdir'' below) instead of man pages. These subdirectories are searched instead of the directory. @ 1.6 log @Document '_crunch' section. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.5 1998/01/09 08:06:05 perry Exp $ d97 1 a97 1 files which need to be reformated or manipulated in some way before @ 1.6.4.1 log @Pull up to last week's -current. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.7 1999/11/19 22:29:26 kristerw Exp $ d97 1 a97 1 files which need to be reformatted or manipulated in some way before @ 1.5 log @RCS Id Police. @ text @d1 1 a1 1 .\" $NetBSD$ d106 6 @ 1.5.2.1 log @Pull up revisions 1.6-1.7 (requested by kim): Pull up various changes from the trunk: o man page typos fixed. Document _crunch. @ text @d1 1 a1 1 .\" $NetBSD: man.conf.5,v 1.5 1998/01/09 08:06:05 perry Exp $ d97 1 a97 1 files which need to be reformatted or manipulated in some way before a105 6 .It _crunch The ``_crunch'' section is used by catman to know how to crunch cat pages which originally were compressed man pages: The first field lists a suffix which indicates what kind of compression were used to compress the man page. The rest of the line must be a shell command line, used to compress the formatted pages. @ 1.4 log @fix up .Nm usage @ text @d1 2 @ 1.3 log @Sync with 4.4-Lite, plus local changes. @ text @d49 1 a49 1 .Nm man.conf d56 1 a56 1 .Nm man.conf d77 1 a77 1 .Nm man.conf d143 1 a143 1 .Nm man.conf @ 1.2 log @fix slight docbug @ text @d32 1 a32 1 .\" @@(#)man.conf.5 8.4 (Berkeley) 11/26/93 d34 1 a34 1 .Dd November 26, 1993 @ 1.1 log @add man(1) ; part of new man(1) package from Bostic @ text @d146 1 a146 1 _version BSD.1 @ 1.1.1.1 log @Import original 4.4-Lite version. @ text @d32 1 a32 1 .\" @@(#)man.conf.5 8.5 (Berkeley) 1/2/94 d34 1 a34 1 .Dd January 2, 1994 d146 1 a146 1 _version BSD.2 @