version 1.107, 2014/08/22 03:42:18 |
version 1.109, 2014/08/30 18:08:10 |
|
|
.Nd format and display UNIX manuals |
.Nd format and display UNIX manuals |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm mandoc |
.Nm mandoc |
.Op Fl acV |
.Op Fl acfklV |
.Sm off |
.Sm off |
.Op Fl I Cm os Li = Ar name |
.Op Fl I Cm os Li = Ar name |
.Sm on |
.Sm on |
|
|
.Fl T Ns Cm ascii |
.Fl T Ns Cm ascii |
output. |
output. |
.Pp |
.Pp |
The arguments are as follows: |
The options are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Fl a |
.It Fl a |
If the standard output is a terminal device and |
If the standard output is a terminal device and |
Line 68 to paginate them. |
|
Line 68 to paginate them. |
|
This is the default. |
This is the default. |
It can be specified to override |
It can be specified to override |
.Fl a . |
.Fl a . |
|
.It Fl f |
|
A synonym for |
|
.Xr whatis 1 . |
|
This overrides any earlier |
|
.Fl k |
|
and |
|
.Fl l |
|
options. |
.Sm off |
.Sm off |
.It Fl I Cm os Li = Ar name |
.It Fl I Cm os Li = Ar name |
.Sm on |
.Sm on |
|
|
.Xr mdoc 7 |
.Xr mdoc 7 |
.Sq \&Os |
.Sq \&Os |
macro. |
macro. |
|
.It Fl k |
|
A synonym for |
|
.Xr apropos 1 . |
|
This overrides any earlier |
|
.Fl f |
|
and |
|
.Fl l |
|
options. |
|
.It Fl l |
|
A synonym for |
|
.Fl a . |
|
Also reverts any earlier |
|
.Fl f |
|
and |
|
.Fl k |
|
options. |
.It Fl m Ns Ar format |
.It Fl m Ns Ar format |
Input format. |
Input format. |
See |
See |
Line 137 If multiple files are specified, |
|
Line 161 If multiple files are specified, |
|
.Nm |
.Nm |
will halt with the first failed parse. |
will halt with the first failed parse. |
.El |
.El |
|
.Pp |
|
In |
|
.Fl f |
|
and |
|
.Fl k |
|
mode, |
|
.Nm |
|
also supports the options |
|
.Fl CMmOSsw |
|
described in the |
|
.Xr apropos 1 |
|
manual. |
.Ss Input Formats |
.Ss Input Formats |
The |
The |
.Nm |
.Nm |
|
|
.Sx HTML Output |
.Sx HTML Output |
for details; beyond generating XHTML tags instead of HTML tags, these |
for details; beyond generating XHTML tags instead of HTML tags, these |
output modes are identical. |
output modes are identical. |
|
.Sh ENVIRONMENT |
|
.Bl -tag -width MANPAGER |
|
.It Ev MANPAGER |
|
Any non-empty value of the environment variable |
|
.Ev MANPAGER |
|
will be used instead of the standard pagination program, |
|
.Xr more 1 . |
|
.It Ev PAGER |
|
Specifies the pagination program to use when |
|
.Ev MANPAGER |
|
is not defined. |
|
If neither PAGER nor MANPAGER is defined, |
|
.Pa /usr/bin/more Fl s |
|
will be used. |
|
.El |
.Sh EXIT STATUS |
.Sh EXIT STATUS |
The |
The |
.Nm |
.Nm |