1528 lines
36 KiB
Plaintext
1528 lines
36 KiB
Plaintext
.\" This file gives a small example how a web page could look like if created
|
||
.\" with groff.
|
||
.\"
|
||
.\"
|
||
.\" To make it work with other output devices also, we include www.tmac
|
||
.\" directly.
|
||
.\"
|
||
.nr PS 10
|
||
.nr VS 12
|
||
.if '\*[.T]'html' .nr LL 10i
|
||
.if r ps4html .nr LL 10i
|
||
.mso www.tmac
|
||
.
|
||
.de blm-macro
|
||
. nr tmp \\n[.i]
|
||
. LP
|
||
. in \\n[tmp]u
|
||
..
|
||
.blm blm-macro
|
||
.
|
||
.HX 0
|
||
.
|
||
.defcolor mydarkred rgb 0.65f 0.1f 0.2f
|
||
.defcolor mydarkgreen rgb 0.1f 0.5f 0.2f
|
||
.defcolor mydarkblue rgb 0.1f 0.2f 0.6f
|
||
.
|
||
.ds GNU \m[mydarkred]G\m[]\m[mydarkgreen]N\m[]\m[mydarkblue]U\m[]
|
||
.
|
||
.HTL
|
||
.NHR
|
||
.
|
||
Home of Groff (GNU Troff).
|
||
.
|
||
.HTML-IMAGE-LEFT
|
||
.PSPIC -L gnu.eps 2i 2i
|
||
.ie r ps4html \
|
||
. nop \v'-0.66i'\h'2.0i'\s[100]\*[GNU] Troff\s0
|
||
.el \
|
||
. nop \v'-0.66i'\h'2.0i'\s[60]\*[GNU] Troff\s0
|
||
.HTML-IMAGE-END
|
||
.
|
||
.HnS 1
|
||
.HR
|
||
GNU Troff
|
||
.URL http://\:groff.ffii.org/ (Groff)
|
||
\[em] a
|
||
.URL http://\:www.gnu.org/ GNU
|
||
project.
|
||
Hosted by
|
||
.URL http://\:ffii.org/ FFII .
|
||
.HR
|
||
.HnE
|
||
.LK
|
||
|
||
.DC T HE mydarkred
|
||
groff (GNU Troff) software
|
||
is a typesetting package which reads plain text mixed with
|
||
formatting commands and produces formatted output.
|
||
Groff now supports HTML.
|
||
.
|
||
.
|
||
.SH
|
||
Download
|
||
|
||
The source code of the currently released versions of groff is
|
||
available at the
|
||
.URL "ftp://\:groff.ffii.org/\:pub/\:groff/" "FFII host (Germany)" ,
|
||
.URL "ftp://\:ftp.gnu.org/\:gnu/\:groff/" "GNU host (USA)" ,
|
||
and its mirrors.
|
||
.
|
||
The USA site also contains more old, obsolete versions.
|
||
|
||
The most actual pre-release, development version is available from a
|
||
CVS repository, see below.
|
||
.
|
||
Development snapshots (produced twice a day from the CVS repository)
|
||
can be downloaded with FTP from
|
||
.URL "ftp://\:groff.ffii.org/\:pub/\:groff/devel" here .
|
||
|
||
For a special version of groff on the Microsoft operating systems, see
|
||
.URL "http://\:gnuwin32.sf.net/\:packages/\:groffl.htm" "Groff for Windows" .
|
||
|
||
GNU troff is released under the
|
||
.URL http://\:www.gnu.org/\:copyleft/\:gpl.html "GNU Copyright License" .
|
||
|
||
User issues lead:
|
||
.MTO Ted.Harding@\:nessie.mcc.ac.uk "Ted Harding"
|
||
.br
|
||
Technical issues lead:
|
||
.MTO wl@\:gnu.org "Werner Lemberg"
|
||
.
|
||
.
|
||
.SH
|
||
README
|
||
|
||
This is the GNU groff document formatting system.
|
||
The version number is given in the file VERSION.
|
||
|
||
Included in this release are implementations of troff, pic, eqn, tbl,
|
||
grn, refer, \-man, \-mdoc, and \-ms macros, and drivers for PostScript,
|
||
TeX dvi format, HP LaserJet 4 printers, Canon CAPSL printers, HTML format
|
||
(still alpha), and typewriter-like devices.
|
||
Also included is a modified version of the Berkeley \-me macros, an enhanced
|
||
version of the X11 xditview previewer, and an implementation of the \-mm
|
||
macros contributed by
|
||
.MTO jh@\:axis.se "J\[:o]rgen H\[:a]gg" .
|
||
|
||
See the file INSTALL for installation instructions.
|
||
You will require a C++ compiler.
|
||
|
||
The file NEWS describes recent user-visible changes to groff.
|
||
|
||
Groff is free software.
|
||
See the file COPYING for copying permission.
|
||
|
||
The file PROBLEMS describes various problems that have been encountered in
|
||
compiling, installing, and running groff.
|
||
|
||
The most recent released version of groff is always available by anonymous
|
||
ftp from ftp.gnu.org in the directory pub/\:gnu/\:groff.
|
||
|
||
A CVS repository is available, containing the current development
|
||
version of groff.
|
||
You can access it with the commands
|
||
|
||
.in 2m
|
||
.nf
|
||
.ft C
|
||
export CVSROOT=:pserver:anoncvs@anoncvs.ffii.org:/var/cvs
|
||
cvs login
|
||
cvs -z9 co groff
|
||
.ft P
|
||
.fi
|
||
.in
|
||
|
||
(if the prompt for the password appears, just press the enter key).
|
||
After a successful login you no longer need the first two commands; an
|
||
update of a checked out repository should be done with
|
||
|
||
.in 2m
|
||
.ft C
|
||
cvs -z9 update -dP
|
||
.ft P
|
||
.in
|
||
|
||
Please read the info pages of cvs for further details.
|
||
|
||
Alternatively, you can download snapshots (which are updated twice a day)
|
||
from
|
||
.URL ftp://\:ftp.ffii.org/\:pub/\:groff/\:devel/\:groff-current.tar.gz here
|
||
or a diff file relative to the latest official groff release as
|
||
|
||
.in 2m
|
||
.ft C
|
||
ftp://ftp.ffii.org/pub/groff/devel/groff-\[la]version\[ra]-current.diff.gz
|
||
.ft P
|
||
.in
|
||
|
||
Assuming that groff-\[la]version\[ra].tar.gz and
|
||
groff-\[la]version\[ra]-current.diff.gz are in the same directory, do the
|
||
following to apply the diff file:
|
||
|
||
.in 2m
|
||
.nf
|
||
.ft C
|
||
tar xzvf groff-\[la]version\[ra].tar.gz
|
||
cd groff-\[la]version\[ra]
|
||
gunzip -c ../groff-\[la]version\[ra]-current.diff.gz | patch -p1
|
||
.ft P
|
||
.fi
|
||
.in
|
||
|
||
Finally, it is possible to access the CVS with a browser by pointing it
|
||
to
|
||
|
||
.in 2m
|
||
.URL http://www.ffii.org/cgi-bin/viewcvs.cgi/groff \
|
||
http://www.ffii.org/cgi-bin/viewcvs.cgi/groff
|
||
.in
|
||
|
||
Please report bugs using the form in the file BUG-REPORT; the idea of this
|
||
is to make sure that FSF has all the information it needs to fix the bug.
|
||
At the very least, read the BUG-REPORT form and make sure that you supply
|
||
all the information that it asks for.
|
||
Even if you are not sure that something is a bug, report it using
|
||
BUG-REPORT: this will enable us to determine whether it really is a bug or
|
||
not.
|
||
|
||
Three mailing lists are available:
|
||
|
||
.ULS
|
||
.LI
|
||
.MTO bug-groff@gnu.org bug-groff@gnu.org
|
||
for reporting bugs
|
||
|
||
.LI
|
||
.MTO groff@ffii.org groff@ffii.org
|
||
for general discussion of groff
|
||
|
||
.LI
|
||
.MTO groff-commit@ffii.org groff-commit@ffii.org
|
||
a read-only list showing logs of commitments to the CVS repository
|
||
.ULE
|
||
|
||
Note that groff@gnu.org is an alias for
|
||
.MTO groff@\:ffii.org groff@\:ffii.org ;
|
||
you must be subscribed to the `groff' list to send mails.
|
||
|
||
To subscribe, send e-mail to \[la]list\[ra]-request@\[la]domain\[ra]
|
||
(example:
|
||
.MTO groff-request@\:ffii.org groff-request@\:ffii.org )
|
||
with the word `subscribe' in either the
|
||
subject or body of the e-mail (don't include the quotes) or have a look
|
||
at the
|
||
.URL http://\:ffii.org/\:mailman/\:listinfo/\:groff/ \
|
||
"groff mailing list webpage" .
|
||
|
||
GNU groff was written by
|
||
.MTO jjc@\:jclark.com "James Clark" .
|
||
It is now maintained by
|
||
.MTO Ted.Harding@\:nessie.mcc.ac.uk "Ted Harding"
|
||
and
|
||
.MTO wl@\:gnu.org "Werner Lemberg" .
|
||
.
|
||
.
|
||
.SH
|
||
NEWS VERSION 1.19.1
|
||
.
|
||
.SH 2
|
||
groff
|
||
|
||
.ULS
|
||
.LI
|
||
The argument of the command line option `\-I' is now also passed to troff
|
||
and grops, specifying a directory to search for files on the command line,
|
||
files named in `so' and `psbb' requests, and files named in \eX'ps:\~file'
|
||
and \eX'ps:\~import' escapes.
|
||
|
||
.LI
|
||
If option `\-V' is used more than once, the commands will be both printed
|
||
on standard error and run.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
troff
|
||
|
||
.ULS
|
||
.LI
|
||
Two new read-only, string-valued registers `.m' and `.M' return the
|
||
name of the current drawing and background color, respectively.
|
||
|
||
.LI
|
||
New read-only register `.U' which is set to\~1 if in safer mode and set
|
||
to\~0 if in unsafe mode.
|
||
|
||
.LI
|
||
An input encoding file for \%latin-5 (a.k.a.\& ISO \%8859-9) has been
|
||
added.
|
||
Example use:
|
||
|
||
.in 2m
|
||
.ft C
|
||
groff \-Tdvi \-mlatin5 my_file > my_file.dvi
|
||
.ft R
|
||
.in
|
||
|
||
Note that some output devices don't support all glyphs of this encoding.
|
||
|
||
.LI
|
||
If the `return' request is called with an argument, it exits twice,
|
||
namely the current macro and the macro one level higher.
|
||
This is used to define a wrapper macro for `return' in trace.tmac.
|
||
|
||
.LI
|
||
For completeness, two new requests have been added: `dei1' and `ami1'.
|
||
They are equivalent to `dei' and `ami', respectively, but the macros
|
||
are executed with compatibility mode off (similar to `de1' and `am1').
|
||
|
||
.LI
|
||
New command line option `\-I' to specify a directory for files (both
|
||
those on the command line and those named in `psbb' requests).
|
||
This is also handled by the groff wrapper program.
|
||
|
||
.LI
|
||
Since version 1.19 you can say `.vs\~0'.
|
||
Older versions emit a warning and convert this to `.vs\~\en[.V]'.
|
||
|
||
This hasn't been documented properly.
|
||
Note that `.vs\~0' isn't saved in a diversion since it doesn't result
|
||
in vertical motion.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
pic
|
||
|
||
.ULS
|
||
.LI
|
||
Dashed and dotted ellipses have been implemented.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
tbl
|
||
|
||
.ULS
|
||
.LI
|
||
New key character `x' to make tbl call a user-defined macro on a table
|
||
cell.
|
||
Patch by
|
||
.MTO hj.oertel@\:surfeu.de "Heinz-J<>rgen Oertel" .
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
grap2graph
|
||
|
||
.ULS
|
||
.LI
|
||
A new script contributed by
|
||
.MTO esr@\:thyrsus.com "Eric S. Raymond" .
|
||
It converts a grap diagram into a cropped image.
|
||
Since it uses gs and the PNM library, virtually all graphics formats
|
||
are available for output.
|
||
[Note that the grap program itself isn't part of the groff package;
|
||
see the file MORE.STUFF how to obtain grap.]
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
grohtml
|
||
|
||
.ULS
|
||
.LI
|
||
New option `\-j' to emit output splitted into multiple files.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
grops
|
||
|
||
.ULS
|
||
.LI
|
||
New command line option `\-I' to specify a directory to search for files
|
||
on the command line and files named in \eX'ps:\~import' and \eX'ps:\~file'
|
||
escapes.
|
||
This is also handled by the groff wrapper program.
|
||
|
||
.LI
|
||
The default value for the `broken' keyword in the DESC file is now\~0.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
grolj4
|
||
|
||
.ULS
|
||
.LI
|
||
A new man page `lj4_font(5)' documents how fonts are accessed with
|
||
grolj4.
|
||
|
||
.LI
|
||
The built-in fonts for LJ4 and newer PCL\~5 devices have been completely
|
||
revised, mainly to access as much glyphs as possible.
|
||
The provided metric files should be compatible with recent PCL\~5 printers
|
||
also.
|
||
Additionally, font description files have been added for the Arial and
|
||
Times New Roman family, the MS symbol, and Wingdings fonts.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
afmtodit
|
||
|
||
.ULS
|
||
.LI
|
||
New option `\-x' to prevent use of built-in Adobe Glyph List.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
hpftodit
|
||
|
||
.ULS
|
||
.LI
|
||
Completely revised to handle HP TrueType metric files also.
|
||
See the hpftodit manual page for more details.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
groffer
|
||
|
||
.ULS
|
||
.LI
|
||
This version is a rewrite of groffer in many parts, but it is kept in
|
||
the old single script style.
|
||
|
||
.ULS
|
||
.LI
|
||
New options: \-\-text (\-\-mode\~text), \-\-tty-viewer, \-\-X (\-\-mode\~X),
|
||
\-\-X-viewer, \-\-html (\-\-mode\~html), \-\-html-view, \-\-apropos-data,
|
||
\-\-apropos-devel, \-\-apropos-progs.
|
||
|
||
.LI
|
||
New documentation file README_SH.
|
||
|
||
.LI
|
||
Enhancement of the configuration files and the `apropos' handling.
|
||
.ULE
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
macro packages
|
||
|
||
.ULS
|
||
.LI
|
||
www.tmac: New macro `JOBNAME' to split output into multiple files.
|
||
|
||
.LI
|
||
In mdoc, multiple calls to `.Lb' are now supported in the LIBRARY
|
||
section.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH
|
||
NEWS VERSION 1.19
|
||
.
|
||
.SH 2
|
||
troff
|
||
|
||
.ULS
|
||
.LI
|
||
Input encoding files for \%latin-9 (a.k.a.\& \%latin-0 and ISO \%8859-15)
|
||
and \%latin-2 (ISO \%8859-2) have been added.
|
||
Example use:
|
||
|
||
.in 2m
|
||
.ft C
|
||
groff -Tdvi -mlatin9 my_file > my_file.dvi
|
||
.ft P
|
||
.in
|
||
|
||
You still need proper fonts with the necessary glyphs.
|
||
Out of the box, the groff package supports \%latin-9 only for \-Tps,
|
||
\-Tdvi, and \-Tutf8, and \%latin-2 only for \-Tdvi and \-Tutf8.
|
||
|
||
.LI
|
||
Composite glyphs are now supported.
|
||
To do this, a subset of the Adobe Glyph List (AGL) Algorithm as described in
|
||
.URL http://partners.adobe.com/asn/tech/type/unicodegn.jsp \
|
||
http://partners.adobe.com/asn/tech/type/unicodegn.jsp
|
||
is used to construct glyph names based on Unicode character codes.
|
||
The existing groff glyph names are frozen; no glyph names which can't be
|
||
constructed algorithmically will be added in the future.
|
||
|
||
The \e[...] escape sequence has been extended to specify multiple glyph
|
||
components.
|
||
Example:
|
||
|
||
.in 2m
|
||
.ft C
|
||
\e[A ho]
|
||
.ft R
|
||
.in
|
||
|
||
this accesses a glyph with the name `u0041_0328'.
|
||
|
||
Some groff glyphs which are useful as composites map to `wrong' Unicode
|
||
code points.
|
||
For example, `ho' maps to U+02DB which is a spacing ogonek, whereas a
|
||
non-spacing ogonek U+0328 is needed for composite glyphs.
|
||
The new request
|
||
|
||
.in 2m
|
||
.ft C
|
||
\&.composite from to
|
||
.ft R
|
||
.in
|
||
|
||
will change the mapping while a composite glyph name is constructed.
|
||
To make \e[A\~ho] yield the expected result,
|
||
|
||
.in 2m
|
||
.ft C
|
||
\&.composite ho u0328
|
||
.ft R
|
||
.in
|
||
|
||
is needed.
|
||
[The new file `composite.tmac' loaded at start-up already
|
||
contains proper calls to `.composite'.]
|
||
|
||
Please refer to the info pages of groff and to the groff_char man page
|
||
for more details.
|
||
|
||
.LI
|
||
A new request `fschar' has been added to define font-specific fallback
|
||
characters.
|
||
They are searched after the list of fonts declared with the
|
||
`fspecial' request but before the list of fonts declared with `special'.
|
||
|
||
.LI
|
||
Fallback characters defined with `fschar' can be removed with the
|
||
new `rfschar' request.
|
||
|
||
.LI
|
||
A new request `schar' has been added to define global fallback
|
||
characters.
|
||
They are searched after the list of fonts declared with the
|
||
`special' request but before the already mounted special fonts.
|
||
|
||
.LI
|
||
In groff versions 1.18 and 1.18.1, \eD'f\~...'\& didn't move the current
|
||
point horizontally.
|
||
Despite of being silly, this change has been reverted for backwards
|
||
compatibility.
|
||
Consequently, the intermediate output command `Df' also moves the
|
||
position horizontally again.
|
||
|
||
\eD'f\~...'\& is deprecated since it depends on the horizontal resolution
|
||
of the output device (given with the `hor' parameter in the DESC file).
|
||
Use the new \eD'Fg\~...'\& escape instead.
|
||
|
||
.LI
|
||
For orthogonality, new \eD subcommands to change the fill color are
|
||
available:
|
||
|
||
.in 2m
|
||
.ft C
|
||
\eD'Fr ...' \f[R](rgb)\f[]
|
||
.br
|
||
\eD'Fc ...' \f[R](cmy)\f[]
|
||
.br
|
||
\eD'Fg ...' \f[R](gray)\f[]
|
||
.br
|
||
\eD'Fk ...' \f[R](cmyk)\f[]
|
||
.br
|
||
\eD'Fd' \f[R](default color)\f[]
|
||
.ft R
|
||
.in
|
||
|
||
The arguments are the same as with the `defcolor' request.
|
||
The current position is \f[I]not\f[] changed.
|
||
|
||
.LI
|
||
The values set with \eH and \eS are now available in number registers
|
||
\en[.height] and \en[.slant], respectively.
|
||
|
||
.LI
|
||
The `.pe' number register isn't new but hasn't been documented before.
|
||
It is set to\~1 during a page ejection caused by the `bp' request.
|
||
|
||
.LI
|
||
The new glyph symbol `tno' is a textual variant of `no'.
|
||
|
||
.LI
|
||
The new glyph symbol `+e' represents U+03F5, GREEK LUNATE EPSILON SYMBOL.
|
||
(Well, it is not really new since it has been previously supported by
|
||
grolj4.)
|
||
The mapping for both the dvi and lj4 symbol font has been
|
||
changed accordingly so that Greek small letter epsilon, `*e', has the
|
||
same glyph shape as with other devices.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
grops
|
||
|
||
.ULS
|
||
.LI
|
||
The font `freeeuro.pfa' has been added to provide various default glyph
|
||
shapes for `eu' and `Eu'.
|
||
|
||
.LI
|
||
It is now possible to access all glyphs in a Type\~1 font, not only 256
|
||
(provided the font file created by afmtodit has proper entries).
|
||
grops constructs additional encoding vectors on the fly if necessary.
|
||
|
||
.LI
|
||
The paper size is now emitted via the %%DocumentMedia and PageSize
|
||
mechanisms so that it is no longer required to tell `gv' or `ps2pdf'
|
||
about the paper size.
|
||
The `broken' flag value\~16 omits this feature
|
||
(the used PostScript command `setpagedevice' is a LanguageLevel\~2
|
||
extension).
|
||
Patch by
|
||
.MTO egil@\:kvaleberg.no "Egil Kvaleberg" .
|
||
|
||
.LI
|
||
Non-slanted PostScript metrics have been changed again; they no longer
|
||
contain negative left italic correction values.
|
||
This assures correct spacing with eqn.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
grodvi
|
||
|
||
.ULS
|
||
.LI
|
||
The font cmtex10 has been added as the special font `SC' to the DVI fonts.
|
||
It is used as a font-specific special font for CW and CWI.
|
||
|
||
.LI
|
||
New options \-l and \-p to set landscape orientation and the paper size.
|
||
grodvi now emits a `papersize' special which is understood by DVI drivers
|
||
like dvips.
|
||
|
||
Consequently, the DESC file should contain a `papersize' keyword.
|
||
|
||
.LI
|
||
The glyph shapes for \e[*f] and \e[*e] have been exchanged with \e[+f] and
|
||
\e[+e], respectively, to be in sync with all other devices.
|
||
|
||
.LI
|
||
Glyphs \e[HE] and \e[DI] have been replaced with \e[u2662] and \e[u2661],
|
||
respectively, since the former two glyphs have a black (filled) shape
|
||
which grodvi doesn't provide by default (it never has actually).
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
grolj4
|
||
|
||
.ULS
|
||
.LI
|
||
The glyphs \e[*e] and \e[+e] have been exchanged to be in sync with
|
||
all other devices.
|
||
|
||
.LI
|
||
The glyph \e[~=] is now called \e[|=]. Similar to other devices, \e[~=]
|
||
is now another name for glyph \e[~~].
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
grotty
|
||
|
||
.ULS
|
||
.LI
|
||
New option `\-r'.
|
||
It is similar to the \-i option except it tells grotty to
|
||
use the `reverse video' attribute to render italic fonts.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
pic
|
||
|
||
.ULS
|
||
.LI
|
||
New command `figname' to set the name of a picture's output box in TeX
|
||
mode.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
refer
|
||
|
||
.ULS
|
||
.LI
|
||
The environment variable `REFER' to override the name of the default
|
||
database isn't new but hasn't been documented before.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
soelim
|
||
|
||
.ULS
|
||
.LI
|
||
New option `\-r' to avoid emission of `.lf' lines.
|
||
|
||
.LI
|
||
New option `\-t' to emit TeX comment lines (giving current file and the
|
||
line number) instead of `.lf' lines.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
afmtodit
|
||
|
||
.ULS
|
||
.LI
|
||
Unencoded glyphs in an AFM file are output also (since grops can now emit
|
||
multiple encoding vectors for a single font).
|
||
|
||
.LI
|
||
New option `\-m' to prevent negative left italic correction values.
|
||
|
||
.LI
|
||
The mapping and encoding file together with file `DESC' are now searched
|
||
in the default font directory also.
|
||
Please refer to the man page of afmtodit for more details.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
macro packages
|
||
|
||
.ULS
|
||
.LI
|
||
.MTO kollar@\:alltel.net "Larry Kollar"
|
||
and others made the man macros more customizable.
|
||
|
||
.ULS
|
||
.LI
|
||
New command line options \-rFT, \-rIN, and \-rSN to set the vertical
|
||
location of the footer line, the body text indentation, and the
|
||
sub-subheading indentation.
|
||
|
||
.LI
|
||
New command line option \-rHY (similar to the ms macros) to control
|
||
hyphenation.
|
||
|
||
.LI
|
||
New macros `.PT' and `.BT' to print the header and footer strings.
|
||
They can be replaced with a customized version in `man.local'.
|
||
|
||
.LI
|
||
The string `HF' now holds the typeface to print headings and
|
||
subheadings.
|
||
|
||
.LI
|
||
Similar to the ms macros, the LT register now defaults to LL if not
|
||
explicitly specified on the command line.
|
||
.ULE
|
||
|
||
.LI
|
||
troff's start-up file `troffrc' now includes `papersize.tmac' to set
|
||
the paper size with the command line option `-dpaper=<size>'.
|
||
|
||
Possible values for `<size>' are the same as the predefined `papersize'
|
||
values in the DESC file (only lowercase; see the groff_font man page)
|
||
except \%a7-d7.
|
||
An appended `l' (ell) character denotes landscape orientation.
|
||
Examples: `a4', `c3l', `letterl'.
|
||
|
||
Most output drivers need additional command line switches `\-p' and
|
||
`\-l' to override the default paper length and orientation as set in
|
||
the driver specific DESC file.
|
||
|
||
For example, use the following for PS output on A4 paper in landscape
|
||
orientation:
|
||
|
||
.in 2m
|
||
.ft C
|
||
groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms > foo.ps
|
||
.ft R
|
||
.in
|
||
.ULE
|
||
.
|
||
.
|
||
.SH
|
||
NEWS VERSION 1.18.1
|
||
.
|
||
.SH 2
|
||
troff
|
||
|
||
.ULS
|
||
.LI
|
||
The non-slanted PostScript font definition files have been regenerated to
|
||
include left and right italic correction values.
|
||
Applying those to a glyph (this is, prepending the glyph with `\e,' and
|
||
appending `\e/' to the glyph) sets the glyph width to the real value given
|
||
by the horizontal bounding box values.
|
||
Without those escapes, the advance width for the particular glyph is used
|
||
(which can differ considerably).
|
||
|
||
Most users will neither need this feature nor notice a difference in
|
||
existing documents (provided \e, and \e/ is used as advertised, namely for
|
||
italic fonts only); its main goal is to improve image generation with
|
||
grohtml.
|
||
|
||
This is an experimental change, and feedback is welcome.
|
||
.ULE
|
||
.
|
||
.SH 2
|
||
tbl
|
||
|
||
.ULS
|
||
.LI
|
||
Added global option `nospaces' to ignore leading and trailing spaces in data
|
||
items.
|
||
.ULE
|
||
.
|
||
.SH 2
|
||
grolbp
|
||
|
||
.ULS
|
||
.LI
|
||
The option \-w (\-\-linewidth) has been added (similar to other device
|
||
drivers) to set the default line width.
|
||
.ULE
|
||
.
|
||
.SH 2
|
||
grn
|
||
|
||
.ULS
|
||
.LI
|
||
Support for b-spline and Bezier curves has been added.
|
||
.ULE
|
||
.
|
||
.SH 2
|
||
groffer
|
||
|
||
.ULS
|
||
.LI
|
||
New option \-\-shell to select the shell under wich groffer shall run.
|
||
.ULE
|
||
.
|
||
.SH 2
|
||
Macro Packages
|
||
|
||
.ULS
|
||
.LI
|
||
The string `Am' (producing an ampersand) has been added to mdoc for
|
||
compatibility with NetBSD.
|
||
|
||
.LI
|
||
`.IX' is now deprecated for mom; you should use `.IQ' (Indent Quit)
|
||
instead.
|
||
|
||
.LI
|
||
In mom, new inlines `FWD', `BCK', `UP', and `DOWN' deal with horizontal
|
||
and vertical movements; please refer to contrib/mom/NEWS for more
|
||
details.
|
||
|
||
.LI
|
||
New macro ENDNOTES_HDRFTR_CENTER for mom to better control headers.
|
||
.ULE
|
||
.
|
||
.SH 2
|
||
Miscellaneous
|
||
|
||
.ULS
|
||
.LI
|
||
The `papersize' keyword in the DESC file now accepts multiple arguments.
|
||
It is scanned from left to the right, and the first valid argument is used.
|
||
This makes it possible to provide a fallback paper size.
|
||
|
||
Example:
|
||
|
||
.in 2m
|
||
.ft C
|
||
papersize /etc/papersize a4
|
||
.ft P
|
||
.in
|
||
|
||
.LI
|
||
A local font directory has been prepended to the default font path; it
|
||
defaults to /usr/local/share/groff/site-font. Similar to the normal
|
||
font searching process, files must be placed into a dev\f[I]XXX\f[]
|
||
subdirectory, e.g.
|
||
|
||
.in 2m
|
||
.ft C
|
||
/usr/local/share/groff/site-font/devps/FOO
|
||
.ft P
|
||
.in
|
||
|
||
for a PostScript font definition file FOO.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH
|
||
NEWS VERSION 1.18
|
||
|
||
This section describes recent user-visible changes in groff.
|
||
Bug fixes are not described.
|
||
There are more details in the man pages.
|
||
|
||
.ad c
|
||
\s[+5]\m[red]\
|
||
Please read the changes below regarding
|
||
.ie '\*[.T]'html' \
|
||
. URL #grotty grotty ,
|
||
.el \
|
||
. nop grotty,
|
||
groff's tty frontend.\
|
||
\m[]\s[0]
|
||
.br
|
||
.ad n
|
||
.
|
||
.SH 2
|
||
Troff
|
||
|
||
.ULS
|
||
.LI
|
||
Color support has been added to troff and pic (and to the device drivers
|
||
grops, grodvi, grotty, and grohtml -- other preprocessors and drivers will
|
||
follow).
|
||
A new function `defcolor' defines colors; the escape sequence `\em' sets the
|
||
drawing color, the escape sequence `\eM' specifies the background color for
|
||
closed objects created with \eD'.\|.\|.' commands.
|
||
`\em[]' and `\eM[]' switch back to the previous color.
|
||
`\em' and `\eM' correspond to the new troff output command sets starting
|
||
with `m' and `DF'.
|
||
The device-specific default color is called `default' and can't be
|
||
redefined.
|
||
|
||
Use the `color' request to toggle the usage of colors (default is on); the
|
||
read-only register `.color' is\~0 if colors are not active, and non-zero
|
||
otherwise.
|
||
|
||
The old `Df' output command is mapped onto `DFg'; all color output
|
||
commands don't change the current font position (consequently, `Df'
|
||
doesn't either).
|
||
|
||
Outputting color can be disabled in troff and groff with the option\~\-c
|
||
(it is always disabled in compatibility mode).
|
||
See the section on grotty for the
|
||
.ie '\*[.T]'html' \
|
||
. URL #GROFF_NO_SGR GROFF_NO_SGR
|
||
.el \
|
||
. nop GROFF_NO_SGR
|
||
environment variable also.
|
||
|
||
For defining color components as fractions between 0 and\~1, a new scaling
|
||
indicator `f' has been defined: 1f\~=\~65536u.
|
||
For testing whether a color is defined (with .if and .ie), a new
|
||
conditional operator `m' is available.
|
||
|
||
More details can be found in the groff_diff.7 manual page and in
|
||
groff.texinfo.
|
||
|
||
.LI
|
||
Similar to \em and \eM, \ef[] switches back to the previous font.
|
||
\efP (and \ef[P]) is still valid for backwards compatibility.
|
||
|
||
.LI
|
||
The new escape \eF is the same as `.fam'; \eF[] switches back to previous
|
||
family -- \eF[P] selects family `P'.
|
||
|
||
.LI
|
||
Two new glyph symbols are available: `eu' is the official Euro symbol;
|
||
`Eu' is a font-specific glyph variant.
|
||
|
||
.LI
|
||
The new glyph symbols `t+\-', `tdi', and `tmu' are textual variants of
|
||
`+\-', `di', and `mu', respectively.
|
||
|
||
.LI
|
||
Latin-1 character 181 (PS name `mu', Unicode name U+00B5 MICRO SIGN) has
|
||
got the troff glyph name `mc'.
|
||
|
||
.LI
|
||
\-Tutf8 is now available on EBCDIC hosts.
|
||
|
||
.LI
|
||
Strings can take arguments, using this syntax: \e*[foo\~arg1\~arg2\~.\|.\|.].
|
||
Example:
|
||
|
||
.in 2m
|
||
.nf
|
||
.ft C
|
||
\&.ds xxx This is a \e\e$1 test.
|
||
\e*[xxx nice]
|
||
.ft P
|
||
.fi
|
||
.in
|
||
|
||
.LI
|
||
It is now possible to have whitespace between the first and second dot (or
|
||
the name of the ending macro) to end a macro definition.
|
||
Example:
|
||
|
||
.in 2m
|
||
.nf
|
||
.ft C
|
||
\&.de !
|
||
\&..
|
||
\&.
|
||
\&.de foo
|
||
\&. nop Hello, I'm `foo'.
|
||
\&. nop I will now define `bar'.
|
||
\&. de bar !
|
||
\&. nop Hello, I'm `bar'.
|
||
\&. !
|
||
\&..
|
||
.ft P
|
||
.fi
|
||
.in
|
||
|
||
.LI
|
||
`.fn' is a new string-valued register which returns the (internal) real
|
||
font name; styles and families are properly concatenated.
|
||
|
||
.LI
|
||
Three new read/write registers `seconds', `minutes', and `hours' contain
|
||
the current time, set at start-up of troff.
|
||
Use the `af' request to control their output format.
|
||
|
||
.LI
|
||
The new request `fchar' can be used to provide fallback characters.
|
||
It has the same syntax as the `char' request; the only difference is that
|
||
a character defined with `.char' hides the glyph with the same name in the
|
||
current font, whereas a character defined with `.fchar' is checked only if
|
||
the particular glyph isn't found in the current font.
|
||
This test happens before checking special fonts.
|
||
|
||
.LI
|
||
In analogy to the `tmc' request, `.writec' is the same as `.write' but
|
||
doesn't emit a final newline.
|
||
|
||
.LI
|
||
The new request `itc' is a variant of `.it' for which a line interrupted
|
||
with \ec counts as one input line.
|
||
|
||
.LI
|
||
Two new requests `ds1' and `as1' which are similar to `ds' and `as' but
|
||
with compatibility mode disabled during expansion of strings defined by
|
||
them.
|
||
|
||
.LI
|
||
The syntax of the `substring' request has been changed:
|
||
The first character in a string now has index\~0, the last character
|
||
has index\~\-1.
|
||
Note that this is an incompatible change.
|
||
|
||
.LI
|
||
To emit strings directly to the intermediate output, a new `output'
|
||
request has been added; it is similar to `\e!' used at the top level.
|
||
|
||
.LI
|
||
`.hpf' has been extended.
|
||
It can now handle most TeX hyphenation pattern files without
|
||
modification.
|
||
To do that, the commands \epatterns, \ehyphenation, and \eendinput are
|
||
recognized.
|
||
Please refer to groff_diff.7 for more information.
|
||
|
||
.LI
|
||
`hpfcode' is a new request to provide an input encoding mapping for the
|
||
`hpf' request.
|
||
|
||
.LI
|
||
The new request `hpfa' appends hyphenation patterns (`hpf' replaces
|
||
already existing patterns).
|
||
|
||
.LI
|
||
A new request `ami' (append macro indirect) has been added.
|
||
The first and second parameter of `ami' are taken from string registers
|
||
rather than directly; this very special request is needed to make
|
||
`trace.tmac' independent from the escape character (which might even
|
||
be disabled).
|
||
|
||
.LI
|
||
The new request `sizes' is similar to the `sizes' command in DESC files.
|
||
It expects the same syntax; the data must be on a single line, and the
|
||
final `0' can be omitted.
|
||
|
||
.LI
|
||
`trin' (translate input) is a new request which is similar to `tr' with
|
||
the exception that the `asciify' request will use the character code (if
|
||
any) before the character translation.
|
||
Example:
|
||
|
||
.in 2m
|
||
.nf
|
||
.ft C
|
||
\&.trin ax
|
||
\&.di xxx
|
||
a
|
||
\&.br
|
||
\&.di
|
||
\&.xxx
|
||
\&.trin aa
|
||
\&.asciify xxx
|
||
\&.xxx
|
||
.ft P
|
||
.fi
|
||
.in
|
||
|
||
The result is `x\~a'. Using `tr', the result would be `x\~x'.
|
||
|
||
.LI
|
||
The request `pvs' isn't new, but hasn't been documented before.
|
||
It adds vertical space after a line has been output.
|
||
This makes it an alternative to the `ls' request to produce
|
||
double-spaced documents.
|
||
The read-only register `.pvs' holds the current amount of the
|
||
post-vertical line space.
|
||
|
||
.LI
|
||
For compatibility with plan 9's troff, multiple `pi' requests are
|
||
supported:
|
||
|
||
.in 2m
|
||
.nf
|
||
.ft C
|
||
\&.pi foo
|
||
\&.pi bar
|
||
.ft P
|
||
.fi
|
||
.in
|
||
|
||
is now equivalent to
|
||
|
||
.in 2m
|
||
.ft C
|
||
\&.pi foo | bar
|
||
.ft P
|
||
.in
|
||
|
||
.LI
|
||
A new escape sequence `\eO' is available to disable and enable glyph
|
||
output.
|
||
Please see groff_diff.man and groff.texinfo for more details.
|
||
|
||
.LI
|
||
The escapes `\e%', `\e&', `\e)', and `\e:' no longer cause an error in \eX;
|
||
they are ignored now.
|
||
Additionally `\e\ ' and `\e~' are converted to single space characters.
|
||
|
||
.LI
|
||
The default tab distance in nroff mode is now 0.8i to be compatible
|
||
with UNIX troff.
|
||
|
||
.LI
|
||
Using the latin-1 input character 0xAD (soft hyphen) for the `shc'
|
||
request was a bad idea.
|
||
Instead, it is now translated to `\e%', and the default hyphenation
|
||
character is again \e[hy].
|
||
Note that the glyph \e[shc] is not useful for typographic purposes;
|
||
it only exists to have glyph names for all latin-1 characters.
|
||
.ULE
|
||
.
|
||
.SH 2
|
||
Macro Packages
|
||
|
||
.ULS
|
||
.LI
|
||
.MTO df191@\:ncf.ca "Peter Schaffter"
|
||
has contributed a new major macro package called `mom', mainly for
|
||
non-scientific writers, which takes care of many typographic issues.
|
||
It comes with a complete reference (in HTML format) and some examples.
|
||
`mom' has been designed to format documents for PostScript output only.
|
||
|
||
.LI
|
||
Two macros `AT' (AT&T) and `UC' (Univ. of California) have been added to
|
||
the man macros for compatibility with older BSD releases.
|
||
|
||
.LI
|
||
Both the man and mdoc macro packages now use the LL and LT registers for
|
||
setting the line and title length, respectively (similar to those
|
||
registers in the ms macro package).
|
||
If not set on the command line or in a macro file loaded before the macro
|
||
package itself, they default to 78n in nroff mode and 6.5i in troff mode.
|
||
|
||
.LI
|
||
The `\-xwidth' specifier in the mdoc macro package has been removed.
|
||
Its functionality is now integrated directly into `\-width'.
|
||
Similarly, `\-column' has been extended to has this functionality also.
|
||
|
||
.LI
|
||
A new macro `Ex' has been added to the mdoc macro package to document an
|
||
exit status.
|
||
|
||
.LI
|
||
`troff.man' has been split. Differences to UNIX troff are now documented
|
||
in the new man page `groff_diff.man'.
|
||
|
||
.LI
|
||
The PSPIC macro has been extended to work with DVI output (`pspic.tmac' is
|
||
now automatically loaded for \-Tdvi), using a dvips special to load the EPS
|
||
file.
|
||
|
||
.LI
|
||
The trace.tmac package now traces calls to `am' also.
|
||
Additionally, it works in compatibility mode.
|
||
|
||
.LI
|
||
`troff.1' has been split.
|
||
Differences to UNIX troff are now documented in the new man page
|
||
`groff_diff.7'.
|
||
|
||
.LI
|
||
`groff_mwww.7' has been renamed to `groff_www.7'.
|
||
The file mwww.tmac has been removed.
|
||
|
||
.LI
|
||
`groff_ms.7' has been completely rewritten.
|
||
It now contains a complete reference to the ms macros.
|
||
|
||
.LI
|
||
`groff_trace.7' documents the trace macro package.
|
||
|
||
.LI
|
||
Changes in www.tmac
|
||
|
||
Note that HTML support is still in alpha change, so it is rather likely
|
||
that both macro names and macro syntax will change.
|
||
Some of the macros mentioned below aren't really new but haven't been
|
||
documented properly before.
|
||
|
||
.ULS
|
||
.LI
|
||
The following macros have been renamed:
|
||
|
||
.in 2m
|
||
.nf
|
||
MAILTO -> MTO
|
||
IMAGE -> IMG
|
||
LINE -> HR
|
||
.fi
|
||
.in
|
||
|
||
.LI
|
||
For consistency, the macros `URL', `FTL', and `MTO' now all have the
|
||
address as the first parameter followed by the description.
|
||
|
||
.LI
|
||
By default, grohtml generates links to all section headings at the top
|
||
of the document.
|
||
Use the new `LK' macro to specify a different place.
|
||
|
||
.LI
|
||
For specifying the background color and a background image, use the
|
||
new macros `BCL' and `BGIMG', respectively.
|
||
|
||
.LI
|
||
The macro `NHR' has been added; it suppresses the generation of top and
|
||
bottom rules which grohtml emits by default.
|
||
|
||
.LI
|
||
The new macro `HX' determines the cut-off point for automatic link
|
||
generation to headings.
|
||
|
||
.LI
|
||
The image position parameter names in `IMG' have been changed to `\-L',
|
||
`\-R', and `\-C'.
|
||
|
||
.LI
|
||
New macro `PIMG' for inclusion of a PNG image (it will automatically
|
||
convert it into an EPS file if not \-Thtml is used).
|
||
|
||
.LI
|
||
New macro `MPIMG' for putting a PNG image into the left or right margin
|
||
(it will automatically convert it into an EPS file if not \-Thtml is used).
|
||
|
||
.LI
|
||
New macros `HnS', `HnE' to start and end a header line block.
|
||
|
||
.LI
|
||
New macro `DC' to produce dropcap characters.
|
||
|
||
.LI
|
||
New macro `HTL' to generate an HTML title line only but no H1 heading.
|
||
|
||
.LI
|
||
New macros `ULS' and `ULE' to start and end an unordered list.
|
||
The new macro `LI' inserts a list item.
|
||
.ULE
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
groff
|
||
|
||
.ULS
|
||
.LI
|
||
The new command line `\-c' disables color output (which is always disabled
|
||
in compatibility mode).
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
Nroff
|
||
|
||
.ULS
|
||
.LI
|
||
Two new command line options `\-c' and `\-C'; the former passes `\-c' to
|
||
grotty (switching to the old output scheme); the latter passes `\-C' to
|
||
groff (enabling compatibility mode).
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
pic
|
||
|
||
.ULS
|
||
.LI
|
||
New keywords `color' (or `colour', `colored', `coloured'), `outline' (or
|
||
`outlined'), and `shaded' are available.
|
||
`outline' sets the color of the outline, `shaded' the fill color, and
|
||
`color' sets both.
|
||
Example:
|
||
|
||
.in 2m
|
||
.ft C
|
||
circle shaded "green" outline "black" ;
|
||
.ft P
|
||
.in
|
||
|
||
Filled arrows always use the outline color for filling.
|
||
|
||
Color support for TeX output is not implemented yet.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
Pic2graph
|
||
|
||
.ULS
|
||
.LI
|
||
A new script contributed by
|
||
.MTO esr@\:thyrsus.com "Eric S.\~Raymond" .
|
||
It converts a PIC diagram into a cropped image.
|
||
Since it uses gs and the PNM library, virtually all graphics formats
|
||
are available for output.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
Eqn2graph
|
||
|
||
.ULS
|
||
.LI
|
||
A new script contributed by
|
||
.MTO esr@\:thyrsus.com "Eric S.\~Raymond" .
|
||
It converts an EQN diagram into a cropped image.
|
||
Since it uses gs and the PNM library, virtually all graphics formats
|
||
are available for output.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
Groffer
|
||
|
||
.ULS
|
||
.LI
|
||
A new script contributed by
|
||
.MTO bwarken@mayn.de "Bernd Warken" .
|
||
It displays groff files and man pages on X and tty, taking care of most
|
||
parameters automatically.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
Grog
|
||
|
||
.ULS
|
||
.LI
|
||
Documents using the mom macro package are recognized.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
grops
|
||
|
||
.ULS
|
||
.LI
|
||
Color support has been added.
|
||
|
||
.LI
|
||
A new option `\-p' is available to select the output paper size.
|
||
It has the same syntax as the new `papersize' keyword in the DESC file.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
Grodvi
|
||
|
||
.ULS
|
||
.LI
|
||
By default, font sizes are now available in the range 5\-10000pt, similar
|
||
to PS fonts.
|
||
If you want the old behaviour (i.e., font sizes at discrete values only),
|
||
insert the following at the start of your document:
|
||
|
||
.in 2m
|
||
.nf
|
||
.ft C
|
||
\&.if '\e*[.T]'dvi' \e
|
||
\&. sizes 500 600 700 800 900 1000 1095 1200 1400 1440 1600 \e
|
||
\& 1728 1800 2000 2074 2200 2400 2488 2800 3600
|
||
.ft P
|
||
.fi
|
||
.in
|
||
|
||
.LI
|
||
A new font file HBI (using cmssbxo10; this is slanted sans serif bold
|
||
extended) has been added.
|
||
|
||
.LI
|
||
Two font families are now available: `T' and `H'.
|
||
|
||
.LI
|
||
EC and TC fonts have been integrated.
|
||
Use `\-mec' (calling the file ec.tmac) to switch to them.
|
||
Those fonts give a much better coverage of the symbols defined by groff
|
||
than the CM fonts.
|
||
|
||
Note that ec.tmac must be called before any language-specific files; it
|
||
doesn't take care of hcode values.
|
||
|
||
.LI
|
||
Color support has been added.
|
||
For drawing commands, colors are translated to gray values currently.
|
||
.ULE
|
||
.
|
||
.
|
||
.TAG grotty
|
||
.SH 2
|
||
Grotty
|
||
|
||
.ULS
|
||
.LI
|
||
Color support has been added, using the SGR (ISO\~6429, sometimes called
|
||
ANSI color) escape sequences.
|
||
|
||
.LI
|
||
SGR escape sequences are now used by default for underlining and bold
|
||
printing also, no longer using the backspace character trick.
|
||
To revert to the old behaviour, use the `\-c' switch.
|
||
|
||
Note that you have to use the `\-R' option of `less' to make SGR escapes
|
||
display correctly.
|
||
On the other hand, terminal programs and consoles like `xterm' which
|
||
support SGR sequences natively can directly display the output of grotty.
|
||
Consequently, the options `\-b', `\-B', `\-u', and `\-U' work only in
|
||
combination with `\-c' and are ignored silently otherwise.
|
||
|
||
For the `man' program, it may be necessary to add the `\-R' option of
|
||
`less' to the $PAGER environment variable; alternatively, you can use
|
||
`man's `\-P' option (or adapt its configuration file accordingly).
|
||
See man(1) for more details.
|
||
|
||
.TAG GROFF_NO_SGR
|
||
.LI
|
||
If the environment variable GROFF_NO_SGR is set, SGR output is disabled,
|
||
reverting to the old behaviour.
|
||
|
||
.LI
|
||
A new special \eX'tty:\~sgr\~n' has been added; if n is non-zero or missing,
|
||
enable SGR output (the default).
|
||
|
||
.LI
|
||
If the new option `\-i' is used (only in SGR mode), grotty sends escape
|
||
sequences to set the italic font attribute instead of the underline
|
||
attribute for italic fonts.
|
||
Note that many terminals don't have support for this (including xterm).
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
grohtml
|
||
|
||
.ULS
|
||
.LI
|
||
Color support for glyphs has been added.
|
||
|
||
.LI
|
||
New option `\-h' to select the style of headings in HTML output.
|
||
|
||
.LI
|
||
New option `\-b' to set the background colour to white.
|
||
|
||
.LI
|
||
New options `\-a' and `\-g' to control the number of bits for anti-aliasing
|
||
used for text and graphics, respectively.
|
||
Default value is\~4; 0\~means no anti-aliasing.
|
||
|
||
.LI
|
||
groff character/glyph entities now map onto HTML\~4 character entities.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
Grolbp
|
||
|
||
.ULS
|
||
.LI
|
||
Valid paper sizes are now specified as with the new `papersize' keyword
|
||
in the DESC file.
|
||
Specifically, the old custom paper type format `custAAAxBBB' is no longer
|
||
supported.
|
||
.ULE
|
||
.
|
||
.
|
||
.SH 2
|
||
Miscellaneous
|
||
|
||
.ULS
|
||
.LI
|
||
A new manual page `ditroff.7' is available.
|
||
|
||
.LI
|
||
The groff texinfo manual will now be installed, together with a bunch
|
||
of examples.
|
||
|
||
.LI
|
||
A new keyword `papersize' has been added to the DESC file format.
|
||
Its argument is either
|
||
|
||
.ULS
|
||
.LI
|
||
a predefined paper format (e.g. `A4' or `letter')
|
||
|
||
.LI
|
||
a file name pointing to a file which must contain a paper size
|
||
specification in its first line (e.g. `/etc/papersize')
|
||
|
||
.LI
|
||
a custom paper size definition like `35c,4i'
|
||
.ULE
|
||
|
||
See groff_font(5) for more details.
|
||
This keyword only affects the physical dimensions of the output medium;
|
||
grops, grolj4, and grolbp use it currently.
|
||
troff completely ignores it.
|
||
.ULE
|
||
.
|
||
.HR
|
||
.
|
||
\s[-2]\f[I]This document was produced using
|
||
.URL http://groff.ffii.org/ groff-\n[.x].\n[.y].\n[.Y] .
|
||
.br
|
||
The image at the top has been contributed by Imogen Mulley (born 1991),
|
||
based on a similar picture found on the
|
||
.URL http://www.gnu.org "GNU server" .
|
||
.HR
|
||
.\" EOF
|