1 .\" This file gives a small example how a web page could look like if
2 .\" created with groff.
5 .\" To make it work with other output devices also, we include
10 .if '\*[.T]'html' .nr LL 10i
11 .if r ps4html .nr LL 10i
15 .HEAD "<link rel=""stylesheet"" type=""text/css"" href=""groff.css"" >"
16 .\" .HEAD "<link rel=""icon"" type=""image/png"" href=""http://www.gnu.org/graphics/gnu-mini.png"" >"
29 .defcolor mydarkred rgb 0.65f 0.1f 0.2f
30 .defcolor mydarkgreen rgb 0.1f 0.5f 0.2f
31 .defcolor mydarkblue rgb 0.1f 0.2f 0.6f
33 .ds GNU \m[mydarkred]G\m[]\m[mydarkgreen]N\m[]\m[mydarkblue]U\m[]
38 Home of Groff (GNU Troff).
41 .PSPIC -L gnu.eps 2i 2i
45 . nop \v'-0.66i'\h'2.0i'\s[80]\*[GNU] Troff\s0
49 . nop \v'-0.66i'\h'2.0i'\s[60]\*[GNU] Troff\s0
57 is the home page for groff (\c
58 .URL http://\:www.gnu.org/ GNU
59 Troff), which is a software typesetting package
60 that reads plain text mixed with formatting commands
61 and produces formatted output.
63 Output may be PostScript or PDF, html,
64 or ASCII/UTF8 for display at the terminal.
66 Formatting commands may be either low-level typesetting requests
67 (\[lq]primitives\[rq]) or macros from a supplied set.
69 Users may also write their own macros.
71 All three may be combined.
73 Present on most Unix systems owing to its long association
74 with Unix manuals (manpages),
75 groff is capable of producing typographically sophisticated documents
76 while consuming only minimal system resources.
78 The source code of the currently released versions of groff is
80 .URL "http://\:ftp.gnu.org/\:gnu/\:groff/" "GNU host"
82 the current development version is available from a
83 .URL "https://\:savannah.gnu.org/\:git/\:?group=groff" "git repository" .
85 The current version is 1.22.3 (04-Nov-2014).
87 To view the git repository in your browser, use
88 .URL "http://\:git.savannah.gnu.org/\:cgit/\:groff.git" \
89 "Savannah's cgit interface" .
91 There you can also download snapshots;
92 simply click on a commit entry line to get the URL.
94 Additional contributions can be found
95 .URL "http://\:groff.ffii.org/\:groff/\:contrib/" here .
97 For a special version of groff on the Microsoft operating systems, see
98 .URL "https://\:sf.net/\:projects/\:ezwinports/\:files/" \
102 Groff was originally written and maintained by James Clark; it
104 .MTO Ted.Harding@\:nessie.mcc.ac.uk "Ted Harding"
106 .MTO wl@\:gnu.org "Werner Lemberg" .
110 \s[-4]\f[I]This document was produced using
111 .URL http://\:www.gnu.org/\:software/\:groff groff-\n[.x].\n[.y].\n[.Y] .
113 The image at the top has been contributed by Imogen Mulley,
114 based on a similar picture found on the
115 .URL http://\:www.gnu.org "GNU server" .
121 GNU troff is released under the
122 .URL http://\:www.gnu.org/\:copyleft/\:gpl.html "GNU Copyright License" .
123 The documentation is released under the
124 .URL http://\:www.gnu.org/\:copyleft/\:fdl.html "Free Documentation License" .
130 This is the GNU groff document formatting system.
131 The version number is given in the file VERSION.
133 Included in this release are implementations of `troff', `pic', `eqn',
134 `tbl', `grn', `refer', `\-man', `\-mdoc', `\-mom', and `\-ms' macros, and
135 drivers for `PostScript', `PDF', `TeX DVI' format, `HP LaserJet\~4'
136 printers, `Canon CAPSL' printers, `HTML' and `XHTML' formats (beta status),
137 and typewriter-like devices. Also included is a modified version of the
138 Berkeley `\-me' macros, the enhanced version `gxditview' of the X11
139 `xditview' previewer, and an implementation of the `\-mm' macros contributed
140 by J\[:o]rgen H\[:a]gg.
142 See the file `INSTALL' for installation instructions on how to install from
144 You require a C++ compiler.
146 The file `INSTALL.REPO' contains supplementary instructions for building
147 directly from a clone of the repository or a snapshot tarball.
149 The file `NEWS' describes recent user-visible changes to `groff'.
151 `groff' is free software.
152 See the file `COPYING' for copying permission.
154 The file `PROBLEMS' describes various problems that have been encountered in
155 compiling, installing, and running `groff'.
157 The file `MORE.STUFF' contains information about add-on packages useful for
162 Repository and FTP access
164 The most recent released version of `groff' is always available by
165 .URL "ftp://\:ftp.gnu.org/\:gnu/\:groff" "anonymous ftp" .
167 The current development version of `groff' is available from a
168 .URL http://\:savannah.gnu.org/\:git/\:?group=groff "git repository" .
170 To view the git repository in your browser, go to its
171 .URL http://\:git.savannah.gnu.org/\:cgit/\:groff.git "browser interface" .
172 There you can also download snapshots; simply click on a commit entry
179 Depending on your requirements, you may need at least some of the
180 following tools to build `groff' directly from its source:
184 perl >= v5.6.1 (see macro GROFF_PERL in file `m4/groff.m4')
189 bison \[>=] 1.875b or byacc
193 Note that `texinfo' and `bison' or `byacc' are required only for building
194 from repository sources (either a checked out working copy, or a commit
196 They are not required for building from a stable release tarball.
197 Also note that the version numbers stated are the minimum supported.
198 No version of `texinfo' < 4.8 works, and the original release of `bison'
199 1.875 is known not to work; you \fImay\fP find that `bison' releases < 1.875
200 work, but in case of difficulty, please update to a later version
201 \fIbefore\fP posting a bug report.
202 For \fIall\fP sources, you need `ghostscript' for creation of either `PDF'
203 or `HTML' output; the `netpbm' and `psutils' packages are required only for
205 If you don't intend to produce output in either of these formats, then
206 these packages are unnecessary.
208 Additionally, producing `PDF' output directly with the `gropdf' device needs
209 a working installation of `perl'.
210 The same is true for some other preprocessors like `chem'.
212 In Linux Debian, the installation of `texinfo' is dangerous, for it creates
213 a file `install-info' that blocks the system installation.
214 So the created `/usr/local/bin/install-info' must be renamed.
216 The `groff' configure script searches for the X11 headers and libraries
218 So the corresponding developer packages of your system must be installed,
219 otherwise `groff' does not install `gxditview' and the `-TX*' devices.
220 In Debian, the developer packages are `libxaw7-dev' and `libxmu-dev'.
226 Please report bugs using the project's
227 .URL https://\:savannah.gnu.org/\:projects/\:groff "bug tracker" .
229 Alternatively, but less preferable, you may use the form in the file
230 `BUG-REPORT'; the idea of this is to make sure that FSF has all the
231 information it needs to fix the bug.
232 At the very least, read the `BUG-REPORT' form and make sure that you supply
233 all the information that it asks for.
234 Even if you are not sure that something is a bug, report it using
235 `BUG-REPORT': this enables us to determine whether it really is a bug or
242 Three mailing lists are available:
246 .MTO bug-groff@gnu.org bug-groff@gnu.org
247 for reporting bugs and following bug reports
250 .MTO groff@gnu.org groff@gnu.org
251 for general discussion of groff
254 .MTO groff-commit@gnu.org groff-commit@gnu.org
255 a read-only list showing commits to the git repository
258 To subscribe, send a mail to \[la]list\[ra]-request@\[la]domain\[ra]
260 .MTO groff-request@\:gnu.org groff-request@\:gnu.org
261 for the `groff' list) with the word `subscribe' in either the
262 subject or body of the e-mail (don't include the quotes).
263 Alternatively, you may subscribe by visiting the web pages at
267 .URL http://lists.gnu.org/mailman/listinfo/bug-groff
268 .URL http://lists.gnu.org/mailman/listinfo/groff
269 .URL http://lists.gnu.org/mailman/listinfo/groff-commit
273 Each of these web pages also provides a link to a browseable archive of
274 postings to the corresponding mailing list.
285 X11 resources for gxditview, which were previously installed in
286 /usr/X11/lib/X11/app-defaults no matter which `prefix' was set, are
287 now installed in appresdir=$prefix/lib/X11/app-defaults.
288 If `appresdir' is not a standard X11 resource directory, the environment
289 variable XFILESEARCHPATH should be set to this path.
290 The standard default directories depends on the system `libXt'.
291 Common directories include:
295 /usr/lib/X11/app-defaults
296 /usr/share/X11/app-defaults
297 /etc/X11/app-defaults
301 Note that if the option `\-\-with\-appresdir' is passed to `configure', the
302 `prefix' will not be added to `appresdir'.
311 This new preprocessor (contributed by Bernd Warken) allows embedding of code
313 .URL http://\:www.lilypond.org "GNU LilyPond" ,
315 The data gets automatically processed and embedded as EPS images.
324 Bernd Warken contributed a new preprocessor to handle Perl code that can be
325 evaluated and then processed by groff.
334 Another preprocessor from Bernd Warken to pretty-print Pinyin syllables like
335 `guo2wang2' as `gu\['o]w\['a]ng'.
344 The pdfroff utility script now activates its `\-\-no\-toc\-relocation'
345 option by default, unless a request similar to:
349 \&.if !\en[PHASE] .tm pdfroff-option:set toc_relocation=enabled
353 is invoked during input file processing; (`.if !\en[PHASE] ...' ensures
354 that the effect of the `.tm' request is restricted to the document setup
355 phase of processing, as pdfroff sets it to 1 or\~2 in the output phase,
356 but leaves it unset in the setup phase).
358 The bundled `spdf.tmac' macro package, which implicitly activates
359 `\-mpdfmark' for `ms' macro users, ensures that TOC relocation is
360 appropriately enabled, when the `.TC' macro is invoked.
369 The \-mom macro package now has full support for eqn, pic, and tbl, as well
370 as captioning and labelling of pdf images and preprocessor output.
371 Lists of Figures, Equations, and Tables can now be autogenerated.
372 PDF_IMAGE has a new FRAME option.
375 A French introduction to the \-me macro package has been added (file
379 In -mdoc, command %C is now available, providing a city or place reference.
391 The character `#' can now be used as an eqn delimiter within tables.
410 has been added to reactivate delimiters which have been disabled with
418 (There was no release 1.22.)
425 A new option `\-j' has been added to call the `chem' preprocessor.
434 Improved line numbering support.
443 Support for the `refer' preprocessor has been added to the \-mm macro
447 In \-me, the `TH' macro was changed for compatibility with line number
450 `bl' now works inside of blocks.
452 The behaviour of centered blocks has been improved.
454 Line numbering support has been improved.
457 The \-mom macro package has reached version 2.0, focusing on PDF output
458 with gropdf (using the new `pdfmom' wrapper script).
459 See the file `version-2.html' of the \-mom documentation for a list of the
463 Some generic Unicode fallback characters (mainly Roman numerals) have been
473 Added numbered line support in tables.
482 A new driver for generating PDF output directly, contributed by
483 .MTO deri@chuzzlewit.myzen.co.uk "Deri James" .
485 Note that this driver is written in Perl, thus you need a working Perl
486 installation to run this output device.
495 A new wrapper around groff that facilitates the production of PDF documents
496 from files formatted with the \-mom macros.
508 The new `lsm' request specifies a macro to be invoked when leading
509 spaces in an input line are encountered (which are removed then).
510 Number registers `lsn' and `lss' hold the number of removed leading
511 spaces and the corresponding horizontal space, respectively.
514 There is a new warning category `file', enabled by default.
515 The `mso' request emits warnings in this category when the requested
516 macro file does not exist.
519 The new `class' request assigns a short name to a set of characters
520 which can be referred to in the `cflags' request.
521 This is especially useful to control line-breaking and hyphenation
522 rules in CJK languages.
525 Three new values for the `cflags' request have been added, which are
526 needed for proper CJK support.
529 128 prohibit before but allow break after character
531 256 prohibit after but allow break before character
533 512 allow break before and after character
543 A new global option `nowarn' suppresses warnings if tables are longer
544 than the current line width.
553 New option `\-o' to specify the name of the output file.
562 A new macro `%U' has been added to the mdoc package to indicate a URL
563 reference within an .Rs/.Re environment.
566 Rudimentary support for the Japanese script has been added, most
567 suitable for man page handling as output by grotty.
568 The file `ja.tmac' contains the necessary setup to allow line breaks
569 before and after CJK characters (with proper exceptions).
570 Note, however, that no inter-character spacing is implemented yet \[en]
571 this usually causes many warnings about bad line breaks.
578 A packaging error made it necessary to publish this release.
579 No user-visible changes.
590 XHTML support has been added to grohtml and can be specified by
592 This option also utilizes the MathML capability of
593 eqn and combines the outputs of both in the final XHTML file.
594 Users can also specify the `\-P\-V' option together with `\-Txhtml'
596 This has the effect of creating an XHTML validator
597 button at the bottom of each page.
600 Some options have been added to control a new preprocessor,
601 `preconv' (see below): `\-k' activates it, `\-K' sets the input
602 encoding, and `\-D' sets the default encoding.
605 A new environment variable `GROFF_ENCODING' sets the encoding
606 of input files; it implies command option `\-k'.
615 Two new requests `device' and `devicem' have been added which are
616 equivalents to the \eX and \eY escapes, respectively.
619 A new read-only number register `.br' is available which is set to\~1
620 if a macro is called as .foo and to\~0 if called as 'foo.
621 This allows to reliably modify requests.
629 \&. ie \e\en[.br] .bp@orig
638 A new request `fzoom' has been added to adjust the optical size of a
639 font in relation to the others.
640 The zoom factor is given in integer multiples of 1/1000th.
641 In the following example, the CR font is magnified by 10% (the zoom
650 \&Palatino and \ef[CR]Courier\ef[]
655 The new number register `.zoom' holds the zoom value of the current font,
656 in multiples of 1/1000th.
659 The `cflags' request has been extended with a new flag value 64, to be
660 used in combination with values\~2 (break before character) and\~4 (break
662 If set, the hyphenation codes of the surrounding characters are ignored.
665 A new debugging request, `pev', has been added to print all of the current
666 known environments to stderr.
667 It first prints the state of the current environment, then iterates
668 through all of the known environments, printing each except the one that
672 A new escape `\e$^' has been added.
673 It represents the parameters of a macro as if they were an argument to
675 This is used by `trace.tmac'.
678 A new read-only number register `.O' is available which returns the
679 current suppression level as set by the `\eO' escape.
682 The space width emitted by the `\e|' and `\e^' escape sequences can be
683 controlled on a per-font basis.
684 If there is a glyph named `\e|' or `\e^', respectively (note the leading
685 backslash), defined in the current font file, use this glyph's width
686 instead of the default value.
688 This behaviour is not new, but hasn't been documented before.
697 Two new command line options `\-w' and `\-W' are accepted and passed to
698 groff to enable and disable warning messages, respectively.
707 This is a new preprocessor to convert various input encodings to something
708 groff understands (this is, ASCII and \e[uXXXX] entities, with `XXXX' a
709 hexadecimal number with 4 to 6 digits, representing a Unicode input code).
710 Normally, preconv should be invoked with options `\-k' and `\-K' of groff.
711 See the preconv man page for details.
720 int(x) now really behaves as documented: It truncates the non-integer part
721 of\~x, this is, it rounds towards zero and not towards the next integer
722 less than or equal to\~x.
725 Pic now supports up to 32 macro arguments (and up to 16 on EBCDIC
729 Heinz-Jürgen Örtel contributed code for two new keywords, `xslanted' and
730 `yslanted', which can change the shape of boxes into arbitrary
740 Latest versions of DWB tbl introduced an `x' column specifier for a single
741 column expanded to the line width.
742 GNU tbl has now been extended to support even multiple `x' specifiers
746 To avoid collision with the new `x' specifier, a block formatting macro
747 must now be selected with specifier letter `m'.
756 Eric S. Raymond has added a new device type to eqn, MathML.
757 When \-TMathML is enabled, eqn now emits MathML formula markup rather than
759 The new groff \-Txhtml device uses this.
768 The preprocessor `chem' was added.
769 `chem' is a roff language to generate chemical structure diagrams.
770 It generates `pic' output.
779 The PS font definition files have been regenerated with newer AFM versions
780 from Adobe's 35 core fonts as present in most Level\~2 PS printers.
781 The changes are minor (most notably, the addition of the `Euro' glyph and an
782 extended set of kerning values).
784 For backwards compatibility, the old set of font definition files is still
785 available; for details please read the man page of grops.
794 \eD'p...' is now supported if the polygon consists entirely of horizontal
804 XHTML support has been added.
807 New command line option `\-V' (to be used in XHTML mode) to produce an
808 XHTML validator button.
811 New command line option `\-y' to produce a right-justified groff signature
812 at the end of the document (in combination with option `\-V').
821 Support for keyboard navigation has been improved.
824 Similar to other X11 applications, there are now two resource files,
825 `GXditview' and `GXditview-color'.
834 `groffer' version 1.* exists now in a shell and a Perl version.
843 New option `\-c' to output more font information as comments.
846 New option `\-k' to suppress output of kerning data.
849 New option `\-f NAME' to set the internal name of the groff font.
858 Joachim Walsdorff contributed the `hdtbl' package for the generation of
859 tables, using a syntax very similar to the HTML table model.
860 For example, a table with two cells and two rows looks like this:
866 \&. TR .TD 1*1 .TD 1*2
867 \&. TR .TD 2*1 .TD 2*2
873 Here the same table using a more expanded syntax:
891 Tables can be nested; `hdtbl' works without a preprocessor so that the
892 full capability of groff's macro engine is available.
894 This package currently works with `\-Tps' only.
897 \-mandoc now supports multiple man pages (in either man or mdoc format).
900 Fabrice Ménard contributed locales support.
901 In particular, it is now possible to get French localization of the main
902 macro packages (\-ms, \-mm, \-me, and \-mom, but not \-man and \-mdoc
903 which are localized differently) by appending `-mfr' to the list of macro
910 groff \-ms \-mfr foo > foo.ps
915 Note that latin-9 input encoding is used for French (to support the `oe'
919 Swedish macro localization (with `\-msv') has been added.
922 German macro localization (with `\-mde' and `\-mden' for traditional and
923 new orthography, respectively) has been added.
926 Czech macro localization (with `\-mcs') has been added.
928 Note that latin-2 input encoding is used for Czech.
931 A new macro `Dx' has been added to the mdoc package which identifies the
935 If mdoc is used to print multiple man pages (together with the \-rcR=0
936 command line option), each man page now starts a new page.
939 \-mtrace has been considerably improved, now showing number and string
940 register assignments, among other things.
941 See the groff_trace man page for details.
944 The PSPIC macro now works with all devices (producing a hollow
945 rectangle on devices which don't support inclusion of PS images) and
946 is loaded in troffrc at start-up.
949 A new auxiliary macro package `62bit' has been added which provides some
950 macros for adding, multiplying, and dividing signed 62bit integers (mainly
951 to handle normal groff number operations without risking overflow errors).
954 For \-ms, Eric S. Raymond contributed support for ancient Bell Labs
955 localisms `.SC', `.UC', `.P1', and `.P2'.
956 The latter three are enabled only after .SC is called.
959 A new string, `SN-STYLE', has been added to the ms macros, controlling
960 the formatting of section numbers in headings defined by `.NH'.
963 The new macro package `ptx' provides a template definition for the `.xx'
964 macro as needed by GNU ptx (for creating permuted indices).
976 Analogously to the .ft and \ef pair, two new requests `gcolor' and
977 `fcolor' (which pair with \em and \eM, respectively) have been added to
978 set the glyph and background colours.
981 A new read-only, string-valued register `.sty' returns the name of the
985 Two new conditional operators `F\~\[la]name\[ra]' and `S\~\[la]name\[ra]'
987 `F' is true if a font \[la]name\[ra] exists.
988 `S' is true if a style \[la]name\[ra] has been registered.
991 Cyrillic characters have been added to the `utf8' and `html' output
1001 The `by' argument in a `for' loop can now be negative if it is additive.
1002 For the multiplicative case, it must be greater than zero.
1011 The following keywords aren't new but haven't been documented previously:
1014 \fBundef NAME\fP (to undefine a macro)
1016 \fBcopy "FILE"\fP (a synonym for `include')
1018 \fBspace n\fP (to modify the vertical spacing before and after an equation)
1022 The following macros aren't new but haven't been documented previously:
1025 \fBAlpha, .\|.\|., Omega\fP (the same as `ALPHA', .\|.\|., `OMEGA')
1027 \fBldots\fP (three dots on the base line)
1029 \fBdollar\fP (a dollar glyph)
1033 The following keywords have been extended. Again, this isn't new but
1034 hasn't been documented previously:
1054 (set vertical spacing between rows to\~N)
1063 This device driver has been raised to beta stage; its set of tags should
1067 New command line option `\-s' to set the base point size.
1070 New command line option `\-S' to set the split level while generating
1080 Experimental support for zero-width and double-width characters.
1089 On platforms which have the X\~Window System this program is now built and
1090 installed automatically.
1099 This program to create font definition files for xditview isn't new but
1100 hasn't been installed previously.
1109 A security problem (reported as CAN-2004-0969) has been fixed.
1118 A new script contributed by Mike Bianchi.
1119 It compares two groff, nroff, or troff documents and creates an output with
1120 added margin characters (using `.mc') to indicate the differences.
1129 A new wrapper script contributed by Keith Marshall to easily create PDF
1130 documents with groff.
1143 Support for fractional point sizes: A value for the `PS', `VS', `FPS',
1144 and `VPS' register larger than or equal to 1000 is always divided by 1000.
1145 For example, `.nr\~PS\~10250' sets the document's font size to 10.25 points.
1148 The `Ds' and `De' macros provided in ms since groff version 1.19 have
1149 been removed; the equivalent `DS' and `DE' macros should be used instead.
1150 X11 documents which actually use `Ds' and `De' always load a
1151 specific macro file from the X11 distribution (`macros.t') which
1152 provides proper definitions for the two macros.
1155 The following registers have been added for improving layout control:
1158 Defines number of lines following `LP', `PP', `QP', `IP' or `XP' which
1159 must be kept together, before any automatic page break.
1162 Sets number of lines of following paragraph which must be kept with a
1163 heading, defined by `NH' or `SH', before any automatic page break.
1166 Sets the first level of heading (set with `NH') which keeps the
1167 same point size as body text.
1170 Sets the point size increment for each level of heading (set with
1171 `NH'), below the threshold level set by `GROWPS'; e.g., if
1172 \en[PS]\~=\~10, \en[GROWPS]\~=\~3 and \en[PSINCR]\~=\~2.0p, then `.NH\~1'
1173 produces 14pt headings, `.NH\~2' produces 12pt, and all other levels
1174 remain at 10pt (because \en[PS]\~=\~10).
1177 The `SH' macro now accepts a numeric argument, to make heading size
1178 match that of `NH' with same argument value when the `GROWPS'/`PSINCR'
1182 Please refer to the documentation of the ms package for other, minor
1188 The section type set with the `++' request is available in the `_M'
1190 This isn't new but hasn't been documented before.
1195 The `HR' macro no longer causes an empty line for non-HTML devices.
1197 A new macro `HEAD' has been added to directly add data to the
1198 <head>...</head> block.
1200 New macros `OLS' and `OLE' to start and end an ordered list.
1202 New macros `DLS' and `DLE' to start and end a definition list.
1211 A new macro package contributed by Keith Marshall which implements PDF
1213 This is in alpha stage currently.
1222 Two new keywords to the DESC file have been added which are needed for
1223 grohtml: `image_generator' and `unscaled_charwidths'.
1224 The former gives the name of the program which creates PNG images,
1225 and the latter makes troff always use unscaled character widths.
1237 The argument of the command line option `\-I' is now also passed to troff
1238 and grops, specifying a directory to search for files on the command line,
1239 files named in `so' and `psbb' requests, and files named in \eX'ps:\~file'
1240 and \eX'ps:\~import' escapes.
1243 If option `\-V' is used more than once, the commands are both printed
1244 on standard error and run.
1253 Two new read-only, string-valued registers `.m' and `.M' return the
1254 name of the current drawing and background color, respectively.
1257 New read-only register `.U' which is set to\~1 if in safer mode and set
1258 to\~0 if in unsafe mode.
1261 An input encoding file for \%latin-5 (a.k.a.\& ISO \%8859-9) has been
1267 groff \-Tdvi \-mlatin5 my_file > my_file.dvi
1271 Note that some output devices don't support all glyphs of this encoding.
1274 If the `return' request is called with an argument, it exits twice,
1275 namely the current macro and the macro one level higher.
1276 This is used to define a wrapper macro for `return' in trace.tmac.
1279 For completeness, two new requests have been added: `dei1' and `ami1'.
1280 They are equivalent to `dei' and `ami', respectively, but the macros
1281 are executed with compatibility mode off (similar to `de1' and `am1').
1284 New command line option `\-I' to specify a directory for files (both
1285 those on the command line and those named in `psbb' requests).
1286 This is also handled by the groff wrapper program.
1289 Since version 1.19 you can say `.vs\~0'.
1290 Older versions emit a warning and convert this to `.vs\~\en[.V]'.
1292 This hasn't been documented properly.
1293 Note that `.vs\~0' isn't saved in a diversion since it doesn't result
1303 Dashed and dotted ellipses have been implemented.
1312 New key character `x' to make tbl call a user-defined macro on a table
1315 .MTO hj.oertel@\:surfeu.de "Heinz-J\[:u]rgen Oertel" .
1324 A new script contributed by
1325 .MTO esr@\:thyrsus.com "Eric S. Raymond" .
1326 It converts a grap diagram into a cropped image.
1327 Since it uses gs and the PNM library, virtually all graphics formats
1328 are available for output.
1329 [Note that the grap program itself isn't part of the groff package;
1330 see the file MORE.STUFF how to obtain grap.]
1339 New option `\-j' to emit output split into multiple files.
1348 New command line option `\-I' to specify a directory to search for files
1349 on the command line and files named in \eX'ps:\~import' and \eX'ps:\~file'
1351 This is also handled by the groff wrapper program.
1354 The default value for the `broken' keyword in the DESC file is now\~0.
1363 A new man page `lj4_font(5)' documents how fonts are accessed with
1367 The built-in fonts for LJ4 and newer PCL\~5 devices have been completely
1368 revised, mainly to access as much glyphs as possible.
1369 The provided metric files should be compatible with recent PCL\~5 printers
1371 Additionally, font description files have been added for the Arial and
1372 Times New Roman family, the MS symbol, and Wingdings fonts.
1381 New option `\-x' to prevent use of built-in Adobe Glyph List.
1390 Completely revised to handle HP TrueType metric files also.
1391 See the hpftodit manual page for more details.
1400 This version is a rewrite of groffer in many parts, but it is kept in
1401 the old single script style.
1405 New options: \-\-text (\-\-mode\~text), \-\-tty-viewer, \-\-X (\-\-mode\~X),
1406 \-\-X-viewer, \-\-html (\-\-mode\~html), \-\-html-view, \-\-apropos-data,
1407 \-\-apropos-devel, \-\-apropos-progs.
1410 New documentation file README_SH.
1413 Enhancement of the configuration files and the `apropos' handling.
1423 www.tmac: New macro `JOBNAME' to split output into multiple files.
1426 In mdoc, multiple calls to `.Lb' are now supported in the LIBRARY
1439 Input encoding files for \%latin-9 (a.k.a.\& \%latin-0 and ISO \%8859-15)
1440 and \%latin-2 (ISO \%8859-2) have been added.
1445 groff -Tdvi -mlatin9 my_file > my_file.dvi
1449 You still need proper fonts with the necessary glyphs.
1450 Out of the box, the groff package supports \%latin-9 only for \-Tps,
1451 \-Tdvi, and \-Tutf8, and \%latin-2 only for \-Tdvi and \-Tutf8.
1454 Composite glyphs are now supported.
1455 To do this, a subset of the Adobe Glyph List (AGL) Algorithm as described in
1456 .URL http://\:partners.adobe.com/\:public/\:developer/\:opentype/\:index_glyph.html \
1457 http://\:partners.adobe.com/\:public/\:developer/\:opentype/\:index_glyph.html
1458 is used to construct glyph names based on Unicode character codes.
1459 The existing groff glyph names are frozen; no glyph names which can't be
1460 constructed algorithmically will be added in the future.
1462 The \e[...] escape sequence has been extended to specify multiple glyph
1472 this accesses a glyph with the name `u0041_0328'.
1474 Some groff glyphs which are useful as composites map to `wrong' Unicode
1476 For example, `ho' maps to U+02DB which is a spacing ogonek, whereas a
1477 non-spacing ogonek U+0328 is needed for composite glyphs.
1482 \&.composite from to
1486 changes the mapping while a composite glyph name is constructed.
1487 To make \e[A\~ho] yield the expected result,
1491 \&.composite ho u0328
1496 [The new file `composite.tmac' loaded at start-up already
1497 contains proper calls to `.composite'.]
1499 Please refer to the info pages of groff and to the groff_char man page
1503 A new request `fschar' has been added to define font-specific fallback
1505 They are searched after the list of fonts declared with the
1506 `fspecial' request but before the list of fonts declared with `special'.
1509 Fallback characters defined with `fschar' can be removed with the
1510 new `rfschar' request.
1513 A new request `schar' has been added to define global fallback
1515 They are searched after the list of fonts declared with the
1516 `special' request but before the already mounted special fonts.
1519 In groff versions 1.18 and 1.18.1, \eD'f\~...'\& didn't move the current
1521 Despite of being silly, this change has been reverted for backwards
1523 Consequently, the intermediate output command `Df' also moves the
1524 position horizontally again.
1526 \eD'f\~...'\& is deprecated since it depends on the horizontal resolution
1527 of the output device (given with the `hor' parameter in the DESC file).
1528 Use the new \eD'Fg\~...'\& escape instead.
1531 For orthogonality, new \eD subcommands to change the fill color are
1536 \eD'Fr ...' \f[R](rgb)\f[]
1538 \eD'Fc ...' \f[R](cmy)\f[]
1540 \eD'Fg ...' \f[R](gray)\f[]
1542 \eD'Fk ...' \f[R](cmyk)\f[]
1544 \eD'Fd' \f[R](default color)\f[]
1548 The arguments are the same as with the `defcolor' request.
1549 The current position is \f[I]not\f[] changed.
1552 The values set with \eH and \eS are now available in number registers
1553 \en[.height] and \en[.slant], respectively.
1556 The `.pe' number register isn't new but hasn't been documented before.
1557 It is set to\~1 during a page ejection caused by the `bp' request.
1560 The new glyph symbol `tno' is a textual variant of `no'.
1563 The new glyph symbol `+e' represents U+03F5, GREEK LUNATE EPSILON SYMBOL.
1564 (Well, it is not really new since it has been previously supported by
1566 The mapping for both the dvi and lj4 symbol font has been
1567 changed accordingly so that Greek small letter epsilon, `*e', has the
1568 same glyph shape as with other devices.
1577 The font `freeeuro.pfa' has been added to provide various default glyph
1578 shapes for `eu' and `Eu'.
1581 It is now possible to access all glyphs in a Type\~1 font, not only 256
1582 (provided the font file created by afmtodit has proper entries).
1583 grops constructs additional encoding vectors on the fly if necessary.
1586 The paper size is now emitted via the %%DocumentMedia and PageSize
1587 mechanisms so that it is no longer required to tell `gv' or `ps2pdf'
1588 about the paper size.
1589 The `broken' flag value\~16 omits this feature
1590 (the used PostScript command `setpagedevice' is a LanguageLevel\~2
1593 .MTO egil@\:kvaleberg.no "Egil Kvaleberg" .
1596 Non-slanted PostScript metrics have been changed again; they no longer
1597 contain negative left italic correction values.
1598 This assures correct spacing with eqn.
1607 The font cmtex10 has been added as the special font `SC' to the DVI fonts.
1608 It is used as a font-specific special font for CW and CWI.
1611 New options \-l and \-p to set landscape orientation and the paper size.
1612 grodvi now emits a `papersize' special which is understood by DVI drivers
1615 Consequently, the DESC file should contain a `papersize' keyword.
1618 The glyph shapes for \e[*f] and \e[*e] have been exchanged with \e[+f] and
1619 \e[+e], respectively, to be in sync with all other devices.
1622 Glyphs \e[HE] and \e[DI] have been replaced with \e[u2662] and \e[u2661],
1623 respectively, since the former two glyphs have a black (filled) shape
1624 which grodvi doesn't provide by default (it never has actually).
1633 The glyphs \e[*e] and \e[+e] have been exchanged to be in sync with
1637 The glyph \e[~=] is now called \e[|=]. Similar to other devices, \e[~=]
1638 is now another name for glyph \e[~~].
1648 It is similar to the \-i option except it tells grotty to
1649 use the `reverse video' attribute to render italic fonts.
1658 New command `figname' to set the name of a picture's output box in TeX
1668 The environment variable `REFER' to override the name of the default
1669 database isn't new but hasn't been documented before.
1678 New option `\-r' to avoid emission of `.lf' lines.
1681 New option `\-t' to emit TeX comment lines (giving current file and the
1682 line number) instead of `.lf' lines.
1691 Unencoded glyphs in an AFM file are output also (since grops can now emit
1692 multiple encoding vectors for a single font).
1695 New option `\-m' to prevent negative left italic correction values.
1698 The mapping and encoding file together with file `DESC' are now searched
1699 in the default font directory also.
1700 Please refer to the man page of afmtodit for more details.
1709 .MTO kollar@\:alltel.net "Larry Kollar"
1710 and others made the man macros more customizable.
1714 New command line options \-rFT, \-rIN, and \-rSN to set the vertical
1715 location of the footer line, the body text indentation, and the
1716 sub-subheading indentation.
1719 New command line option \-rHY (similar to the ms macros) to control
1723 New macros `.PT' and `.BT' to print the header and footer strings.
1724 They can be replaced with a customized version in `man.local'.
1727 The string `HF' now holds the typeface to print headings and
1731 Similar to the ms macros, the LT register now defaults to LL if not
1732 explicitly specified on the command line.
1736 troff's start-up file `troffrc' now includes `papersize.tmac' to set
1737 the paper size with the command line option `-dpaper=<size>'.
1739 Possible values for `<size>' are the same as the predefined `papersize'
1740 values in the DESC file (only lowercase; see the groff_font man page)
1742 An appended `l' (ell) character denotes landscape orientation.
1743 Examples: `a4', `c3l', `letterl'.
1745 Most output drivers need additional command line switches `\-p' and
1746 `\-l' to override the default paper length and orientation as set in
1747 the driver specific DESC file.
1749 For example, use the following for PS output on A4 paper in landscape
1754 groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms > foo.ps
1768 The non-slanted PostScript font definition files have been regenerated to
1769 include left and right italic correction values.
1770 Applying those to a glyph (this is, prepending the glyph with `\e,' and
1771 appending `\e/' to the glyph) sets the glyph width to the real value given
1772 by the horizontal bounding box values.
1773 Without those escapes, the advance width for the particular glyph is used
1774 (which can differ considerably).
1776 Most users will neither need this feature nor notice a difference in
1777 existing documents (provided \e, and \e/ is used as advertised, namely for
1778 italic fonts only); its main goal is to improve image generation with
1781 This is an experimental change, and feedback is welcome.
1789 Added global option `nospaces' to ignore leading and trailing spaces in data
1798 The option \-w (\-\-linewidth) has been added (similar to other device
1799 drivers) to set the default line width.
1807 Support for b-spline and Bezier curves has been added.
1815 New option \-\-shell to select the shell under wich groffer shall run.
1823 The string `Am' (producing an ampersand) has been added to mdoc for
1824 compatibility with NetBSD.
1827 `.IX' is now deprecated for mom; you should use `.IQ' (Indent Quit)
1831 In mom, new inlines `FWD', `BCK', `UP', and `DOWN' deal with horizontal
1832 and vertical movements; please refer to contrib/mom/NEWS for more
1836 New macro ENDNOTES_HDRFTR_CENTER for mom to better control headers.
1844 The `papersize' keyword in the DESC file now accepts multiple arguments.
1845 It is scanned from left to the right, and the first valid argument is used.
1846 This makes it possible to provide a fallback paper size.
1852 papersize /etc/papersize a4
1857 A local font directory has been prepended to the default font path; it
1858 defaults to /usr/local/share/groff/site-font. Similar to the normal
1859 font searching process, files must be placed into a dev\f[I]XXX\f[]
1864 /usr/local/share/groff/site-font/devps/FOO
1868 for a PostScript font definition file FOO.
1875 This section describes recent user-visible changes in groff.
1876 Bug fixes are not described.
1877 There are more details in the man pages.
1881 Please read the changes below regarding
1883 . URL #grotty grotty ,
1886 groff's tty frontend.\
1896 Color support has been added to troff and pic (and to the device drivers
1897 grops, grodvi, grotty, and grohtml \[en] other preprocessors and drivers will
1899 A new function `defcolor' defines colors; the escape sequence `\em' sets the
1900 drawing color, the escape sequence `\eM' specifies the background color for
1901 closed objects created with \eD'.\|.\|.' commands.
1902 `\em[]' and `\eM[]' switch back to the previous color.
1903 `\em' and `\eM' correspond to the new troff output command sets starting
1905 The device-specific default color is called `default' and can't be
1908 Use the `color' request to toggle the usage of colors (default is on); the
1909 read-only register `.color' is\~0 if colors are not active, and non-zero
1912 The old `Df' output command is mapped onto `DFg'; all color output
1913 commands don't change the current font position (consequently, `Df'
1916 Outputting color can be disabled in troff and groff with the option\~\-c
1917 (it is always disabled in compatibility mode).
1918 See the section on grotty for the
1920 . URL #GROFF_NO_SGR GROFF_NO_SGR
1923 environment variable also.
1925 For defining color components as fractions between 0 and\~1, a new scaling
1926 indicator `f' has been defined: 1f\~=\~65536u.
1927 For testing whether a color is defined (with .if and .ie), a new
1928 conditional operator `m' is available.
1930 More details can be found in the groff_diff.7 manual page and in
1934 Similar to \em and \eM, \ef[] switches back to the previous font.
1935 \efP (and \ef[P]) is still valid for backwards compatibility.
1938 The new escape \eF is the same as `.fam'; \eF[] switches back to previous
1939 family \[en] \eF[P] selects family `P'.
1942 Two new glyph symbols are available: `eu' is the official Euro symbol;
1943 `Eu' is a font-specific glyph variant.
1946 The new glyph symbols `t+\-', `tdi', and `tmu' are textual variants of
1947 `+\-', `di', and `mu', respectively.
1950 Latin-1 character 181 (PS name `mu', Unicode name U+00B5 MICRO SIGN) has
1951 got the troff glyph name `mc'.
1954 \-Tutf8 is now available on EBCDIC hosts.
1957 Strings can take arguments, using this syntax: \e*[foo\~arg1\~arg2\~.\|.\|.].
1963 \&.ds xxx This is a \e\e$1 test.
1970 It is now possible to have whitespace between the first and second dot (or
1971 the name of the ending macro) to end a macro definition.
1981 \&. nop Hello, I'm `foo'.
1982 \&. nop I will now define `bar'.
1984 \&. nop Hello, I'm `bar'.
1992 `.fn' is a new string-valued register which returns the (internal) real
1993 font name; styles and families are properly concatenated.
1996 Three new read/write registers `seconds', `minutes', and `hours' contain
1997 the current time, set at start-up of troff.
1998 Use the `af' request to control their output format.
2001 The new request `fchar' can be used to provide fallback characters.
2002 It has the same syntax as the `char' request; the only difference is that
2003 a character defined with `.char' hides the glyph with the same name in the
2004 current font, whereas a character defined with `.fchar' is checked only if
2005 the particular glyph isn't found in the current font.
2006 This test happens before checking special fonts.
2009 In analogy to the `tmc' request, `.writec' is the same as `.write' but
2010 doesn't emit a final newline.
2013 The new request `itc' is a variant of `.it' for which a line interrupted
2014 with \ec counts as one input line.
2017 Two new requests `ds1' and `as1' which are similar to `ds' and `as' but
2018 with compatibility mode disabled during expansion of strings defined by
2022 The syntax of the `substring' request has been changed:
2023 The first character in a string now has index\~0, the last character
2025 Note that this is an incompatible change.
2028 To emit strings directly to the intermediate output, a new `output'
2029 request has been added; it is similar to `\e!' used at the top level.
2032 `.hpf' has been extended.
2033 It can now handle most TeX hyphenation pattern files without
2035 To do that, the commands \epatterns, \ehyphenation, and \eendinput are
2037 Please refer to groff_diff.7 for more information.
2040 `hpfcode' is a new request to provide an input encoding mapping for the
2044 The new request `hpfa' appends hyphenation patterns (`hpf' replaces
2045 already existing patterns).
2048 A new request `ami' (append macro indirect) has been added.
2049 The first and second parameter of `ami' are taken from string registers
2050 rather than directly; this very special request is needed to make
2051 `trace.tmac' independent from the escape character (which might even
2055 The new request `sizes' is similar to the `sizes' command in DESC files.
2056 It expects the same syntax; the data must be on a single line, and the
2057 final `0' can be omitted.
2060 `trin' (translate input) is a new request which is similar to `tr' with
2061 the exception that the `asciify' request uses the character code (if
2062 any) before the character translation.
2081 The result is `x\~a'. Using `tr', the result would be `x\~x'.
2084 The request `pvs' isn't new, but hasn't been documented before.
2085 It adds vertical space after a line has been output.
2086 This makes it an alternative to the `ls' request to produce
2087 double-spaced documents.
2088 The read-only register `.pvs' holds the current amount of the
2089 post-vertical line space.
2092 For compatibility with plan 9's troff, multiple `pi' requests are
2104 is now equivalent to
2113 A new escape sequence `\eO' is available to disable and enable glyph
2115 Please see groff_diff.man and groff.texinfo for more details.
2118 The escapes `\e%', `\e&', `\e)', and `\e:' no longer cause an error in \eX;
2119 they are ignored now.
2120 Additionally `\e\ ' and `\e~' are converted to single space characters.
2123 The default tab distance in nroff mode is now 0.8i to be compatible
2127 Using the latin-1 input character 0xAD (soft hyphen) for the `shc'
2128 request was a bad idea.
2129 Instead, it is now translated to `\e%', and the default hyphenation
2130 character is again \e[hy].
2131 Note that the glyph \e[shc] is not useful for typographic purposes;
2132 it only exists to have glyph names for all latin-1 characters.
2140 .MTO df191@\:ncf.ca "Peter Schaffter"
2141 has contributed a new major macro package called `mom', mainly for
2142 non-scientific writers, which takes care of many typographic issues.
2143 It comes with a complete reference (in HTML format) and some examples.
2144 `mom' has been designed to format documents for PostScript output only.
2147 Two macros `AT' (AT&T) and `UC' (Univ. of California) have been added to
2148 the man macros for compatibility with older BSD releases.
2151 Both the man and mdoc macro packages now use the LL and LT registers for
2152 setting the line and title length, respectively (similar to those
2153 registers in the ms macro package).
2154 If not set on the command line or in a macro file loaded before the macro
2155 package itself, they default to 78n in nroff mode and 6.5i in troff mode.
2158 The `\-xwidth' specifier in the mdoc macro package has been removed.
2159 Its functionality is now integrated directly into `\-width'.
2160 Similarly, `\-column' has been extended to has this functionality also.
2163 A new macro `Ex' has been added to the mdoc macro package to document an
2167 `troff.man' has been split. Differences to UNIX troff are now documented
2168 in the new man page `groff_diff.man'.
2171 The PSPIC macro has been extended to work with DVI output (`pspic.tmac' is
2172 now automatically loaded for \-Tdvi), using a dvips special to load the EPS
2176 The trace.tmac package now traces calls to `am' also.
2177 Additionally, it works in compatibility mode.
2180 `troff.1' has been split.
2181 Differences to UNIX troff are now documented in the new man page
2185 `groff_mwww.7' has been renamed to `groff_www.7'.
2186 The file mwww.tmac has been removed.
2189 `groff_ms.7' has been completely rewritten.
2190 It now contains a complete reference to the ms macros.
2193 `groff_trace.7' documents the trace macro package.
2198 Note that HTML support is still in alpha change, so it is rather likely
2199 that both macro names and macro syntax will change.
2200 Some of the macros mentioned below aren't really new but haven't been
2201 documented properly before.
2205 The following macros have been renamed:
2216 For consistency, the macros `URL', `FTL', and `MTO' now all have the
2217 address as the first parameter followed by the description.
2220 By default, grohtml generates links to all section headings at the top
2222 Use the new `LK' macro to specify a different place.
2225 For specifying the background color and a background image, use the
2226 new macros `BCL' and `BGIMG', respectively.
2229 The macro `NHR' has been added; it suppresses the generation of top and
2230 bottom rules which grohtml emits by default.
2233 The new macro `HX' determines the cut-off point for automatic link
2234 generation to headings.
2237 The image position parameter names in `IMG' have been changed to `\-L',
2241 New macro `PIMG' for inclusion of a PNG image (it automatically
2242 converts it into an EPS file if not \-Thtml is used).
2245 New macro `MPIMG' for putting a PNG image into the left or right margin
2246 (it automatically converts it into an EPS file if not \-Thtml is used).
2249 New macros `HnS', `HnE' to start and end a header line block.
2252 New macro `DC' to produce dropcap characters.
2255 New macro `HTL' to generate an HTML title line only but no H1 heading.
2258 New macros `ULS' and `ULE' to start and end an unordered list.
2259 The new macro `LI' inserts a list item.
2269 The new command line `\-c' disables color output (which is always disabled
2270 in compatibility mode).
2279 Two new command line options `\-c' and `\-C'; the former passes `\-c' to
2280 grotty (switching to the old output scheme); the latter passes `\-C' to
2281 groff (enabling compatibility mode).
2290 New keywords `color' (or `colour', `colored', `coloured'), `outline' (or
2291 `outlined'), and `shaded' are available.
2292 `outline' sets the color of the outline, `shaded' the fill color, and
2298 circle shaded "green" outline "black" ;
2302 Filled arrows always use the outline color for filling.
2304 Color support for TeX output is not implemented yet.
2313 A new script contributed by
2314 .MTO esr@\:thyrsus.com "Eric S.\~Raymond" .
2315 It converts a PIC diagram into a cropped image.
2316 Since it uses gs and the PNM library, virtually all graphics formats
2317 are available for output.
2326 A new script contributed by
2327 .MTO esr@\:thyrsus.com "Eric S.\~Raymond" .
2328 It converts an EQN diagram into a cropped image.
2329 Since it uses gs and the PNM library, virtually all graphics formats
2330 are available for output.
2339 A new script contributed by
2340 .MTO groff-bernd.warken-72@web.de "Bernd Warken" .
2341 It displays groff files and man pages on X and tty, taking care of most
2342 parameters automatically.
2351 Documents using the mom macro package are recognized.
2360 Color support has been added.
2363 A new option `\-p' is available to select the output paper size.
2364 It has the same syntax as the new `papersize' keyword in the DESC file.
2373 By default, font sizes are now available in the range 5\-10000pt, similar
2375 If you want the old behaviour (i.e., font sizes at discrete values only),
2376 insert the following at the start of your document:
2381 \&.if '\e*[.T]'dvi' \e
2382 \&. sizes 500 600 700 800 900 1000 1095 1200 1400 1440 1600 \e
2383 \& 1728 1800 2000 2074 2200 2400 2488 2800 3600
2389 A new font file HBI (using cmssbxo10; this is slanted sans serif bold
2390 extended) has been added.
2393 Two font families are now available: `T' and `H'.
2396 EC and TC fonts have been integrated.
2397 Use `\-mec' (calling the file ec.tmac) to switch to them.
2398 Those fonts give a much better coverage of the symbols defined by groff
2401 Note that ec.tmac must be called before any language-specific files; it
2402 doesn't take care of hcode values.
2405 Color support has been added.
2406 For drawing commands, colors are translated to gray values currently.
2416 Color support has been added, using the SGR (ISO\~6429, sometimes called
2417 ANSI color) escape sequences.
2420 SGR escape sequences are now used by default for underlining and bold
2421 printing also, no longer using the backspace character trick.
2422 To revert to the old behaviour, use the `\-c' switch.
2424 Note that you have to use the `\-R' option of `less' to make SGR escapes
2426 On the other hand, terminal programs and consoles like `xterm' which
2427 support SGR sequences natively can directly display the output of grotty.
2428 Consequently, the options `\-b', `\-B', `\-u', and `\-U' work only in
2429 combination with `\-c' and are ignored silently otherwise.
2431 For the `man' program, it may be necessary to add the `\-R' option of
2432 `less' to the $PAGER environment variable (or $MANPAGER, depending on the
2433 used version of `man'); alternatively, you can use `man's `\-P' option (or
2434 adapt its configuration file accordingly).
2435 See man(1) for more details.
2439 If the environment variable GROFF_NO_SGR is set, SGR output is disabled,
2440 reverting to the old behaviour.
2443 A new special \eX'tty:\~sgr\~n' has been added; if n is non-zero or missing,
2444 enable SGR output (the default).
2447 If the new option `\-i' is used (only in SGR mode), grotty sends escape
2448 sequences to set the italic font attribute instead of the underline
2449 attribute for italic fonts.
2450 Note that many terminals don't have support for this (including xterm).
2459 Color support for glyphs has been added.
2462 New option `\-h' to select the style of headings in HTML output.
2465 New option `\-b' to set the background colour to white.
2468 New options `\-a' and `\-g' to control the number of bits for anti-aliasing
2469 used for text and graphics, respectively.
2470 Default value is\~4; 0\~means no anti-aliasing.
2473 groff character/glyph entities now map onto HTML\~4 character entities.
2482 Valid paper sizes are now specified as with the new `papersize' keyword
2484 Specifically, the old custom paper type format `custAAAxBBB' is no longer
2494 A new manual page `ditroff.7' is available.
2497 The groff texinfo manual is now installed, together with a bunch
2501 A new keyword `papersize' has been added to the DESC file format.
2502 Its argument is either
2506 a predefined paper format (e.g. `A4' or `letter')
2509 a file name pointing to a file which must contain a paper size
2510 specification in its first line (e.g. `/etc/papersize')
2513 a custom paper size definition like `35c,4i'
2516 See groff_font(5) for more details.
2517 This keyword only affects the physical dimensions of the output medium;
2518 grops, grolj4, and grolbp use it currently.
2519 troff completely ignores it.