.\" .\" Copyright (c) 1993 Winning Strategies, Inc. .\" 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. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by Winning Strategies, Inc. .\" 4. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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. .\" .\" $NetBSD: catman.8,v 1.8 1997/10/18 04:37:19 lukem Exp $ .\" .Dd July 30, 1993 .Dt CATMAN 8 .Os .Sh NAME .Nm catman .Nd format cat pages from man pages .Sh SYNOPSIS .Nm .Op Fl knpsw .Op Fl M Ar directory .Op Ar sections .Sh DESCRIPTION .Nm creates formatted versions of the on-line manual pages from their .Xr nroff 1 source. Manual pages whose formatted versions are missing or out of date are regenerated. If manual pages are regenerated, .Nm also regenerates the .Pa whatis database. .Pp The optional .Ar sections argument is one word, and contains the section numbers of all the sections to be checked. For example, if .Ar sections is ``138'', the manual pages in sections 1, 3, and 8 will be checked and regenerated. If no .Ar sections argument is provided, .Nm will try to operate on all of the known manual sections. .Pp The options are as follows: .Bl -tag -width indent .It Fl k Ignore errors from nroff when building manpages. .It Fl n Do not create the .Pa whatis database. .It Fl p Display the commands that would have been executed, but do not actually execute them. .It Fl s Perform work silently; do not echo commands as they are executed. This flag is ignored if .Fl p is specified. .It Fl w Only create the .Pa whatis database. .It Fl M Ar directory Update manual pages in .Ar directory. .El .Sh SEE ALSO .Xr apropos 1 , .Xr man 1 , .Xr whatis 1 .Sh BUGS Currently knows nothing about .Pa /etc/man.conf and machine specific man pages.