mandoc/mdoc.7 - diff

Return to mdoc.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mdoc.7 between version 1.159 and 1.170

version 1.159, 2010/09/26 19:46:48

version 1.170, 2010/12/18 19:12:00

Line 604 closes it out.

.Pp

The

.Em Callable

column indicates that the macro may be called subsequent to the initial

column indicates that the macro may also be called by passing its name

line-macro.

as an argument to another macro.

If a macro is not callable, then its invocation after the initial line

If a macro is not callable but its name appears as an argument

macro is interpreted as opaque text, such that

to another macro, it is interpreted as opaque text.

For example,

.Sq \&.Fl \&Sh

produces

.Sq Fl \&Sh .

.Pp

The

.Em Parsed

column indicates whether the macro may be followed by further

column indicates whether the macro may call other macros by receiving

(ostensibly callable) macros.

their names as arguments.

If a macro is not parsed, subsequent macro invocations on the line

If a macro is not parsed but the name of another macro appears

will be interpreted as opaque text.

as an argument, it is interpreted as opaque text.

.Pp

The

.Em Scope

Line 1646 It must be one of

Line 1647 It must be one of

.Ar luna88k ,

.Ar mac68k ,

.Ar macppc ,

.Ar mips64 ,

.Ar mvme68k ,

.Ar mvme88k ,

.Ar mvmeppc ,

Line 1869 Examples:

Line 1871 Examples:

\&.Fn funcname

.Ed

.Pp

When referring to a function documented in another manual page, use

.Sx \&Xr

instead.

See also

.Sx MANUAL STRUCTURE

and

Line 2119 Examples:

Line 2124 Examples:

Format a

.Dq mailto:

hyperlink.

If an argument is not provided, the string

.Dq \(ti

is used as a default.

Its syntax is as follows:

.Pp

.D1 Pf \. Sx \&Mt Cm address

Line 2300 and

Line 2308 and

.Sx \&Ux .

.Ss \&Pa

A file-system path.

If an argument is not provided, the string

.Dq \(ti

is used as a default.

.Pp

Examples:

.D1 \&.Pa /usr/bin/mandoc

Line 2654 and

Line 2665 and

Close a scope opened by

.Sx \&Xo .

.Ss \&Xo

Open an extension scope.

Extend the header of an

This macro originally existed to extend the 9-argument limit of troff;

.Sx \&It

since this limit has been lifted, the macro has been deprecated.

macro or the body of a partial-implicit block macro

beyond the end of the input line.

This macro originally existed to work around the 9-argument limit

of historic

.Xr roff 7 .

.Ss \&Xr

Link to another manual

.Pq Qq cross-reference .

Line 2710 troff implementations, at this time limited to GNU tro

Line 2725 troff implementations, at this time limited to GNU tro

.Pq Qq groff .

The term

.Qq historic groff

refers to groff versions before the

refers to groff versions before 1.17,

which featured a significant update of the

.Pa doc.tmac

file re-write

file.

.Pq somewhere between 1.15 and 1.19 .

.Pp

Heirloom troff, the other significant troff implementation accepting

\-mdoc, is similar to historic groff.

Line 2723 The following problematic behaviour is found in groff:

Line 2738 The following problematic behaviour is found in groff:

.Pp

.Bl -dash -compact

.It

Display macros

.Pq Sx \&Bd , Sx \&Dl , and Sx \&D1

may not be nested.

\*[hist]

.It

.Sx \&At

with unknown arguments produces no output at all.

\*[hist]

Line 2803 can only be called by other macros, but not at the beg

Line 2823 can only be called by other macros, but not at the beg

.It

.Sx \&%C

is not implemented.

.It

Historic groff only allows up to eight or nine arguments per macro input

line, depending on the exact situation.

Providing more arguments causes garbled output.

The number of arguments on one input line is not limited with mandoc.

.It

Historic groff has many un-callable macros.

Most of these (excluding some block-level macros) are callable

CVSweb