/usr/share/doc/groff-base/examples/webpage-9.html is in groff 1.21-7.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 | <!-- Creator : groff version 1.21 -->
<!-- CreationDate: Sun Apr 1 21:52:29 2012 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title>webpage-9.html</title>
<link rel="stylesheet" type="text/css" href="groff.css" >
</head>
[ <a href="webpage.html">top</a> ]
<h2>NEWS VERSION 1.20
<a name="heading9"></a>
</h2>
<hr><table><tr><td valign="top" width="30%" bgcolor="#eeeeee">
<a href="webpage-1.html#heading1">License</a><br>
<a href="webpage-2.html#heading2">README</a><br>
<a href="webpage-3.html#heading3">CVS and FTP access</a><br>
<a href="webpage-4.html#heading4">Groff dependencies</a><br>
<a href="webpage-5.html#heading5">Bug reports</a><br>
<a href="webpage-6.html#heading6">Mailing lists</a><br>
<a href="webpage-7.html#heading7">NEWS VERSION 1.21</a><br>
<a href="webpage-8.html#heading8">NEWS VERSION 1.20.1</a><br>
<a href="webpage-9.html#heading9">NEWS VERSION 1.20</a><br>
<a href="webpage-10.html#heading10">NEWS VERSION 1.19.2</a><br>
<a href="webpage-11.html#heading11">NEWS VERSION 1.19.1</a><br>
<a href="webpage-12.html#heading12">NEWS VERSION 1.19</a><br>
<a href="webpage-13.html#heading13">NEWS VERSION 1.18.1</a><br>
<a href="webpage-14.html#heading14">NEWS VERSION 1.18</a><br>
</td><td valign="top" width="70%">
<p>groff</p><ul>
<p><li>XHTML support has been added to grohtml and can be
specified by −Txhtml. This option also utilizes the
MathML capability of eqn and combines the outputs of both in
the final XHTML file. Users can also specify the
‘−P−V’ option together with
‘−Txhtml’ in groff. This has the effect of
creating an XHTML validator button at the bottom of each
page.</p>
<p style="margin-top: 1em"></li><li>Some options have been
added to control a new preprocessor, ‘preconv’
(see below): ‘−k’ activates it,
‘−K’ sets the input encoding, and
‘−D’ sets the default encoding.</p>
<p style="margin-top: 1em"></li><li>A new environment
variable ‘GROFF_ENCODING’ sets the encoding of
input files; it implies command option
‘−k’. </li></p></ul>
<p>troff</p><ul>
<p><li>Two new requests ‘device’ and
‘devicem’ have been added which are equivalents
to the \X and \Y escapes, respectively.</p>
<p style="margin-top: 1em"></li><li>A new read-only number
register ‘.br’ is available which is set
to 1 if a macro is called as .foo and to 0 if
called as ’foo. This allows to reliably modify
requests.</p>
<pre style="margin-left:3%; margin-top: 1em">.als bp@orig bp
.de bp
. tm before bp
. ie \\n[.br] .bp@orig
. el ’bp@orig
. tm after bp
..</pre>
<p style="margin-top: 1em"></li><li>A new request
‘fzoom’ has been added to adjust the optical
size of a font in relation to the others. The zoom factor is
given in integer multiples of 1/1000th. In the following
example, the CR font is magnified by 10% (the zoom factor is
1.1).</p>
<pre style="margin-left:3%; margin-top: 1em">.fam P
.fzoom CR 1100
.ps 12
Palatino and \f[CR]Courier\f[]</pre>
<p style="margin-top: 1em">The new number register
‘.zoom’ holds the zoom value of the current
font, in multiples of 1/1000th.</p>
<p style="margin-top: 1em"></li><li>The
‘cflags’ request has been extended with a new
flag value 64, to be used in combination with values 2
(break before character) and 4 (break after character).
If set, the hyphenation codes of the surrounding characters
are ignored.</p>
<p style="margin-top: 1em"></li><li>A new debugging
request, ‘pev’, has been added to print all of
the current known environments to stderr. It first prints
the state of the current environment, then iterates through
all of the known environments, printing each except the one
that is current.</p>
<p style="margin-top: 1em"></li><li>A new escape
‘\$^’ has been added. It represents the
parameters of a macro as if they were an argument to the
‘ds’ request. This is used by
‘trace.tmac’.</p>
<p style="margin-top: 1em"></li><li>A new read-only number
register ‘.O’ is available which returns the
current suppression level as set by the ‘\O’
escape.</p>
<p style="margin-top: 1em"></li><li>The space width emitted
by the ‘\|’ and ‘\^’ escape
sequences can be controlled on a per-font basis. If there is
a glyph named ‘\|’ or ‘\^’,
respectively (note the leading backslash), defined in the
current font file, use this glyph’s width instead of
the default value.</p>
<p style="margin-top: 1em">This behaviour is not new, but
hasn’t been documented before. </li></p></ul>
<p>nroff</p><ul>
<p><li>Two new command line options ‘−w’
and ‘−W’ are accepted and passed to groff
to enable and disable warning messages, respectively.
</li></p> </ul>
<p>preconv</p><ul>
<p><li>This is a new preprocessor to convert various input
encodings to something groff understands (this is, ASCII and
\[uXXXX] entities, with ‘XXXX’ a hexadecimal
number with 4 to 6 digits, representing a Unicode input
code). Normally, preconv should be invoked with options
‘−k’ and ‘−K’ of groff.
See the preconv man page for details. </li></p></ul>
<p>pic</p><ul>
<p><li>int(x) now really behaves as documented: It
truncates the non-integer part of x, this is, it rounds
towards zero and not towards the next integer less than or
equal to x.</p>
<p style="margin-top: 1em"></li><li>Pic now supports up to
32 macro arguments (and up to 16 on EBCDIC platforms).</p>
<p style="margin-top: 1em"></li><li>Heinz-Jürgen
Örtel contributed code for two new keywords,
‘xslanted’ and ‘yslanted’, which can
change the shape of boxes into arbitrary parallelograms.
</li></p> </ul>
<p>tbl</p><ul>
<p><li>Latest versions of DWB tbl introduced an
‘x’ column specifier for a single column
expanded to the line width. GNU tbl has now been extended to
support even multiple ‘x’ specifiers within a
table.</p>
<p style="margin-top: 1em"></li><li>To avoid collision with
the new ‘x’ specifier, a block formatting macro
must now be selected with specifier letter ‘m’.
</li></p> </ul>
<p>eqn</p><ul>
<p><li>Eric S. Raymond has added a new device type to eqn,
MathML. When −TMathML is enabled, eqn now emits MathML
formula markup rather than groff commands. The new groff
−Txhtml device uses this. </li></p></ul>
<p>chem</p><ul>
<p><li>The preprocessor ‘chem’ was added.
‘chem’ is a roff language to generate chemical
structure diagrams. It generates ‘pic’ output.
</li></p> </ul>
<p>grops</p><ul>
<p><li>The PS font definition files have been regenerated
with newer AFM versions from Adobe’s 35 core fonts as
present in most Level 2 PS printers. The changes are
minor (most notably, the addition of the ‘Euro’
glyph and an extended set of kerning values).</p>
<p style="margin-top: 1em">For backwards compatibility, the
old set of font definition files is still available; for
details please read the man page of grops. </li></p></ul>
<p>grotty</p><ul>
<p><li>\D’p...’ is now supported if the polygon
consists entirely of horizontal and vertical lines.
</li></p> </ul>
<p>grohtml</p><ul>
<p><li>XHTML support has been added.</p>
<p style="margin-top: 1em"></li><li>New command line option
‘−V’ (to be used in XHTML mode) to produce
an XHTML validator button.</p>
<p style="margin-top: 1em"></li><li>New command line option
‘−y’ to produce a right-justified groff
signature at the end of the document (in combination with
option ‘−V’). </li></p></ul>
<p>gxditview</p><ul>
<p><li>Support for keyboard navigation has been
improved.</p>
<p style="margin-top: 1em"></li><li>Similar to other X11
applications, there are now two resource files,
‘GXditview’ and ‘GXditview-color’.
</li></p> </ul>
<p>groffer</p><ul>
<p><li>‘groffer’ version 1.* exists now in a
shell and a Perl version. </li></p></ul>
<p>afmtodit</p><ul>
<p><li>New option ‘−c’ to output more
font information as comments.</p>
<p style="margin-top: 1em"></li><li>New option
‘−k’ to suppress output of kerning
data.</p>
<p style="margin-top: 1em"></li><li>New option
‘−f NAME’ to set the internal name of the
groff font. </li></p></ul>
<p>macro packages</p><ul>
<p><li>Joachim Walsdorff contributed the
‘hdtbl’ package for the generation of tables,
using a syntax very similar to the HTML table model. For
example, a table with two cells and two rows looks like
this:</p>
<pre style="margin-left:3%; margin-top: 1em">.TBL cols=2
. TR .TD 1*1 .TD 1*2
. TR .TD 2*1 .TD 2*2
.ETB</pre>
<p style="margin-top: 1em">Here the same table using a more
expanded syntax:</p>
<pre style="margin-left:3%; margin-top: 1em">.TBL cols=2
. TR
. TD 1*1
. TD 1*2
. TR
. TD 2*1
. TD 2*2
.ETB</pre>
<p style="margin-top: 1em">Tables can be nested;
‘hdtbl’ works without a preprocessor so that the
full capability of groff’s macro engine is
available.</p>
<p style="margin-top: 1em">This package currently works
with ‘-Tps’ only.</p>
<p style="margin-top: 1em"></li><li>−mandoc now
supports multiple man pages (in either man or mdoc
format).</p>
<p style="margin-top: 1em"></li><li>Fabrice Ménard
contributed locales support. In particular, it is now
possible to get French localization of the main macro
packages (−ms, −mm, −me, and −mom,
but not −man and −mdoc which are localized
differently) by appending ‘-mfr’ to the list of
macro packages. Example:</p>
<pre style="margin-left:3%; margin-top: 1em">groff −ms −mfr foo > foo.ps</pre>
<p style="margin-top: 1em">Note that latin-9 input encoding
is used for French (to support the ‘oe’
ligature).</p>
<p style="margin-top: 1em"></li><li>Swedish macro
localization (with ‘−msv’) has been
added.</p>
<p style="margin-top: 1em"></li><li>German macro
localization (with ‘−mde’ and
‘−mden’ for traditional and new
orthography, respectively) has been added.</p>
<p style="margin-top: 1em"></li><li>Czech macro
localization (with ‘−mcs’) has been
added.</p>
<p style="margin-top: 1em">Note that latin-2 input encoding
is used for Czech.</p>
<p style="margin-top: 1em"></li><li>A new macro
‘Dx’ has been added to the mdoc package which
identifies the DragonFly OS.</p>
<p style="margin-top: 1em"></li><li>If mdoc is used to
print multiple man pages (together with the −rcR=0
command line option), each man page now starts a new
page.</p>
<p style="margin-top: 1em"></li><li>−mtrace has been
considerably improved, now showing number and string
register assignments, among other things. See the
groff_trace man page for details.</p>
<p style="margin-top: 1em"></li><li>The PSPIC macro now
works with all devices (producing a hollow rectangle on
devices which don’t support inclusion of PS images)
and is loaded in troffrc at start-up.</p>
<p style="margin-top: 1em"></li><li>A new auxiliary macro
package ‘62bit’ has been added which provides
some macros for adding, multiplying, and dividing signed
62bit integers (mainly to handle normal groff number
operations without risking overflow errors).</p>
<p style="margin-top: 1em"></li><li>For −ms, Eric S.
Raymond contributed support for ancient Bell Labs localisms
‘.SC’, ‘.UC’, ‘.P1’, and
‘.P2’. The latter three are enabled only after
.SC is called.</p>
<p style="margin-top: 1em"></li><li>A new string,
‘SN-STYLE’, has been added to the ms macros,
controlling the formatting of section numbers in headings
defined by ‘.NH’.</p>
<p style="margin-top: 1em"></li><li>The new macro package
‘ptx’ provides a template definition for the
‘.xx’ macro as needed by GNU ptx (for creating
permuted indices). </li></p></ul></td></tr></table><hr>
[ <a href="webpage.html">top</a> ]
|