mandoc/roff.7 - diff

Return to roff.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/roff.7 between version 1.35 and 1.42

version 1.35, 2011/11/21 22:19:23

version 1.42, 2013/08/08 20:07:47

Line 83 depends on the respective processing context.

.Nm

documents may contain only graphable 7-bit ASCII characters, the space

character, and, in certain circumstances, the tab character.

The back-space character

The backslash character

.Sq \e

indicates the start of an escape sequence for

.Sx Comments ,

Line 146 respectively) may be used instead.

The indicator or numerical representative may be preceded by C

(constant-width), which is ignored.

.Pp

The two-character indicator

.Sq BI

requests a font that is both bold and italic.

It may not be portable to old roff implementations.

.Pp

Examples:

.Bl -tag -width Ds -offset indent -compact

.It Li \efBbold\efR

Write in bold, then switch to regular font mode.

Write in \fBbold\fP, then switch to regular font mode.

.It Li \efIitalic\efP

Write in italic, then return to previous font mode.

Write in \fIitalic\fP, then return to previous font mode.

.It Li \ef(BIbold italic\efP

Write in \f(BIbold italic\fP, then return to previous font mode.

.El

.Pp

Text decoration is

Line 417 The syntax of this request is the same as that of

Line 424 The syntax of this request is the same as that of

It is currently ignored by

.Xr mandoc 1 ,

as are its children.

.Ss \&cc

Changes the control character.

Its syntax is as follows:

.Bd -literal -offset indent

.Pf . Cm \&cc Op Ar c

.Ed

.Pp

.Ar c

is not specified, the control character is reset to

.Sq \&. .

Trailing characters are ignored.

.Ss \&de

Define a

.Nm

Line 844 only accepts relative paths not containing the strings

Line 863 only accepts relative paths not containing the strings

.Qq ../

and

.Qq /.. .

.Pp

This request requires

.Xr man 1

to change to the right directory before calling

.Xr mandoc 1 ,

per convention to the root of the manual tree.

Typical usage looks like:

.Pp

.Dl \&.so man3/Xcursor.3

.Pp

As the whole concept is rather fragile, the use of

.Sx \&so

is discouraged.

Use

.Xr ln 1

instead.

.Ss \&ta

Set tab stops.

This line-scoped request can take an arbitrary number of arguments.

Line 880 See

Line 915 See

.Xr tbl 7

for a description of the tbl language.

.Sh COMPATIBILITY

This section documents compatibility between mandoc and other other

This section documents compatibility between mandoc and other

.Nm

implementations, at this time limited to GNU troff

.Pq Qq groff .

Line 952 Saltzer in 1964.

Line 987 Saltzer in 1964.

Doug McIlroy rewrote it in BCPL in 1969, renaming it

.Nm .

Dennis M. Ritchie rewrote McIlroy's

.Nm

in PDP-11 assmebly for

in PDP-11 assembly for

.At v1 ,

Joseph F. Ossanna improved roff and renamed it nroff

for

Line 966 In 1989, James Clarke re-implemented troff in C++, nam

Line 1001 In 1989, James Clarke re-implemented troff in C++, nam

This

.Nm

reference was written by

.An Kristaps Dzonsons ,

.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv

.Mt kristaps@bsd.lv ;

and

.An Ingo Schwarze ,

.An Ingo Schwarze Aq Mt schwarze@openbsd.org .

.Mt schwarze@openbsd.org .

CVSweb