diff options
-rw-r--r-- | ChangeLog | 8 | ||||
-rw-r--r-- | PROBLEMS | 62 | ||||
-rw-r--r-- | doc/webpage.ms | 36 |
3 files changed, 64 insertions, 42 deletions
@@ -1,3 +1,11 @@ +2003-04-10 Werner LEMBERG <wl@gnu.org> + + * PROBLEMS: Revised. + +2003-04-10 Bernd Warken <bwarken@mayn.de> + + * doc/webpage.ms: Improved. + 2003-04-09 Werner LEMBERG <wl@gnu.org> Add register \n[.height] which returns the value of \H. @@ -38,10 +38,10 @@ or, if you want to be portable to older troff versions, as follows: * groff can't handle my troff document. It works fine with AT&T troff. -Read the section on incompatibilities in gtroff(1). Try using the -C -option. Alternatively there's the sed script `tmac/fixmacros.sed' -which will attempt to edit a file of macros so that it can be used -with groff without the -C flag. +Read the section on incompatibilities in groff_diff(7). Try using +the -C option. Alternatively there's the sed script +`tmac/fixmacros.sed' which will attempt to edit a file of macros so +that it can be used with groff without the -C flag. ---------------------------------------------------------------------- @@ -69,7 +69,7 @@ slow computers.) * Groff doesn't use the font names I'm used to. -Use the `ftr' request. See (g)troff(1). +Use the `ftr' request. See groff_diff(7). ---------------------------------------------------------------------- @@ -119,18 +119,8 @@ comments, you can do it like this: There seem to be many different styles of page header and footer produced by different versions of the -man macros. You will need to -modify tmac/an-old.tmac to suit your personal taste. For example, if -you want the center of the page header to say - - System Programmer's Manual - -you will need to change the line - - .el .ds an-extra3 \"System Programmer's Manual - -to - - .el .ds an-extra3 System Programmer's Manual +put modified macros from tmac/an-old.tmac into man.local. More +information is available in groff_man(7). ---------------------------------------------------------------------- @@ -335,18 +325,26 @@ are available in the devps directory. * I've configured groff for A4 paper, but gtroff still seems to think that the length of a page (as returned by `\n(.p') is 11 inches. -This is intentional. The PAGE option is used only by grops. For -compatibility with ditroff, the default page length in gtroff is -always 11 inches. The page length can be changed with the `pl' -request. +This is intentional. The PAGE option during configuration is used +only by grops. For compatibility with ditroff, the default page +length in gtroff is always 11 inches. The page length can be changed +with the `pl' request. + +A convenient way to set paper dimensions is to use the -dpaper option +of groff, together with proper -P options for the postprocessor +(overriding the default). For example, use the following for PS +output on A4 paper in landscape orientation: + + groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms > foo.ps + +See groff_tmac(5) for more information. ---------------------------------------------------------------------- -* When I print the output groff -Tps, the output is always shifted up - by about 0.7 inches; I'm using 8.5x11 inch paper. +* When I print the output of groff -Tps, the output is always shifted + up by about 0.7 inches; I'm using 8.5x11 inch paper. -Make sure that PAGE is defined to be `letter' in the top-level -Makefile. +Make sure that the paper size is `letter'. See groff_tmac(5). ---------------------------------------------------------------------- @@ -421,12 +419,14 @@ You have at least 3 options: * Groff seems to generate level 3 Postscript, but my printer is only a level 1 or 2 PostScript printer. -In fact groff generates only level 1 PostScript. The `%!PS-Adobe-3.0' -comment at the beginning of PostScript output generated by groff -indicates that the file conforms to version 3.0 of the Adobe Document -Structuring Conventions. The output generated by groff should be -printable on any PostScript printer. Problems with groff output's not -printing are most often caused by the spooling system. +In fact groff generates only level 2 PostScript (or rather level 1 +with some extensions; see grops(1) for more information how to disable +them). The `%!PS-Adobe-3.0' comment at the beginning of PostScript +output generated by groff indicates that the file conforms to +version 3.0 of the Adobe Document Structuring Conventions. The output +generated by groff should be printable on any PostScript printer. +Problems with groff output's not printing are most often caused by the +spooling system. diff --git a/doc/webpage.ms b/doc/webpage.ms index ad1aacd7..37348597 100644 --- a/doc/webpage.ms +++ b/doc/webpage.ms @@ -42,9 +42,9 @@ Home of Groff (GNU Troff). .HnS 1 .HR GNU Troff -.URL http://\:groff.ffii.org/ (Groff) +.URL http://\:groff.ffii.org/ (Groff) \[em] a -.URL http://\:www.gnu.org/ GNU +.URL http://\:www.gnu.org/ GNU project. Hosted by .URL http://\:ffii.org/ FFII . @@ -62,15 +62,26 @@ Groff now supports HTML. .SH Download -.URL "ftp://\:groff.ffii.org/\:pub/\:groff/" Germany -| -.URL "ftp://\:ftp.gnu.org/\:gnu/\:groff/" USA +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" . -.URL http://\:www.gnu.org/\:copyleft/\:gpl.html License -| -.URL http://\:ffii.org/\:mailman/\:listinfo/\:groff/ "Mailing list" -| -.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" @@ -194,7 +205,10 @@ 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). +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" . |