version 1.263, 2017/05/05 02:31:35 |
version 1.269, 2017/07/20 16:24:53 |
Line 476 in the alphabetical |
|
Line 476 in the alphabetical |
|
.It Sx \&Ap Ta apostrophe without surrounding whitespace (no arguments) |
.It Sx \&Ap Ta apostrophe without surrounding whitespace (no arguments) |
.It Sx \&Sm Ta switch horizontal spacing mode: Op Cm on | off |
.It Sx \&Sm Ta switch horizontal spacing mode: Op Cm on | off |
.It Sx \&Bk , \&Ek Ta keep block: Fl words |
.It Sx \&Bk , \&Ek Ta keep block: Fl words |
.It Sx \&sp Ta force vertical space: Op Ar height |
|
.El |
.El |
.Ss Semantic markup for command line utilities: |
.Ss Semantic markup for command line utilities |
.Bl -column "Brq, Bro, Brc" description |
.Bl -column "Brq, Bro, Brc" description |
.It Sx \&Nm Ta start a SYNOPSIS block with the name of a utility |
.It Sx \&Nm Ta start a SYNOPSIS block with the name of a utility |
.It Sx \&Fl Ta command line options (flags) (>=0 arguments) |
.It Sx \&Fl Ta command line options (flags) (>=0 arguments) |
Line 489 in the alphabetical |
|
Line 488 in the alphabetical |
|
.It Sx \&Ev Ta environmental variable (>0 arguments) |
.It Sx \&Ev Ta environmental variable (>0 arguments) |
.It Sx \&Pa Ta file system path (>=0 arguments) |
.It Sx \&Pa Ta file system path (>=0 arguments) |
.El |
.El |
.Ss Semantic markup for function libraries: |
.Ss Semantic markup for function libraries |
.Bl -column "Brq, Bro, Brc" description |
.Bl -column "Brq, Bro, Brc" description |
.It Sx \&Lb Ta function library (one argument) |
.It Sx \&Lb Ta function library (one argument) |
.It Sx \&In Ta include file (one argument) |
.It Sx \&In Ta include file (one argument) |
Line 510 in the alphabetical |
|
Line 509 in the alphabetical |
|
.It Sx \&Er Ta error constant (>0 arguments) |
.It Sx \&Er Ta error constant (>0 arguments) |
.It Sx \&Ev Ta environmental variable (>0 arguments) |
.It Sx \&Ev Ta environmental variable (>0 arguments) |
.El |
.El |
.Ss Various semantic markup: |
.Ss Various semantic markup |
.Bl -column "Brq, Bro, Brc" description |
.Bl -column "Brq, Bro, Brc" description |
.It Sx \&An Ta author name (>0 arguments) |
.It Sx \&An Ta author name (>0 arguments) |
.It Sx \&Lk Ta hyperlink: Ar uri Op Ar name |
.It Sx \&Lk Ta hyperlink: Ar uri Op Ar name |
|
|
.At . |
.At . |
.It Cm III |
.It Cm III |
.At III . |
.At III . |
.It Cm V[.[1-4]]? |
.It Cm V | V.[1-4] |
A version of |
A version of |
.At V . |
.At V . |
.El |
.El |
Line 1851 The tab cell delimiter may only be used within the |
|
Line 1850 The tab cell delimiter may only be used within the |
|
.Sx \&It |
.Sx \&It |
line itself; on following lines, only the |
line itself; on following lines, only the |
.Sx \&Ta |
.Sx \&Ta |
macro can be used to delimit cells, and |
macro can be used to delimit cells, and portability requires that |
.Sx \&Ta |
.Sx \&Ta |
is only recognised as a macro when called by other macros, |
is called by other macros: some parsers do not recognize it when |
not as the first macro on a line. |
it appears as the first macro on a line. |
.Pp |
.Pp |
Note that quoted strings may span tab-delimited cells on an |
Note that quoted strings may span tab-delimited cells on an |
.Sx \&It |
.Sx \&It |
Line 2576 The second and last Technical Corrigendum. |
|
Line 2575 The second and last Technical Corrigendum. |
|
.br |
.br |
This standard is also called |
This standard is also called |
X/Open Portability Guide version 7. |
X/Open Portability Guide version 7. |
.Pp |
|
.It \-p1003.1-2013 |
|
.St -p1003.1-2013 |
|
.br |
|
This is the first Technical Corrigendum. |
|
.El |
.El |
.It Other standards |
.It Other standards |
.Pp |
.Pp |
|
|
.Dl \&.Xr mandoc 1 |
.Dl \&.Xr mandoc 1 |
.Dl \&.Xr mandoc 1 \&; |
.Dl \&.Xr mandoc 1 \&; |
.Dl \&.Xr mandoc 1 \&Ns s behaviour |
.Dl \&.Xr mandoc 1 \&Ns s behaviour |
.Ss \&sp |
|
Emits vertical space. |
|
This macro should not be used; it is implemented for compatibility with |
|
historical manuals. |
|
Its syntax is as follows: |
|
.Pp |
|
.D1 Pf \. Sx \&sp Op Ar height |
|
.Pp |
|
The |
|
.Ar height |
|
argument is a scaling width as described in |
|
.Xr roff 7 . |
|
If unspecified, |
|
.Sx \&sp |
|
asserts a single vertical space. |
|
.Sh MACRO SYNTAX |
.Sh MACRO SYNTAX |
The syntax of a macro depends on its classification. |
The syntax of a macro depends on its classification. |
In this section, |
In this section, |
Line 3034 then the macro accepts an arbitrary number of argument |
|
Line 3013 then the macro accepts an arbitrary number of argument |
|
.It Sx \&Va Ta Yes Ta Yes Ta n |
.It Sx \&Va Ta Yes Ta Yes Ta n |
.It Sx \&Vt Ta Yes Ta Yes Ta >0 |
.It Sx \&Vt Ta Yes Ta Yes Ta >0 |
.It Sx \&Xr Ta Yes Ta Yes Ta 2 |
.It Sx \&Xr Ta Yes Ta Yes Ta 2 |
.It Sx \&sp Ta \&No Ta \&No Ta 1 |
|
.El |
.El |
.Ss Delimiters |
.Ss Delimiters |
When a macro argument consists of one single input character |
When a macro argument consists of one single input character |
Line 3220 but produces large indentations. |
|
Line 3198 but produces large indentations. |
|
.Xr tbl 7 |
.Xr tbl 7 |
.Pp |
.Pp |
The web page |
The web page |
.Lk http://mdocml.bsd.lv/mdoc/ "extended documentation for the mdoc language" |
.Lk http://mandoc.bsd.lv/mdoc/ "extended documentation for the mdoc language" |
provides a few tutorial-style pages for beginners, an extensive style |
provides a few tutorial-style pages for beginners, an extensive style |
guide for advanced authors, and an alphabetic index helping to choose |
guide for advanced authors, and an alphabetic index helping to choose |
the best macros for various kinds of content. |
the best macros for various kinds of content. |