initial import of NetBSD tree

1 files changed, 100 insertions, 0 deletions

diff --git a/usr.sbin/catman/catman.8 b/usr.sbin/catman/catman.8
new file mode 100644
index 00000000000..eefc3435b45
--- /dev/null
+++ b/usr.sbin/catman/catman.8
@@ -0,0 +1,100 @@
+.\"
+.\" 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.
+.\"
+.\"	$Id: catman.8,v 1.1 1995/10/18 08:47:29 deraadt Exp $
+.\"
+.Dd July 30, 1993
+.Dt CATMAN 8
+.Os
+.Sh NAME
+.Nm catman
+.Nd format cat pages from man pages
+.Sh SYNOPSIS
+.Nm catman
+.Op Fl knpsw
+.Op Fl M Ar directory
+.Op Ar sections
+.Sh DESCRIPTION
+.Nm Catman 
+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 catman
+also regenerates the 
+.Nm 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 catman
+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 
+.Nm 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 
+.Nm 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.