mandoc/roff.7 - diff

Return to roff.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/roff.7 between version 1.65 and 1.71

version 1.65, 2015/01/21 20:33:25

version 1.71, 2015/04/29 18:35:00

Line 1196 This is a Heirloom extension and currently unsupported

Set an input line trap.

Its syntax is as follows:

.Pp

.D1 Pf . Cm it Ar number macro

.D1 Pf . Cm it Ar expression macro

.Pp

The named

.Ar macro

will be invoked after processing the specified

will be invoked after processing the number of input text lines

.Ar number

specified by the numerical

of input text lines.

.Ar expression .

While evaluating the

.Ar expression ,

the unit suffixes described below

.Sx Scaling Widths

are ignored.

.Ss \&itc

Set an input line trap, not counting lines ending with \ec.

Currently unsupported.

Line 1439 Retrieve the bounding box of a PostScript file.

Line 1444 Retrieve the bounding box of a PostScript file.

Currently unsupported.

.Ss \&pshape

Set a special shape for the current paragraph.

This is a Heirloom extension and currently ignored.

This is a Heirloom extension and currently unsupported.

.Ss \&pso

Include output of a shell command.

Ignored because insecure.

Line 1572 See

Line 1577 See

.Ss \&ta

Set tab stops.

Takes an arbitrary number of arguments.

Currently ignored.

Currently unsupported.

.Ss \&tc

Change tab repetion character.

Currently unsupported.

Line 1582 See

Line 1587 See

.Sx \&TS .

.Ss \&ti

Temporary indent.

Currently ignored.

Currently unsupported.

.Ss \&tkf

Enable track kerning for a font.

Currently ignored.

Line 1715 prefixed by an optional sign

Line 1720 prefixed by an optional sign

.Sq +

.Sq - .

Each number may be followed by one optional scaling unit described below

.Sx Scaling Widths .

The following equations hold:

.Bd -literal -offset indent

1i = 6v = 6P = 10m = 10n = 72p = 1000M = 240u = 240

254c = 100i = 24000u = 24000

1f = 65536u = 65536

.Ed

.Pp

The following binary operators are implemented.

Unless otherwise stated, they behave as in the C language:

Line 1948 For short names, there are variants

Line 1961 For short names, there are variants

and

.No \en( Ns Ar cc .

.Ss \eo\(aq Ns Ar string Ns \(aq

Overstrike, that is, write all the characters contained in the

Overstrike, writing all the characters contained in the

.Ar string

to the same output position.

In terminal and HTML output modes,

Line 2015 Print

Line 2028 Print

with zero width and height; ignored by

.Xr mandoc 1 .

.Ss \ez

Output the next character without advancing the cursor position;

Output the next character without advancing the cursor position.

approximated in

.Xr mandoc 1

by simply skipping the next character.

.Sh COMPATIBILITY

This section documents compatibility between mandoc and other

The

.Xr mandoc 1

implementation of the

.Nm

implementations, at this time limited to GNU troff

language is intentionally incomplete.

.Pq Qq groff .

Unimplemented features include:

The term

.Qq historic groff

refers to groff version 1.15.

.Pp

.Bl -dash -compact

.It

For security reasons,

.Xr mandoc 1

never reads or writes external files except via

.Sx \&so

requests with safe relative paths.

.It

There is no automatic hyphenation, no adjustment to the right margin,

and no centering; the output is always set flush-left.

.It

Support for setting tabulator positions

and tabulator and leader characters is missing,

and support for manually changing indentation is limited.

.It

The

.Sq u

scaling unit is the default terminal unit.

In traditional troff systems, this unit would change depending on the

In traditional troff systems, this unit changes depending on the

output media.

.It

In mandoc, the

Width measurements are implemented in a crude way

.Sx \&EQ ,

and often yield wrong results.

.Sx \&TE ,

Explicit movement requests and escapes are ignored.

.Sx \&TS ,

and

.Sx \&T& ,

macros are considered regular macros.

In all other

.Nm

implementations, these are special macros that must be specified without

spacing between the control character (which must be a period) and the

macro name.

.It

The

There is no concept of output pages, no support for floats,

.Cm nS

graphics drawing, and picture inclusion;

terminal output is always continuous.

.It

Historic groff did not accept white-space before a custom

Requests regarding color, font families, and glyph manipulation

.Ar end

are ignored.

macro for the

Font support is very limited.

.Sx \&ig

Kerning is not implemented, and no ligatures are produced.

request.

.It

The

.Sx \&if

.Qq \(aq

and family would print funny white-spaces with historic groff when

macro control character does not suppress output line breaks.

using the next-line syntax.

.It

Diversions are not implemented,

and support for traps is very incomplete.

.It

While recursion is supported,

.Sx \&while

loops are not.

.El

.Pp

The special semantics of the

.Cm nS

number register is an idiosyncracy of

.Ox

manuals and not supported by other

.Xr mdoc 7

implementations.

.Sh SEE ALSO

.Xr mandoc 1 ,

.Xr eqn 7 ,

CVSweb