version 1.92, 2010/12/08 10:58:22 |
version 1.99, 2011/03/07 01:35:51 |
Line 53 Other lines are interpreted within the current state. |
|
Line 53 Other lines are interpreted within the current state. |
|
.Nm |
.Nm |
documents may contain only graphable 7-bit ASCII characters, the |
documents may contain only graphable 7-bit ASCII characters, the |
space character, and the tab character. |
space character, and the tab character. |
All manuals must have |
|
.Ux |
|
line termination. |
|
.Pp |
.Pp |
Blank lines are acceptable; where found, the output will assert a |
Blank lines are acceptable; where found, the output will assert a |
vertical space. |
vertical space. |
|
.Pp |
|
If the first character of a line is a space, that line is printed |
|
with a leading newline. |
.Ss Comments |
.Ss Comments |
Text following a |
Text following a |
.Sq \e\*q , |
.Sq \e\*q , |
Line 118 rendered as an empty line. |
|
Line 118 rendered as an empty line. |
|
.Pp |
.Pp |
In macro lines, whitespace delimits arguments and is discarded. |
In macro lines, whitespace delimits arguments and is discarded. |
If arguments are quoted, whitespace within the quotes is retained. |
If arguments are quoted, whitespace within the quotes is retained. |
.Ss Dates |
|
The |
|
.Sx \&TH |
|
macro is the only |
|
.Nm |
|
macro that requires a date. |
|
The form for this date is the ISO-8601 |
|
standard |
|
.Cm YYYY-MM-DD . |
|
.Ss Scaling Widths |
.Ss Scaling Widths |
Many macros support scaled widths for their arguments, such as |
Many macros support scaled widths for their arguments, such as |
stipulating a two-inch paragraph indentation with the following: |
stipulating a two-inch paragraph indentation with the following: |
Line 370 Thus, the following are equivalent: |
|
Line 361 Thus, the following are equivalent: |
|
\&.\ \ \ PP |
\&.\ \ \ PP |
.Ed |
.Ed |
.Pp |
.Pp |
|
To include space characters in macro arguments, arguments may be quoted; |
|
see the |
|
.Sq MACRO SYNTAX |
|
section in the |
|
.Xr roff 7 |
|
manual for details. |
|
.Pp |
The |
The |
.Nm |
.Nm |
macros are classified by scope: line scope or block scope. |
macros are classified by scope: line scope or block scope. |
Line 527 Whitespace between arguments is omitted in output. |
|
Line 525 Whitespace between arguments is omitted in output. |
|
.Pp |
.Pp |
Examples: |
Examples: |
.Pp |
.Pp |
.D1 \&.BI bold italic bold italic |
.Dl \&.BI bold italic bold italic |
.Pp |
.Pp |
The output of this example will be emboldened |
The output of this example will be emboldened |
.Dq bold |
.Dq bold |
Line 756 The paragraph left-margin width is reset to the defaul |
|
Line 754 The paragraph left-margin width is reset to the defaul |
|
Sets the title of the manual page with the following syntax: |
Sets the title of the manual page with the following syntax: |
.Bd -filled -offset indent |
.Bd -filled -offset indent |
.Pf \. Sx \&TH |
.Pf \. Sx \&TH |
.Cm title section |
.Ar title section date |
.Op Cm date Op Cm source Op Cm volume |
.Op Ar source Op Ar volume |
.Ed |
.Ed |
.Pp |
.Pp |
At least the upper-case document |
Conventionally, the document |
.Cm title |
.Ar title |
and the manual |
is given in all caps. |
.Cm section |
The recommended |
arguments must be provided. |
.Ar date |
The |
format is |
.Cm date |
.Sy YYYY-MM-DD |
argument should be formatted as described in |
as specified in the ISO-8601 standard; |
.Sx Dates , |
if the argument does not conform, it is printed verbatim. |
but will be printed verbatim if it is not. |
If the |
If the date is not specified, the current date is used. |
.Ar date |
The |
is empty or not specified, the current date is used. |
.Cm source |
The optional |
|
.Ar source |
string specifies the organisation providing the utility. |
string specifies the organisation providing the utility. |
The |
The |
.Cm volume |
.Ar volume |
string replaces the default rendered volume, which is dictated by the |
string replaces the default rendered volume, which is dictated by the |
manual section. |
manual section. |
.Pp |
.Pp |
Examples: |
Examples: |
.Pp |
.Pp |
.D1 \&.TH CVS 5 "1992-02-12" GNU |
.Dl \&.TH CVS 5 "1992-02-12" GNU |
.Ss \&TP |
.Ss \&TP |
Begin a paragraph where the head, if exceeding the indentation width, is |
Begin a paragraph where the head, if exceeding the indentation width, is |
followed by a newline; if not, the body follows on the same line after a |
followed by a newline; if not, the body follows on the same line after a |
Line 912 In GNU troff, this would result in strange behaviour. |
|
Line 911 In GNU troff, this would result in strange behaviour. |
|
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr man 1 , |
.Xr man 1 , |
.Xr mandoc 1 , |
.Xr mandoc 1 , |
|
.Xr eqn 7 , |
.Xr mandoc_char 7 , |
.Xr mandoc_char 7 , |
.Xr mdoc 7 |
.Xr mdoc 7 , |
|
.Xr roff 7 , |
|
.Xr tbl 7 |
.Sh HISTORY |
.Sh HISTORY |
The |
The |
.Nm |
.Nm |