mandoc/roff.7 - diff

Return to roff.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/roff.7 between version 1.33 and 1.41

version 1.33, 2011/09/26 23:07:31

version 1.41, 2013/07/13 19:41:16

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 143 escape followed by an indicator: B (bold), I (italic),

(revert to previous mode).

A numerical representation 3, 2, or 1 (bold, italic, and regular,

respectively) may be used instead.

The indicator or numerical representative may be preceded by C

(constant-width), which is ignored.

.Pp

Examples:

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

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

Line 417 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 842 only accepts relative paths not containing the strings

Line 856 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 878 See

Line 908 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 943 using the next-line syntax.

Line 973 using the next-line syntax.

.%U http://heirloom.sourceforge.net/doctools/troff.pdf

.Re

.Sh HISTORY

The RUNOFF typesetting system was written in PL/1 for the CTSS

The RUNOFF typesetting system, whose input forms the basis for

operating system by Jerome ("Jerry") E. Saltzer in 1961.

It was first used as the main documentation tool by Multics since 1963.

Robert ("Bob") H. Morris ported it to the GE-635 and called it

.Nm ,

Doug McIlroy rewrote it in BCPL in 1969,

was written in MAD and FAP for the CTSS operating system by Jerome E.

Joseph F. Ossanna rewrote it in PDP-11 assembly in 1973,

Saltzer in 1964.

and Brian W. Kernighan rewrote it in C in 1975.

Doug McIlroy rewrote it in BCPL in 1969, renaming it

.Nm .

Dennis M. Ritchie rewrote McIlroy's

.Nm

in PDP-11 assembly for

.At v1 ,

Joseph F. Ossanna improved roff and renamed it nroff

for

.At v2 ,

then ported nroff to C as troff, which Brian W. Kernighan released with

.At v7 .

In 1989, James Clarke re-implemented troff in C++, naming it groff.

.Sh AUTHORS

.An -nosplit

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