mandoc/mdoc.7 - diff

Return to mdoc.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mdoc.7 between version 1.265 and 1.272

version 1.265, 2017/06/10 16:32:27

version 1.272, 2018/12/23 15:32:31

Line 1

.\" $Id$

.\"

.\" Permission to use, copy, modify, and distribute this software for any

.\" purpose with or without fee is hereby granted, provided that the above

Line 449 in the alphabetical

.It Sx \&Ss Ta subsection header (one line)

.It Sx \&Sx Ta internal cross reference to a section or subsection

.It Sx \&Xr Ta cross reference to another manual page: Ar name section

.It Sx \&Pp , \&Lp Ta start a text paragraph (no arguments)

.It Sx \&Pp Ta start a text paragraph (no arguments)

.El

.Ss Displays and lists

.Bl -column "Brq, Bro, Brc" description

Line 477 in the alphabetical

.It Sx \&Sm Ta switch horizontal spacing mode: Op Cm on | off

.It Sx \&Bk , \&Ek Ta keep block: Fl words

.El

.Ss Semantic markup for command line utilities:

.Ss Semantic markup for command line utilities

.Bl -column "Brq, Bro, Brc" description

.It Sx \&Nm Ta start a SYNOPSIS block with the name of a utility

.It Sx \&Fl Ta command line options (flags) (>=0 arguments)

Line 488 in the alphabetical

.It Sx \&Ev Ta environmental variable (>0 arguments)

.It Sx \&Pa Ta file system path (>=0 arguments)

.El

.Ss Semantic markup for function libraries:

.Ss Semantic markup for function libraries

.Bl -column "Brq, Bro, Brc" description

.It Sx \&Lb Ta function library (one argument)

.It Sx \&In Ta include file (one argument)

Line 509 in the alphabetical

.It Sx \&Er Ta error constant (>0 arguments)

.It Sx \&Ev Ta environmental variable (>0 arguments)

.El

.Ss Various semantic markup:

.Ss Various semantic markup

.Bl -column "Brq, Bro, Brc" description

.It Sx \&An Ta author name (>0 arguments)

.It Sx \&Lk Ta hyperlink: Ar uri Op Ar name

Line 674 Examples:

.Ss \&Ao

Begin a block enclosed by angle brackets.

Does not have any head arguments.

.Pp

This macro is almost never useful.

Examples:

See

.Dl \&.Fl -key= \&Ns \&Ao \&Ar val \&Ac

.Sx \&Aq

.Pp

for more details.

See also

.Sx \&Aq .

.Ss \&Ap

Inserts an apostrophe without any surrounding whitespace.

This is generally used as a grammatical device when referring to the verb

Line 689 Examples:

Line 687 Examples:

.Dl \&.Fn execve \&Ap d

.Ss \&Aq

Encloses its arguments in angle brackets.

The only important use case is for email addresses.

See

.Sx \&Mt

for an example.

.Pp

Examples:

Occasionally, it is used for names of characters and keys, for example:

.Dl \&.Fl -key= \&Ns \&Aq \&Ar val

.Bd -literal -offset indent

Press the

\&.Aq escape

key to ...

.Ed

.Pp

.Em Remarks :

For URIs, use

this macro is often abused for rendering URIs, which should instead use

.Sx \&Lk

instead, and

.Sx \&In

for

.Dq #include

directives.

Never wrap

.Sx \&Ar

.Sx \&Aq .

.Pp

Since

.Sx \&Aq

usually renders with non-ASCII characters in non-ASCII output modes,

do not use it where the ASCII characters

.Sq <

and

.Sq >

are required as syntax elements.

Instead, use these characters directly in such cases, combining them

with the macros

.Sx \&Pf ,

.Sx \&Ns ,

.Sx \&Mt ,

.Sx \&Eo

or to note pre-processor

as needed.

.Dq Li #include

statements, which should use

.Sx \&In .

.Pp

See also

.Sx \&Ao .

Line 1210 The

Line 1234 The

.Ar month

is the full English month name, the

.Ar day

is an optionally zero-padded numeral, and the

is an integer number, and the

.Ar year

is the full four-digit year.

.Pp

Line 1240 If no date string is given, the current date is used.

Line 1264 If no date string is given, the current date is used.

.Pp

Examples:

.Dl \&.Dd $\&Mdocdate$

.Dl \&.Dd $\&Mdocdate: July 21 2007$

.Dl \&.Dd $\&Mdocdate: July 2 2018$

.Dl \&.Dd July 21, 2007

.Dl \&.Dd July 2, 2018

.Pp

See also

.Sx \&Dt

Line 1850 The tab cell delimiter may only be used within the

Line 1874 The tab cell delimiter may only be used within the

.Sx \&It

line itself; on following lines, only the

.Sx \&Ta

macro can be used to delimit cells, and

macro can be used to delimit cells, and portability requires that

.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

Note that quoted strings may span tab-delimited cells on an

.Sx \&It

Line 1919 Examples:

Line 1943 Examples:

See also

.Sx \&Mt .

.Ss \&Lp

Synonym for

Deprecated synonym for

.Sx \&Pp .

.Ss \&Ms

Display a mathematical symbol.

Line 2575 The second and last Technical Corrigendum.

Line 2599 The second and last Technical Corrigendum.

.br

This standard is also called

X/Open Portability Guide version 7.

.Pp

.It \-p1003.1-2013

.St -p1003.1-2013

.br

This is the first Technical Corrigendum.

.El

.It Other standards

.Pp

Line 3203 but produces large indentations.

Line 3222 but produces large indentations.

.Xr tbl 7

.Pp

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

guide for advanced authors, and an alphabetic index helping to choose

the best macros for various kinds of content.

CVSweb