summaryrefslogtreecommitdiff
path: root/PROBLEMS
diff options
context:
space:
mode:
Diffstat (limited to 'PROBLEMS')
-rw-r--r--PROBLEMS62
1 files changed, 31 insertions, 31 deletions
diff --git a/PROBLEMS b/PROBLEMS
index ad3ca61a..ee400593 100644
--- a/PROBLEMS
+++ b/PROBLEMS
@@ -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.