version 1.265, 2023/10/18 14:34:29 |
version 1.267, 2023/11/13 19:13:01 |
|
|
.\" $Id$ |
.\" $Id$ |
.\" |
.\" |
.\" Copyright (c) 2012, 2014-2022 Ingo Schwarze <schwarze@openbsd.org> |
.\" Copyright (c) 2012, 2014-2023 Ingo Schwarze <schwarze@openbsd.org> |
.\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" |
.\" |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" Permission to use, copy, modify, and distribute this software for any |
Line 287 arguments are accepted: |
|
Line 287 arguments are accepted: |
|
.It Cm indent Ns = Ns Ar indent |
.It Cm indent Ns = Ns Ar indent |
The left margin for normal text is set to |
The left margin for normal text is set to |
.Ar indent |
.Ar indent |
blank characters instead of the default of five for |
blank characters instead of the default of five. |
.Xr mdoc 7 |
|
and seven for |
|
.Xr man 7 . |
|
Increasing this is not recommended; it may result in degraded formatting, |
Increasing this is not recommended; it may result in degraded formatting, |
for example overfull lines or ugly line breaks. |
for example overfull lines or ugly line breaks. |
When output is to a pager on a terminal that is less than 66 columns |
When output is to a pager on a terminal that is less than 66 columns |
|
|
.Xr mdoc 7 |
.Xr mdoc 7 |
output style. |
output style. |
This prints the operating system name rather than the page title |
This prints the operating system name rather than the page title |
on the right side of the footer line, and it implies |
on the right side of the footer line. |
.Fl O Cm indent Ns =5 . |
|
One useful application is for checking that |
One useful application is for checking that |
.Fl T Cm man |
.Fl T Cm man |
output formats in the same way as the |
output formats in the same way as the |
Line 1295 The same standard section title occurs more than once. |
|
Line 1291 The same standard section title occurs more than once. |
|
A standard section header occurs in a section of the manual |
A standard section header occurs in a section of the manual |
where it normally isn't useful. |
where it normally isn't useful. |
.It Sy "cross reference to self" |
.It Sy "cross reference to self" |
.Pq mdoc |
.Pq mdoc , man |
An |
An |
.Ic \&Xr |
.Ic \&Xr |
|
or |
|
.Ic \&MR |
macro refers to a name and section matching the section of the present |
macro refers to a name and section matching the section of the present |
manual page and a name mentioned in an |
manual page and a name mentioned in an |
.Ic \&Nm |
.Ic \&Nm |
Line 1616 macro is immediately followed by an |
|
Line 1614 macro is immediately followed by an |
|
macro on the next input line. |
macro on the next input line. |
Such an empty block does not produce any output. |
Such an empty block does not produce any output. |
.It Sy "missing section argument" |
.It Sy "missing section argument" |
.Pq mdoc |
.Pq mdoc , man |
An |
An |
.Ic \&Xr |
.Ic \&Xr |
|
or |
|
.Ic \&MR |
macro lacks its second, section number argument. |
macro lacks its second, section number argument. |
The first argument, i.e. the name, is printed, but without subsequent |
The first argument, i.e. the name, is printed, but without a section number. |
parentheses. |
In the case of |
|
.Ic \&Xr , |
|
the parentheses are also omitted. |
.It Sy "missing -std argument, adding it" |
.It Sy "missing -std argument, adding it" |
.Pq mdoc |
.Pq mdoc |
An |
An |
Line 2152 request is neither a single ASCII character |
|
Line 2154 request is neither a single ASCII character |
|
nor a single character escape sequence. |
nor a single character escape sequence. |
All arguments are ignored and printing of a margin character is disabled. |
All arguments are ignored and printing of a margin character is disabled. |
.It Sy "missing manual name, using \(dq\(dq" |
.It Sy "missing manual name, using \(dq\(dq" |
.Pq mdoc |
.Pq mdoc , man |
The first call to |
The first call to |
.Ic \&Nm , |
.Ic \&Nm , |
or any call in the NAME section, lacks the required argument. |
or any call in the NAME section, lacks the required argument, or |
|
.Ic \&MR |
|
is called without any argument. |
.It Sy "uname(3) system call failed, using UNKNOWN" |
.It Sy "uname(3) system call failed, using UNKNOWN" |
.Pq mdoc |
.Pq mdoc |
The |
The |
Line 2283 or a request of the |
|
Line 2287 or a request of the |
|
family with more than two arguments |
family with more than two arguments |
.It |
.It |
.Ic \&Dt |
.Ic \&Dt |
|
or |
|
.Ic \&MR |
with more than three arguments |
with more than three arguments |
.It |
.It |
.Ic \&TH |
.Ic \&TH |