NetBSD/usr.sbin/catman/catman.8

108 lines
3.2 KiB
Groff

.\"
.\" 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.12 2021/08/15 11:00:43 christos Exp $
.\"
.Dd August 15, 2021
.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
.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 ``13f8'', the
manual pages in sections 1, 3f, 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
Add
.Ar directory
to the set of directories to be updated.
.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 does not handle hard links.
Acts oddly on nights with full moons.