version 1.66, 2010/06/29 14:55:41 |
version 1.76, 2010/08/18 08:41:40 |
|
|
.\" $Id$ |
.\" $Id$ |
.\" |
.\" |
.\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2009, 2010 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" |
.\" |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" purpose with or without fee is hereby granted, provided that the above |
.\" purpose with or without fee is hereby granted, provided that the above |
|
|
.Fl W Ns Cm all |
.Fl W Ns Cm all |
and |
and |
.Fl f Ns Cm strict . |
.Fl f Ns Cm strict . |
|
.It Fl T Ns Cm pdf |
|
Produce PDF output. |
|
See |
|
.Sx PDF Output . |
.It Fl T Ns Cm ps |
.It Fl T Ns Cm ps |
Produce PostScript output. |
Produce PostScript output. |
See |
See |
|
|
.Qq Adobe-3.0 |
.Qq Adobe-3.0 |
Level-2 pages may be generated by |
Level-2 pages may be generated by |
.Fl T Ns Cm ps . |
.Fl T Ns Cm ps . |
Output pages are US-letter sized and rendered in fixed, 10-point Courier |
Output pages default to letter sized and are rendered in the Times font |
font. |
family, 11-point. |
|
Margins are calculated as 1/9 the page length and width. |
|
Line-height is 1.4m. |
.Pp |
.Pp |
Special characters are rendered as in |
Special characters are rendered as in |
.Sx ASCII Output . |
.Sx ASCII Output . |
Line 316 arguments are accepted: |
|
Line 322 arguments are accepted: |
|
The paper size |
The paper size |
.Ar name |
.Ar name |
may be one of |
may be one of |
.Ar a4 |
.Ar a3 , |
|
.Ar a4 , |
|
.Ar a5 , |
|
.Ar legal , |
or |
or |
.Ar letter . |
.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 |
.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 |
.Ss XHTML Output |
Output produced by |
Output produced by |
.Fl T Ns Cm xhtml |
.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 |
.Sh COMPATIBILITY |
This section summarises |
This section summarises |
.Nm |
.Nm |
compatibility with |
compatibility with GNU troff. |
.Xr groff 1 . |
|
Each input and output format is separately noted. |
Each input and output format is separately noted. |
.Ss ASCII Compatibility |
.Ss ASCII Compatibility |
.Bl -bullet -compact |
.Bl -bullet -compact |
.It |
.It |
The |
The |
.Sq \e~ |
|
special character doesn't produce expected behaviour in |
|
.Fl T Ns Cm ascii . |
|
.It |
|
The |
|
.Sq \&Bd \-literal |
.Sq \&Bd \-literal |
and |
and |
.Sq \&Bd \-unfilled |
.Sq \&Bd \-unfilled |
|
|
.Fl T Ns Cm ascii |
.Fl T Ns Cm ascii |
are synonyms, as are \-filled and \-ragged. |
are synonyms, as are \-filled and \-ragged. |
.It |
.It |
In |
In GNU troff, the |
.Xr groff 1 , |
|
the |
|
.Sq \&Pa |
.Sq \&Pa |
.Xr mdoc 7 |
.Xr mdoc 7 |
macro does not underline when scoped under an |
macro does not underline when scoped under an |
|
|
.It |
.It |
Words aren't hyphenated. |
Words aren't hyphenated. |
.It |
.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. |
Sentences are unilaterally monospaced. |
.El |
.El |
.Ss HTML/XHTML Compatibility |
.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 |
Be aware of this when setting long link |
formats such as |
formats such as |
.Fl O Ns Cm style Ns = Ns Ar really/long/link . |
.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 |
.Pp |
Nesting elements within next-line element scopes of |
Nesting elements within next-line element scopes of |
.Fl m Ns Cm an , |
.Fl m Ns Cm an , |