mandoc/mandoc.1 - diff

Return to mandoc.1 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mandoc.1 between version 1.67 and 1.76

version 1.67, 2010/06/30 20:57:41

version 1.76, 2010/08/18 08:41:40

Line 1

.\" $Id$

.\"

.\" Permission to use, copy, modify, and distribute this software for any

.\" purpose with or without fee is hereby granted, provided that the above

Line 192 Implies

.Fl W Ns Cm all

and

.Fl f Ns Cm strict .

.It Fl T Ns Cm pdf

Produce PDF output.

See

.Sx PDF Output .

.It Fl T Ns Cm ps

Produce PostScript output.

See

Line 303 PostScript

Line 307 PostScript

Level-2 pages may be generated by

.Fl T Ns Cm ps .

Output pages default to letter sized and are rendered in the Times font

family.

family, 11-point.

Margins are calculated as 1/9 the page length and width.

Line-height is 1.4m.

.Pp

Special characters are rendered as in

.Sx ASCII Output .

Line 316 arguments are accepted:

Line 322 arguments are accepted:

The paper size

.Ar name

may be one of

.Ar a4

.Ar a3 ,

.Ar a4 ,

.Ar a5 ,

.Ar legal ,

.Ar letter .

You may also manually specify dimensions as

.Ar NNxNN ,

width by height in millimetres.

If an unknown value is encountered,

.Ar letter

is used.

.El

.Ss PDF Output

PDF-1.1 output may be generated by

.Fl T Ns Cm pdf .

See

.Sx PostScript Output

for

.Fl O

arguments and defaults.

.Ss XHTML Output

Output produced by

.Fl T Ns Cm xhtml

Line 351 To produce a series of PostScript manuals for A4 paper

Line 374 To produce a series of PostScript manuals for A4 paper

.Sh COMPATIBILITY

This section summarises

.Nm

compatibility with

compatibility with GNU troff.

.Xr groff 1 .

Each input and output format is separately noted.

.Ss ASCII Compatibility

.Bl -bullet -compact

.It

The

.Sq \e~

special character doesn't produce expected behaviour in

.Fl T Ns Cm ascii .

.It

The

.Sq \&Bd \-literal

and

.Sq \&Bd \-unfilled

Line 372 in

Line 389 in

.Fl T Ns Cm ascii

are synonyms, as are \-filled and \-ragged.

.It

In GNU troff, the

.Xr groff 1 ,

the

.Sq \&Pa

.Xr mdoc 7

macro does not underline when scoped under an

Line 400 has no effect.

Line 415 has no effect.

.It

Words aren't hyphenated.

.It

In normal mode (not a literal block), blocks of spaces aren't preserved,

so double spaces following sentence closure are reduced to a single space;

.Xr groff 1

retains spaces.

.It

Sentences are unilaterally monospaced.

.El

.Ss HTML/XHTML Compatibility

Line 466 which is usually 1024 bytes.

Line 476 which is usually 1024 bytes.

Be aware of this when setting long link

formats such as

.Fl O Ns Cm style Ns = Ns Ar really/long/link .

.Pp

The

.Fl T Ns Cm html

and

.Fl T Ns Cm xhtml

output modes don't render the

.Sq \es

font size escape documented in

.Xr mdoc 7

and

.Xr man 7 .

.Pp

Nesting elements within next-line element scopes of

.Fl m Ns Cm an ,

CVSweb