mandoc/mdoc.7 - diff

Return to mdoc.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mdoc.7 between version 1.237 and 1.241

version 1.237, 2014/09/17 00:43:15

version 1.241, 2014/11/16 20:46:21

Line 388 See

References other manuals with related topics.

This section should exist for most manuals.

Cross-references should conventionally be ordered first by section, then

alphabetically.

alphabetically (ignoring case).

.Pp

References to other documentation concerning the topic of the manual page,

for example authoritative books or journal articles, may also be

Line 937 The

.Fl width

and

.Fl offset

arguments accept scaling widths as described in

arguments accept macro names as described for

.Xr roff 7

.Sx \&Bd

.Fl offset ,

scaling widths as described in

.Xr roff 7 ,

or use the length of the given string.

The

.Fl offset

Line 1570 arguments are treated as separate utilities.

Line 1573 arguments are treated as separate utilities.

See also

.Sx \&Rv .

.Ss \&Fa

Function argument.

Function argument or parameter.

Its syntax is as follows:

.Bd -ragged -offset indent

.Pf \. Sx \&Fa

Line 2559 The following refer to parts of it.

Line 2562 The following refer to parts of it.

.Pp

.It \-xns5

.St -xns5

.It \-xns5.2d2.0

.St -xns5.2d2.0

.It \-xns5.2

.St -xns5.2

.Pp

.It \-p1387.2

.St -p1387.2

.It \-p1387.2-95

.St -p1387.2-95

.br

POSIX software administration.

.El

.It Single UNIX Specification version 3 and related standards

.Pp

Line 2579 POSIX software administration.

Line 2573 POSIX software administration.

.br

Additional real-time extensions.

.Pp

.It \-p1003.1j-2000

.St -p1003.1j-2000

.br

Advanced real-time extensions.

.Pp

.It \-p1003.1q-2000

.St -p1003.1q-2000

.br

Amendment 7: Tracing [C Language].

.Pp

.It \-p1003.1-2001

.St -p1003.1-2001

.It \-susv3

Line 2704 A variable name.

Line 2688 A variable name.

Examples:

.Dl \&.Va foo

.Dl \&.Va const char *bar ;

.Pp

For function arguments and parameters, use

.Sx \&Fa

instead.

For declarations of global variables in the

.Em SYNOPSIS

section, use

.Sx \&Vt .

.Ss \&Vt

A variable type.

.Pp

This is also used for indicating global variables in the

.Em SYNOPSIS

section, in which case a variable name is also specified.

Line 2720 In the former case, this macro starts a new output lin

Line 2713 In the former case, this macro starts a new output lin

and a blank line is inserted in front if there is a preceding

function definition or include directive.

.Pp

Note that this should not be confused with

.Sx \&Ft ,

which is used for function return types.

.Pp

Examples:

.Dl \&.Vt unsigned char

.Dl \&.Vt extern const char * const sys_signame[] \&;

.Pp

For parameters in function prototypes, use

.Sx \&Fa

instead, for function return types

.Sx \&Ft ,

and for variable names outside the

.Em SYNOPSIS

section

.Sx \&Va ,

even when including a type with the name.