Virgin import of FSF groff v1.19

1 files changed, 43 insertions, 33 deletions

diff --git a/contrib/groff/PROBLEMS b/contrib/groff/PROBLEMS
index e3e6a7b..f679c3a 100644
--- a/contrib/groff/PROBLEMS
+++ b/contrib/groff/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.
 
 
 
@@ -613,8 +613,12 @@ Compilation Problems
     y.tab.c: In function `int yyparse()':
     y.tab.c: `size_t' undeclared in namespace `std'
 
-This is a bug in bison 1.32.  Don't use this version.  1.28 or 1.33 works
-fine.  Alternatively, use yacc or byacc.
+* bison reports conflicts (either on stderr or in the `pic.output'
+  file) while processing `pic.y', and the produced pic binary doesn't
+  work at all.
+
+You need bison version 1.875b or greater.  Alternatively, use yacc or
+byacc.
 
 ----------------------------------------------------------------------
 
@@ -783,3 +787,9 @@ patch is available.  Use GCC 2.95.2 or later instead.
 Make sure -DCFRONT_ANSI_BUG is included in DEFINES in the top-level
 Makefile.  If that doesn't solve the problem, define INT_MIN as
 -INT_MAX in libgroff/lib.h.
+
+----------------------------------------------------------------------
+
+* When compiling on MacOS X, groff compiles but does not run well.
+
+Use  ./configure CXX=g++2  then make as usual.