mandoc/man.7 - diff

Return to man.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/man.7 between version 1.5 and 1.8

version 1.5, 2009/03/26 23:01:26

version 1.8, 2009/04/05 16:34:22

Line 29 The

.Nm man

language was historically used to format

.Ux

manuals. In this reference document, we describe the syntax and

manuals. This reference document describes the syntax and structure of

structure of the

this language.

.Nm

language.

.Pp

.Em \&Do not ever

.Em \&Do not

use

.Nm

to write your manuals. Use the

Line 88 or a single one-character sequence.

Line 86 or a single one-character sequence.

Characters may alternatively be escaped by a slash-asterisk,

.Sq \e* ,

with the same combinations as described above. This form is deprecated.

.Pp

The

.Xr mdoc 7

contains a table of all available escapes.

.\" SECTION

.Sh STRUCTURE

Macros are one to three three characters in length and begin with a

Line 138 foo

Line 132 foo

.Ed

.Pp

is equivalent to

.Sq \&.RI foo .

If two consecutive lines exhibit the latter behaviour,

an error is raised. Thus, the following is not acceptable:

.Bd -literal -offset indent

Line 180 macros and corresponding number of arguments.

Line 174 macros and corresponding number of arguments.

.It \&.IR Ta n

.It \&.RI Ta n

.El

.Pp

Although not historically part of the

.Nm

system, the following macros are also supported:

.Pp

.Bl -column "MacroX" "Arguments" -compact -offset indent

.It Em Macro Ta Em Arguments

.It \&.br Ta 0

.It \&.i Ta n

.El

.Pp

These follow the same calling conventions as the above

.Nm

macros.

.\" SECTION

.Sh SEE ALSO

.Xr mandoc 1

.Xr mandoc 1 ,

.Xr mandoc_char 7

.\" SECTION

.Sh AUTHORS

The

CVSweb