120 |
The file PROBLEMS describes various problems that have been encountered in |
The file PROBLEMS describes various problems that have been encountered in |
121 |
compiling, installing, and running groff. |
compiling, installing, and running groff. |
122 |
|
|
123 |
The most recent released version of groff is always available by anonymous |
The most recent released version of groff is always available by |
124 |
ftp from ftp.gnu.org in the directory pub/\:gnu/\:groff. |
.URL "ftp://\:ftp.gnu.org/\:gnu/\:groff" "anonymous ftp" . |
125 |
|
|
126 |
A |
The current development version of groff is available from a |
127 |
.URL "http://\:savannah.gnu.org/\:cvs/\:?group=groff" "CVS repository" |
.URL "http://\:savannah.gnu.org/\:cvs/\:?group=groff" "CVS repository" . |
128 |
is available, containing the current development version of groff. |
You can access it by first selecting a parent directory in |
129 |
You can access it with the commands |
which to create a working copy (call it, say, ~/cvswork), and then |
130 |
|
executing the commands |
131 |
|
|
132 |
.in 2m |
.in 2m |
133 |
.nf |
.nf |
134 |
.ft C |
.ft C |
135 |
export CVSROOT=:ext:anoncvs@savannah.gnu.org:/cvsroot/groff |
cd ~/cvswork |
136 |
export CVS_RSH=ssh |
CVS_RSH=ssh; export CVS_RSH |
137 |
cvs -z9 co groff |
cvs -d:ext:anoncvs@savannah.gnu.org/cvsroot/groff -z5 co groff |
138 |
.ft P |
.ft P |
139 |
.fi |
.fi |
140 |
.in |
.in |
141 |
|
|
142 |
Note that you need an SSH client for security reasons. |
(Note that you need an SSH client for security reasons.) |
143 |
|
|
144 |
An update of a checked out repository should be done with |
This will create a subdirectory, ~/cvswork/groff, with a `checked out' |
145 |
|
copy of the CVS repository. |
146 |
|
An update of this working copy may be |
147 |
|
achieved, at any later time by invoking the commands |
148 |
|
|
149 |
.in 2m |
.in 2m |
150 |
|
.nf |
151 |
.ft C |
.ft C |
152 |
CVS_RSH=ssh cvs -z9 update -dP |
cd ~/cvswork/groff |
153 |
|
CVS_RSH=ssh cvs -z5 update -dP |
154 |
.ft P |
.ft P |
155 |
|
.fi |
156 |
.in |
.in |
157 |
|
|
158 |
Please read the info pages of cvs for further details. |
Please read the CVS info pages for further details. |
159 |
|
|
160 |
|
Finally, it is possible to access the CVS with a |
161 |
|
.URL http://\:savannah.gnu.org/\:cvs/\:?group=groff "web browser" . |
162 |
|
|
163 |
Alternatively, you can download snapshots (which are updated twice a day) |
Alternatively, you can download snapshots (which are updated twice a day). |
164 |
from |
The complete groff source as a single file is available |
165 |
.URL http://\:groff.ffii.org/\:groff/\:devel/\:groff-current.tar.gz here |
.URL http://\:groff.ffii.org/\:groff/\:devel/\:groff-current.tar.gz here . |
166 |
or a diff file relative to the latest official groff release as |
|
167 |
|
A diff file relative to groff-\[la]version\[ra], the latest official groff |
168 |
|
release is available at |
169 |
|
|
170 |
.in 2m |
.in 2m |
171 |
.ft C |
.ft C |
187 |
.fi |
.fi |
188 |
.in |
.in |
189 |
|
|
190 |
Finally, it is possible to access the CVS with a browser by pointing it |
Depending on your requirements, you may need at least some of the |
191 |
to |
following tools to build groff directly from its source: |
192 |
|
|
193 |
.in 2m |
.in 2m |
194 |
.URL http://savannah.gnu.org/cvs/?group=groff \ |
.nf |
195 |
http://savannah.gnu.org/cvs/?group=groff |
ghostscript |
196 |
|
the psutils package |
197 |
|
the netpbm package |
198 |
|
texinfo 4.8 |
199 |
|
bison \[>=] 1.875b or byacc |
200 |
|
.fi |
201 |
.in |
.in |
202 |
|
|
203 |
|
Note that texinfo and bison or byacc are required only for building from |
204 |
|
CVS sources (either a checked out working copy, or a daily snapshot). |
205 |
|
They are not required for building from a stable release tarball. |
206 |
|
Also note that the version numbers stated are the minimum supported. |
207 |
|
No version of texinfo < 4.8 will work, and the original release of bison |
208 |
|
1.875 is known not to work; you \fImay\fP find that bison releases < 1.875 |
209 |
|
will work, but in case of difficulty, please update to a later version |
210 |
|
\fIbefore\fP posting a bug report. |
211 |
|
|
212 |
|
For \fIall\fP sources, you need ghostscript for creation of either PDF or |
213 |
|
HTML output; the netpbm and psutils packages are required only for HTML |
214 |
|
output. |
215 |
|
If you don't intend to produce output in either of these formats, then |
216 |
|
these packages are unnecessary. |
217 |
|
|
218 |
Please report bugs using the form in the file BUG-REPORT; the idea of this |
Please report bugs using the form in the file BUG-REPORT; the idea of this |
219 |
is to make sure that FSF has all the information it needs to fix the bug. |
is to make sure that FSF has all the information it needs to fix the bug. |
220 |
At the very least, read the BUG-REPORT form and make sure that you supply |
At the very least, read the BUG-REPORT form and make sure that you supply |
239 |
a read-only list showing commitments to the CVS repository |
a read-only list showing commitments to the CVS repository |
240 |
.ULE |
.ULE |
241 |
|
|
242 |
You must be subscribed to the `groff' list to send mails. |
You can post mails directly to the `bug-groff' list, without subscribing; |
243 |
|
to post mails to the `groff' list you must subscribe to it. |
244 |
|
|
245 |
To subscribe, send e-mail to \[la]list\[ra]-request@\[la]domain\[ra] |
To subscribe, send e-mail to \[la]list\[ra]-request@\[la]domain\[ra] |
246 |
(example: |
(example: |
247 |
.MTO groff-request@\:gnu.org groff-request@\:gnu.org ) |
.MTO groff-request@\:gnu.org groff-request@\:gnu.org |
248 |
with the word `subscribe' in either the |
for the `groff' list) with the word `subscribe' in either the |
249 |
subject or body of the e-mail (don't include the quotes) or have a look |
subject or body of the e-mail (don't include the quotes). |
250 |
at the |
Alternatively, you may subscribe by visiting the web pages at |
251 |
.URL http://\:lists.gnu.org/\:mailman/\:listinfo/\:groff/ \ |
|
252 |
"groff mailing list webpage" . |
.in 2m |
253 |
|
.nf |
254 |
|
.URL http://lists.gnu.org/mailman/listinfo/bug-groff |
255 |
|
.URL http://lists.gnu.org/mailman/listinfo/groff |
256 |
|
.URL http://lists.gnu.org/mailman/listinfo/groff-commit |
257 |
|
.fi |
258 |
|
.in |
259 |
|
|
260 |
|
Each of these web pages also provides a link to a browseable archive of |
261 |
|
postings to the corresponding mailing list. |
262 |
|
|
263 |
GNU groff was written by |
GNU groff was written by |
264 |
.MTO jjc@\:jclark.com "James Clark" . |
.MTO jjc@\:jclark.com "James Clark" . |
269 |
. |
. |
270 |
. |
. |
271 |
.SH |
.SH |
272 |
|
NEWS VERSION 1.19.2 |
273 |
|
. |
274 |
|
.SH 2 troff |
275 |
|
|
276 |
|
.ULS |
277 |
|
.LI |
278 |
|
Analogously to the .ft and \ef pair, two new requests `gcolor' and |
279 |
|
`fcolor' (which pair with \em and \eM, respectively) have been added to |
280 |
|
set the glyph and background colours. |
281 |
|
|
282 |
|
.LI |
283 |
|
A new read-only, string-valued register `.sty' returns the name of the |
284 |
|
current style. |
285 |
|
|
286 |
|
.LI |
287 |
|
Two new conditional operators `F\~\[la]name\[ra]' and `S\~\[la]name\[ra]' |
288 |
|
have been added. |
289 |
|
`F' is true if a font \[la]name\[ra] exists. |
290 |
|
`S' is true if a style \[la]name\[ra] has been registered. |
291 |
|
|
292 |
|
.LI |
293 |
|
Cyrillic characters have been added to the `utf8' and `html' output |
294 |
|
devices. |
295 |
|
.ULE |
296 |
|
. |
297 |
|
. |
298 |
|
.SH 2 |
299 |
|
pic |
300 |
|
|
301 |
|
.ULS |
302 |
|
.LI |
303 |
|
The `by' argument in a `for' loop can now be negative if it is additive. |
304 |
|
For the multiplicative case, it must be greater than zero. |
305 |
|
.ULE |
306 |
|
. |
307 |
|
. |
308 |
|
.SH 2 |
309 |
|
eqn |
310 |
|
|
311 |
|
.ULS |
312 |
|
.LI |
313 |
|
The following keywords aren't new but haven't been documented previously: |
314 |
|
|
315 |
|
.in 2m |
316 |
|
\fBundef NAME\fP (to undefine a macro) |
317 |
|
.br |
318 |
|
\fBcopy "FILE"\fP (a synonym for `include') |
319 |
|
.br |
320 |
|
\fBspace n\fP (to modify the vertical spacing before and after an equation) |
321 |
|
.in |
322 |
|
|
323 |
|
.LI |
324 |
|
The following macros aren't new but haven't been documented previously: |
325 |
|
|
326 |
|
.in 2m |
327 |
|
\fBAlpha, .\|.\|., Omega\fP (the same as `ALPHA', .\|.\|., `OMEGA') |
328 |
|
.br |
329 |
|
\fBldots\fP (three dots on the base line) |
330 |
|
.br |
331 |
|
\fBdollar\fP (a dollar glyph) |
332 |
|
.in |
333 |
|
|
334 |
|
.LI |
335 |
|
The following keywords have been extended. Again, this isn't new but |
336 |
|
hasn't been documented previously: |
337 |
|
|
338 |
|
.in 2m |
339 |
|
.ft B |
340 |
|
col n { .\|.\|. } |
341 |
|
.br |
342 |
|
lcol n { .\|.\|. } |
343 |
|
.br |
344 |
|
rcol n { .\|.\|. } |
345 |
|
.br |
346 |
|
ccol n { .\|.\|. } |
347 |
|
.br |
348 |
|
pile n { .\|.\|. } |
349 |
|
.br |
350 |
|
lpile n { .\|.\|. } |
351 |
|
.br |
352 |
|
rpile n { .\|.\|. } |
353 |
|
.br |
354 |
|
cpile n { .\|.\|. } |
355 |
|
.ft P |
356 |
|
(set vertical spacing between rows to\~N) |
357 |
|
.ULE |
358 |
|
. |
359 |
|
. |
360 |
|
.SH 2 |
361 |
|
grohtml |
362 |
|
|
363 |
|
.ULS |
364 |
|
.LI |
365 |
|
This device driver has been raised to beta stage; its set of tags should |
366 |
|
be stable now. |
367 |
|
|
368 |
|
.LI |
369 |
|
New command line option `\-s' to set the base point size. |
370 |
|
|
371 |
|
.LI |
372 |
|
New command line option `\-S' to set the split level while generating |
373 |
|
multiple files. |
374 |
|
.ULE |
375 |
|
. |
376 |
|
. |
377 |
|
.SH 2 |
378 |
|
gxditview |
379 |
|
|
380 |
|
.ULS |
381 |
|
.LI |
382 |
|
On platforms which have the X\~Window System this program is now built and |
383 |
|
installed automatically. |
384 |
|
.ULE |
385 |
|
. |
386 |
|
. |
387 |
|
.SH 2 |
388 |
|
xtotroff |
389 |
|
|
390 |
|
.ULS |
391 |
|
.LI |
392 |
|
This program to create font definition files for xditview isn't new but |
393 |
|
hasn't been installed previously. |
394 |
|
.ULE |
395 |
|
. |
396 |
|
. |
397 |
|
.SH 2 |
398 |
|
groffer |
399 |
|
|
400 |
|
.ULS |
401 |
|
.LI |
402 |
|
A security problem (reported as CAN-2004-0969) has been fixed. |
403 |
|
.ULE |
404 |
|
. |
405 |
|
. |
406 |
|
.SH 2 |
407 |
|
gdiffmk |
408 |
|
|
409 |
|
.ULS |
410 |
|
.LI |
411 |
|
A new script contributed by Mike Bianchi. |
412 |
|
It compares two groff, nroff, or troff documents and creates an output with |
413 |
|
added margin characters (using `.mc') to indicate the differences. |
414 |
|
.ULE |
415 |
|
. |
416 |
|
. |
417 |
|
.SH 2 |
418 |
|
pdfroff |
419 |
|
|
420 |
|
.ULS |
421 |
|
.LI |
422 |
|
A new wrapper script contributed by Keith Marshall to easily create PDF |
423 |
|
documents with groff. |
424 |
|
.ULE |
425 |
|
. |
426 |
|
. |
427 |
|
.SH 2 |
428 |
|
macro packages |
429 |
|
|
430 |
|
.ULS |
431 |
|
.LI |
432 |
|
ms.tmac |
433 |
|
|
434 |
|
.ULS |
435 |
|
.LI |
436 |
|
Support for fractional point sizes: A value for the `PS', `VS', `FPS', |
437 |
|
and `VPS' register larger than or equal to 1000 is always divided by 1000. |
438 |
|
For example, `.nr\~PS\~10250' sets the document's font size to 10.25 points. |
439 |
|
|
440 |
|
.LI |
441 |
|
The `Ds' and `De' macros provided in ms since groff version 1.19 have |
442 |
|
been removed; the equivalent `DS' and `DE' macros should be used instead. |
443 |
|
X11 documents which actually use `Ds' and `De' always load a |
444 |
|
specific macro file from the X11 distribution (`macros.t') which |
445 |
|
provides proper definitions for the two macros. |
446 |
|
|
447 |
|
.LI |
448 |
|
The following registers have been added for improving layout control: |
449 |
|
|
450 |
|
.IP PORPHANS |
451 |
|
Defines number of lines following `LP', `PP', `QP', `IP' or `XP' which |
452 |
|
must be kept together, before any automatic page break. |
453 |
|
|
454 |
|
.IP HORPHANS |
455 |
|
Sets number of lines of following paragraph which must be kept with a |
456 |
|
heading, defined by `NH' or `SH', before any automatic page break. |
457 |
|
|
458 |
|
.IP GROWPS |
459 |
|
Sets the first level of heading (set with `NH') which will keep the |
460 |
|
same point size as body text. |
461 |
|
|
462 |
|
.IP PSINCR |
463 |
|
Sets the point size increment for each level of heading (set with |
464 |
|
`NH'), below the threshold level set by `GROWPS'; e.g., if |
465 |
|
\en[PS]\~=\~10, \en[GROWPS]\~=\~3 and \en[PSINCR]\~=\~2.0p, then `.NH\~1' |
466 |
|
will produce 14pt headings, `.NH\~2' will produce 12pt, and all other levels |
467 |
|
will remain at 10pt (because \en[PS]\~=\~10). |
468 |
|
|
469 |
|
.LI |
470 |
|
The `SH' macro now accepts a numeric argument, to make heading size |
471 |
|
match that of `NH' with same argument value when the `GROWPS'/`PSINCR' |
472 |
|
feature is enabled. |
473 |
|
.ULE |
474 |
|
|
475 |
|
Please refer to the documentation of the ms package for other, minor |
476 |
|
improvements. |
477 |
|
|
478 |
|
.LI |
479 |
|
me.tmac |
480 |
|
|
481 |
|
The section type set with the `++' request is available in the `_M' |
482 |
|
register. |
483 |
|
This isn't new but hasn't been documented before. |
484 |
|
|
485 |
|
.LI |
486 |
|
www.tmac |
487 |
|
|
488 |
|
The `HR' macro no longer causes an empty line for non-HTML devices. |
489 |
|
|
490 |
|
A new macro `HEAD' has been added to directly add data to the |
491 |
|
<head>...</head> block. |
492 |
|
|
493 |
|
New macros `OLS' and `OLE' to start and end an ordered list. |
494 |
|
|
495 |
|
New macros `DLS' and `DLE' to start and end a definition list. |
496 |
|
.ULE |
497 |
|
. |
498 |
|
. |
499 |
|
.SH 2 |
500 |
|
pdfmark |
501 |
|
|
502 |
|
.ULS |
503 |
|
.LI |
504 |
|
A new macro package contributed by Keith Marshall which implements PDF |
505 |
|
marks. |
506 |
|
This is in alpha stage currently. |
507 |
|
.ULE |
508 |
|
. |
509 |
|
. |
510 |
|
.SH 2 |
511 |
|
miscellaneous |
512 |
|
|
513 |
|
.ULS |
514 |
|
.LI |
515 |
|
Two new keywords to the DESC file have been added which are needed for |
516 |
|
grohtml: `image_generator' and `unscaled_charwidths'. |
517 |
|
The former gives the name of the program which creates PNG images, |
518 |
|
and the latter makes troff always use unscaled character widths. |
519 |
|
.ULE |
520 |
|
. |
521 |
|
. |
522 |
|
.SH |
523 |
NEWS VERSION 1.19.1 |
NEWS VERSION 1.19.1 |
524 |
. |
. |
525 |
.SH 2 |
.SH 2 |