shithub: riscv

ref: b2526c7d909b2ce321faef34d49b1b70434cf360
dir: /sys/man/1/man/

View raw version
.TH MAN 1
.SH NAME
man, lookman, sig \- print or find pages of this manual
.SH SYNOPSIS
.B man
[
.B -bnpPStw
]
[
.I section ...
]
.I title ...
.PP
.B lookman
.I key ...
.PP
.B sig
.I function ...
.SH DESCRIPTION
.I Man
locates and prints pages of this manual named
.I title
in the specified
.IR sections .
.I Title
is given in lower case.
Each
.I section
is a number;
pages marked (2S), for example,
belong to chapter 2.
If no
.I section
is specified, pages 
in all sections are printed.
Any name from the
.SM NAME
section at the top of the page will serve as a
.IR title .
.PP
The options are:
.TP
.B -n
(Default)
Print the pages on the standard output using
.IR nroff .
.TP
.B -b
Print the pages using
.I nroff
and send them to 
.IR plumber (4)
for display in the editor.
.TP
.B -p
Run
.IR proof (1)
on the specified man pages.
.TP
.B -P
Run
.IR page (1)
on the specified man pages.
.TP
.B -S
Do not search the manual indices for the names.
Only print pages whose file names match the names.
.TP
.B -t
Run
.IR troff (1)
and send its output
to standard output.
.TP
.B -w
Print the names of the man page source files.
.PD
.PP
.B Lookman
prints the names of all manual sections that contain
all of the
.I key
words given on the command line.
.PP
.B Sig
prints the signature (i.e. C definition) of the
.IR function s
given on the command line.
.SH FILES
.TP
.B /sys/man/?/*
.I troff
source for manual; this page is
.B /sys/man/1/man
.TP
.B /sys/man/?/INDEX
indices searched to find pages corresponding to titles
.TP
.B /sys/lib/man/secindex
command to make an index for a given section
.TP
.B /sys/lib/man/lookman/index
index for
.I lookman
.SH SOURCE
.B /rc/bin/man
.br
.B /rc/bin/lookman
.SH "SEE ALSO"
.IR page (1),
.IR proof (1)
.SH BUGS
The manual was intended to be typeset; some detail is sacrificed on text terminals.
.PP
There is no automatic mechanism to keep the indices up to date.
.PP
Except for special cases,
.I man
doesn't recognize things that should be run through
.I tbl
and/or
.IR eqn .