[unix-history] / usr / src / usr.bin / groff / INSTALL.gnu

Groff has been compiled on a Sun 4 under SunOS 4.0.3 with g++ 1.37.1
and with AT&T C++ 2.0, and on a 386 PC under 386/ix 2.0.1 with g++
1.37.1 using Michael Bloom's GNU COFF patches.  You may encounter
problems on other machines that I cannot anticipate.

If you are using g++, you will need to install the header files from
libg++.  The only other parts of libg++ used by groff are contained in
the files xyzzy.c and gnulib3.c; the libg++.a that I use contains only
xyzzy.o and gnulib3.o.  You don't need xyzzy.o unless you're using GNU
ld.

If you are using g++ 1.37.2 alpha, you'll need the following fix (from
Michael Tiemann):

*** cplus-tree.c~	Sat Jun 23 16:10:41 1990
--- cplus-tree.c	Sat Jun 30 23:45:09 1990
***************
*** 685,688 ****
--- 685,689 ----
  }
  
+ /* Constructor for hashed lists.  */
  tree
  hash_tree_chain (value, chain)
***************
*** 701,705 ****
--- 702,721 ----
  }
  
+ /* Similar, but used for concatenating two lists.  */
  tree
+ hash_chainon (list1, list2)
+      tree list1, list2;
+ {
+   if (list2 == 0)
+     return list1;
+   if (list1 == 0)
+     return list2;
+   if (TREE_CHAIN (list1) == NULL_TREE)
+     return hash_tree_chain (TREE_VALUE (list1), list2);
+   return hash_tree_chain (TREE_VALUE (list1),
+ 			  hash_chainon (TREE_CHAIN (list1), list2));
+ }
+ 
+ tree
  build_decl_list_1 (value)
       tree value;
***************
*** 926,930 ****
      {
        if (DECL_NAME (decl))
! 	return IDENTIFIER_POINTER (DECL_NAME (decl));
        return "((anonymous))";
      }
--- 942,950 ----
      {
        if (DECL_NAME (decl))
! 	{
! 	  if (THIS_NAME_P (DECL_NAME (decl)))
! 	    return "this";
! 	  return IDENTIFIER_POINTER (DECL_NAME (decl));
! 	}
        return "((anonymous))";
      }
*** cplus-parse.y~	Mon Jun  4 23:52:34 1990
--- cplus-parse.y	Sat Jun 30 23:45:09 1990
***************
*** 501,505 ****
  		    error ("no base initializers given following ':'");
  		  setup_vtbl_ptr ();
! 		 }
  	;
  
--- 501,505 ----
  		    error ("no base initializers given following ':'");
  		  setup_vtbl_ptr ();
! 		}
  	;
  
***************
*** 1274,1278 ****
  		{ $$ = hash_tree_chain ($1, $2); }
  	| declmods typespec reserved_declspecs
! 		{ $$ = hash_tree_chain ($2, chainon ($3, $1)); }
  	;
  
--- 1274,1278 ----
  		{ $$ = hash_tree_chain ($1, $2); }
  	| declmods typespec reserved_declspecs
! 		{ $$ = hash_tree_chain ($2, hash_chainon ($3, $1)); }
  	;
  
***************
*** 1319,1323 ****
  		{ $$ = decl_tree_cons (NULL_TREE, $1, $2); }
  	| nonempty_type_quals typespec reserved_typespecquals
! 		{ $$ = decl_tree_cons (NULL_TREE, $2, chainon ($3, $1)); }
  	;
  
--- 1319,1323 ----
  		{ $$ = decl_tree_cons (NULL_TREE, $1, $2); }
  	| nonempty_type_quals typespec reserved_typespecquals
! 		{ $$ = decl_tree_cons (NULL_TREE, $2, hash_chainon ($3, $1)); }
  	;
  

If you're using g++ 1.39 on a sparc you'll probably want to apply the
following fix (from Casper H.S. Dik):

*** config/out-sparc.c.org	Wed Dec 12 03:13:57 1990
--- config/out-sparc.c	Sat Feb 23 23:21:26 1991
***************
*** 908,925 ****
  	else if (GET_CODE (XEXP (operands[1], 0)) == PLUS)
  	  {
  	    rtx inc_reg = XEXP (XEXP (operands[1], 0), 0);
  	    if (inc_reg == frame_pointer_rtx
  		&& GET_CODE (XEXP (XEXP (operands[1], 0), 1)) == REG
! 		&& XEXP (XEXP (operands[1], 0), 0) != frame_pointer_rtx)
  	      inc_reg = XEXP (XEXP (operands[1], 0), 1);
  	    if (inc_reg == frame_pointer_rtx)
  	      {
  		output_asm_insn ("mov %%fp,%%g1", xoperands);
  		inc_reg = gen_rtx (REG, SImode, 1);
  	      }
  	    xoperands[1] = inc_reg;
  	    output_asm_insn ("add 4,%1,%1", xoperands);
! 	    xoperands[1] = operands[1];
  	    output_asm_insn ("ld %1,%0", xoperands);
  	    xoperands[1] = inc_reg;
  	    output_asm_insn ("add -4,%1,%1", xoperands);
--- 908,931 ----
  	else if (GET_CODE (XEXP (operands[1], 0)) == PLUS)
  	  {
  	    rtx inc_reg = XEXP (XEXP (operands[1], 0), 0);
+ 	    rtx from = operands[1];
  	    if (inc_reg == frame_pointer_rtx
  		&& GET_CODE (XEXP (XEXP (operands[1], 0), 1)) == REG
! 		&& XEXP (XEXP (operands[1], 0), 1) != frame_pointer_rtx)
  	      inc_reg = XEXP (XEXP (operands[1], 0), 1);
  	    if (inc_reg == frame_pointer_rtx)
  	      {
  		output_asm_insn ("mov %%fp,%%g1", xoperands);
  		inc_reg = gen_rtx (REG, SImode, 1);
+ 		from = gen_rtx (GET_CODE (operands[1]),
+ 				GET_MODE (operands[1]),
+ 				gen_rtx (PLUS, GET_MODE (XEXP (operands[1], 0)),
+ 					       inc_reg,
+ 					       XEXP (XEXP (operands[1], 0), 1)));
  	      }
  	    xoperands[1] = inc_reg;
  	    output_asm_insn ("add 4,%1,%1", xoperands);
! 	    xoperands[1] = from;
  	    output_asm_insn ("ld %1,%0", xoperands);
  	    xoperands[1] = inc_reg;
  	    output_asm_insn ("add -4,%1,%1", xoperands);
***************
*** 989,1006 ****
  	else if (GET_CODE (XEXP (operands[0], 0)) == PLUS)
  	  {
  	    rtx inc_reg = XEXP (XEXP (operands[0], 0), 0);
  	    if (inc_reg == frame_pointer_rtx
  		&& GET_CODE (XEXP (XEXP (operands[0], 0), 1)) == REG
! 		&& XEXP (XEXP (operands[0], 0), 0) != frame_pointer_rtx)
  	      inc_reg = XEXP (XEXP (operands[0], 0), 1);
  	    if (inc_reg == frame_pointer_rtx)
  	      {
  		output_asm_insn ("mov %%fp,%%g1", xoperands);
  		inc_reg = gen_rtx (REG, SImode, 1);
  	      }
  	    xoperands[0] = inc_reg;
  	    output_asm_insn ("add 4,%0,%0", xoperands);
! 	    xoperands[0] = operands[0];
  	    output_asm_insn ("st %r1,%0", xoperands);
  	    xoperands[0] = inc_reg;
  	    output_asm_insn ("add -4,%0,%0", xoperands);
--- 995,1018 ----
  	else if (GET_CODE (XEXP (operands[0], 0)) == PLUS)
  	  {
  	    rtx inc_reg = XEXP (XEXP (operands[0], 0), 0);
+ 	    rtx to = operands[0];
  	    if (inc_reg == frame_pointer_rtx
  		&& GET_CODE (XEXP (XEXP (operands[0], 0), 1)) == REG
! 		&& XEXP (XEXP (operands[0], 0), 1) != frame_pointer_rtx)
  	      inc_reg = XEXP (XEXP (operands[0], 0), 1);
  	    if (inc_reg == frame_pointer_rtx)
  	      {
  		output_asm_insn ("mov %%fp,%%g1", xoperands);
  		inc_reg = gen_rtx (REG, SImode, 1);
+ 		to = gen_rtx (GET_CODE (operands[0]),
+ 				GET_MODE (operands[0]),
+ 				gen_rtx (PLUS, GET_MODE (XEXP (operands[0], 0)),
+ 					       inc_reg,
+ 					       XEXP (XEXP (operands[0], 0), 1)));
  	      }
  	    xoperands[0] = inc_reg;
  	    output_asm_insn ("add 4,%0,%0", xoperands);
! 	    xoperands[0] = to;
  	    output_asm_insn ("st %r1,%0", xoperands);
  	    xoperands[0] = inc_reg;
  	    output_asm_insn ("add -4,%0,%0", xoperands);

On a Sun 3 and other 68k machines, using libg++ 1.37.0 you will need
to apply the following change to g++-include/math.h:

*** math.h-	Sat Jan  6 14:09:52 1990
--- math.h	Tue Mar 13 02:07:01 1990
***************
*** 32,39 ****
  
  
  #ifdef __HAVE_68881__		/* MC68881/2 Floating-Point Coprocessor */
- #include <math-68881.h>
  extern "C" {			/* fill in what we've left out */
  
  double  acosh(double);
  double  asinh(double);
--- 32,39 ----
  
  
  #ifdef __HAVE_68881__		/* MC68881/2 Floating-Point Coprocessor */
  extern "C" {			/* fill in what we've left out */
+ #include <math-68881.h>
  
  double  acosh(double);
  double  asinh(double);

If you have bison 1.11, you will need to apply the following fix to
bison.simple if you want change any of the grammars:

*** bison.simple.~1~	Fri Aug 10 12:13:41 1990
--- bison.simple	Fri Aug 10 12:24:46 1990
***************
*** 20,26 ****
--- 20,28 ----
  
  
  #ifdef __GNUC__
+ #ifndef alloca
  #define alloca __builtin_alloca
+ #endif /* Not alloca. */
  #else /* Not GNU C.  */
  #if (!defined (__STDC__) && defined (sparc)) || defined (__sparc__)
  #include <alloca.h>
***************
*** 114,123 ****
--- 116,129 ----
  /* This is the most reliable way to avoid incompatibilities
     in available built-in functions on various systems.  */
  static void
+ #ifdef __cplusplus
+ __yy_bcopy (char *from, char *to, int count)
+ #else
  __yy_bcopy (from, to, count)
       char *from;
       char *to;
       int count;
+ #endif
  {
    register char *f = from;
    register char *t = to;
***************
*** 127,133 ****
      *t++ = *f++;
  }
  
! #line 131 "/usr/local/lib/bison.simple"
  int
  yyparse()
  {
--- 133,139 ----
      *t++ = *f++;
  }
  
! #line 137 "/usr/local/lib/bison.simple"
  int
  yyparse()
  {

For gas 1.36 on a Sun 4, the following fix is desirable:

*** sparc.c.~1~	Mon May 21 19:06:18 1990
--- sparc.c	Sat Aug 11 11:09:12 1990
***************
*** 56,65 ****
--- 56,67 ----
  static struct hash_control *op_hash = NULL;
  
  static void s_seg(), s_proc(), s_data1(), s_reserve(), s_common();
+ static void s_sparc_align();
  extern void s_globl(), s_long(), s_short(), s_space(), cons();
  
  pseudo_typeS
  md_pseudo_table[] = {
+     { "align",	    s_sparc_align, 0 },
      { "common",     s_common,   0 },
      { "global",     s_globl,    0 },
      { "half",       cons,       2 },

*** read.c.~1~	Tue Mar  6 21:08:29 1990
--- read.c	Sat Aug 11 11:07:23 1990
***************
*** 175,181 ****
--- 175,183 ----
  potable[] =
  {
    { "abort",	s_abort,	0	},
+ #ifndef SPARC
    { "align",	s_align,	0	},
+ #endif
    { "ascii",	stringer,	0	},
    { "asciz",	stringer,	1	},
    { "byte",	cons,		1	},


On a Sequent Symmetry S27 running Dynix 3.0.17, you'll need to use GNU
make or add 'MAKE=make' to Makefiles which use $(MAKE).  You'll also
need to change

  dev=${GROFF_TYPESETTER:-@DEVICE@}

to

  dev=$GROFF_TYPESETTER

in groff.sh.  You should use gcc to compile xditview.

You should only have to edit the top-level Makefile.  The comments
should make it clear what has to be changed.  If you don't have a
separate directory tree for local manual pages you can make
MAN[157]EXT be l (that's an ell) or n, and MANROOT be /usr/man.  The
changes you make to the top-level Makefile will be propagated to
sub-makes, but this won't happen if you invoke make in the
sub-directories.

You might also need to edit groff.sh.  This is a shell-script that
runs gtroff, an appropriate postprocessor and optionally various
preprocessors.  (Actually, the shell-script is created from groff.sh
by substituting for some variables surrounded by @s).  If your kernel
doesn't understand #!, you will need to arrange for the script to be
run by /bin/sh in some other way.

If you want to use existing troff drivers you should change groff.sh
so that it recognises them.  It is also a good idea to copy over the
dev* directory for the device into a directory that's only searched by
groff (eg /usr/local/lib/groff/font), so that you can take advantage
of the groff extensions to the DESC and font formats.  Groff only uses
the ASCII versions of the device files so you only need copy them.  If
you want to use GNU eqn, it is essential that the font files contain
correct height and depth information.  The format for this information
is described in the groff_font(5) page.  The best way to add this
information is to modify the program that generates the font files.
As a last resort you could try using the program addftinfo: it
attempts to guess plausible heights and depths.  To obtain good
results you would probably have to do more work on addftinfo.

To compile everything, just do a `make'.  If that works, then do a
`make install'.

If you have problems compiling pic/pic.tab.c or eqn/eqn.tab.c, you might
want to try using your system's yacc.  Set YACC=yacc in the top-level
Makefile, and also do

  mv pic/pic.tab.c pic/pic.tab.c.dist
  mv eqn/eqn.tab.c eqn/eqn.tab.c.dist

so that the parsers will be regenerated using yacc (the supplied
*.tab.[ch] files were generated by bison.)

If you want to install xditview, you'll need to do that separately:
change directory to xditview, edit the Makefile, do a make and a make
install. You'll need to be running X11R4.

The dvi files produced by grodvi can use fonts at non-standard
magnifications.  You may need to compile fonts with Metafont at these
magnifications. The CompileFonts script in the dvi/devdvi directory
may help you to do this. (It will take a *long* time.)

If you have problems printing existing troff documents, read the
section on `Incompatbilities' in gtroff(1).  If you have existing
macro packages that are in the habit of omitting the space between a
macro or request and its arguments, it is good idea to produce a
version with spaces so that you can use it with groff (without having
to use the -C flag).  The file macros/fixmacros.sed is a sed script
which will attempt to edit a file of macros so that it can be used
with groff without the -C flag.  If you have the DWB 2.0 mm macros
installed on your machine, you might want to do a `make install.mm';
this will copy the mm macros to groff's macro directory and fix a few
problems that occur when using the mm macros with groff; this requires
the `patch' program.  If the patch in macros/mm.diff is rejected,
carefully apply it by hand.

You can share groff with a friend who has the same type of machine as
you, but does not have a C++ compiler.  First do `make bindist'; this
will create a subdirectory `bindist' containing a set of binaries, a
Makefile and a README.  If you want to strip the binaries, now do a
`make strip' in the bindist directory.  Rename the bindist directory
to something more meaningful, tar it up, and give to your friend along
with the original groff source distribution.  Your friend can then
install groff just by editing the Makefile in the bindist directory
and doing a make there; this will automatically install the non-binary
parts of the groff source distribution as well as the binaries from
the bindist directory.
Commit	Line	Data
7e5e7574 C	1	Groff has been compiled on a Sun 4 under SunOS 4.0.3 with g++ 1.37.1
	2	and with AT&T C++ 2.0, and on a 386 PC under 386/ix 2.0.1 with g++
	3	1.37.1 using Michael Bloom's GNU COFF patches. You may encounter
	4	problems on other machines that I cannot anticipate.
	5
	6	If you are using g++, you will need to install the header files from
	7	libg++. The only other parts of libg++ used by groff are contained in
	8	the files xyzzy.c and gnulib3.c; the libg++.a that I use contains only
	9	xyzzy.o and gnulib3.o. You don't need xyzzy.o unless you're using GNU
	10	ld.
	11
	12	If you are using g++ 1.37.2 alpha, you'll need the following fix (from
	13	Michael Tiemann):
	14
	15	*** cplus-tree.c~ Sat Jun 23 16:10:41 1990
	16	--- cplus-tree.c Sat Jun 30 23:45:09 1990
	17	***************
	18	* 685,688 **
	19	--- 685,689 ----
	20	}
	21
	22	+ /* Constructor for hashed lists. */
	23	tree
	24	hash_tree_chain (value, chain)
	25	***************
	26	* 701,705 **
	27	--- 702,721 ----
	28	}
	29
	30	+ /* Similar, but used for concatenating two lists. */
	31	tree
	32	+ hash_chainon (list1, list2)
	33	+ tree list1, list2;
	34	+ {
	35	+ if (list2 == 0)
	36	+ return list1;
	37	+ if (list1 == 0)
	38	+ return list2;
	39	+ if (TREE_CHAIN (list1) == NULL_TREE)
	40	+ return hash_tree_chain (TREE_VALUE (list1), list2);
	41	+ return hash_tree_chain (TREE_VALUE (list1),
	42	+ hash_chainon (TREE_CHAIN (list1), list2));
	43	+ }
	44	+
	45	+ tree
	46	build_decl_list_1 (value)
	47	tree value;
	48	***************
	49	* 926,930 **
	50	{
	51	if (DECL_NAME (decl))
	52	! return IDENTIFIER_POINTER (DECL_NAME (decl));
	53	return "((anonymous))";
	54	}
	55	--- 942,950 ----
	56	{
	57	if (DECL_NAME (decl))
	58	! {
	59	! if (THIS_NAME_P (DECL_NAME (decl)))
	60	! return "this";
	61	! return IDENTIFIER_POINTER (DECL_NAME (decl));
	62	! }
	63	return "((anonymous))";
	64	}
65	*** cplus-parse.y~ Mon Jun 4 23:52:34 1990
66	--- cplus-parse.y Sat Jun 30 23:45:09 1990
67	***************
68	* 501,505 **
69	error ("no base initializers given following ':'");
70	setup_vtbl_ptr ();
71	! }
72	;
73
74	--- 501,505 ----
75	error ("no base initializers given following ':'");
76	setup_vtbl_ptr ();
77	! }
78	;
79
80	***************
81	* 1274,1278 **
82	{ $$ = hash_tree_chain ($1, $2); }
83	\| declmods typespec reserved_declspecs
84	! { $$ = hash_tree_chain ($2, chainon ($3, $1)); }
85	;
86
87	--- 1274,1278 ----
88	{ $$ = hash_tree_chain ($1, $2); }
89	\| declmods typespec reserved_declspecs
90	! { $$ = hash_tree_chain ($2, hash_chainon ($3, $1)); }
91	;
92
93	***************
94	* 1319,1323 **
95	{ $$ = decl_tree_cons (NULL_TREE, $1, $2); }
96	\| nonempty_type_quals typespec reserved_typespecquals
97	! { $$ = decl_tree_cons (NULL_TREE, $2, chainon ($3, $1)); }
98	;
99
100	--- 1319,1323 ----
101	{ $$ = decl_tree_cons (NULL_TREE, $1, $2); }
102	\| nonempty_type_quals typespec reserved_typespecquals
103	! { $$ = decl_tree_cons (NULL_TREE, $2, hash_chainon ($3, $1)); }
104	;
105
106
107	If you're using g++ 1.39 on a sparc you'll probably want to apply the
108	following fix (from Casper H.S. Dik):
109
110	*** config/out-sparc.c.org Wed Dec 12 03:13:57 1990
111	--- config/out-sparc.c Sat Feb 23 23:21:26 1991
112	***************
113	* 908,925 **
114	else if (GET_CODE (XEXP (operands[1], 0)) == PLUS)
115	{
116	rtx inc_reg = XEXP (XEXP (operands[1], 0), 0);
117	if (inc_reg == frame_pointer_rtx
118	&& GET_CODE (XEXP (XEXP (operands[1], 0), 1)) == REG
119	! && XEXP (XEXP (operands[1], 0), 0) != frame_pointer_rtx)
120	inc_reg = XEXP (XEXP (operands[1], 0), 1);
121	if (inc_reg == frame_pointer_rtx)
122	{
123	output_asm_insn ("mov %%fp,%%g1", xoperands);
124	inc_reg = gen_rtx (REG, SImode, 1);
125	}
126	xoperands[1] = inc_reg;
127	output_asm_insn ("add 4,%1,%1", xoperands);
128	! xoperands[1] = operands[1];
129	output_asm_insn ("ld %1,%0", xoperands);
130	xoperands[1] = inc_reg;
131	output_asm_insn ("add -4,%1,%1", xoperands);
132	--- 908,931 ----
133	else if (GET_CODE (XEXP (operands[1], 0)) == PLUS)
134	{
135	rtx inc_reg = XEXP (XEXP (operands[1], 0), 0);
136	+ rtx from = operands[1];
137	if (inc_reg == frame_pointer_rtx
138	&& GET_CODE (XEXP (XEXP (operands[1], 0), 1)) == REG
139	! && XEXP (XEXP (operands[1], 0), 1) != frame_pointer_rtx)
140	inc_reg = XEXP (XEXP (operands[1], 0), 1);
141	if (inc_reg == frame_pointer_rtx)
142	{
143	output_asm_insn ("mov %%fp,%%g1", xoperands);
144	inc_reg = gen_rtx (REG, SImode, 1);
145	+ from = gen_rtx (GET_CODE (operands[1]),
146	+ GET_MODE (operands[1]),
147	+ gen_rtx (PLUS, GET_MODE (XEXP (operands[1], 0)),
148	+ inc_reg,
149	+ XEXP (XEXP (operands[1], 0), 1)));
150	}
151	xoperands[1] = inc_reg;
152	output_asm_insn ("add 4,%1,%1", xoperands);
153	! xoperands[1] = from;
154	output_asm_insn ("ld %1,%0", xoperands);
155	xoperands[1] = inc_reg;
156	output_asm_insn ("add -4,%1,%1", xoperands);
157	***************
158	* 989,1006 **
159	else if (GET_CODE (XEXP (operands[0], 0)) == PLUS)
160	{
161	rtx inc_reg = XEXP (XEXP (operands[0], 0), 0);
162	if (inc_reg == frame_pointer_rtx
163	&& GET_CODE (XEXP (XEXP (operands[0], 0), 1)) == REG
164	! && XEXP (XEXP (operands[0], 0), 0) != frame_pointer_rtx)
165	inc_reg = XEXP (XEXP (operands[0], 0), 1);
166	if (inc_reg == frame_pointer_rtx)
167	{
168	output_asm_insn ("mov %%fp,%%g1", xoperands);
169	inc_reg = gen_rtx (REG, SImode, 1);
170	}
171	xoperands[0] = inc_reg;
172	output_asm_insn ("add 4,%0,%0", xoperands);
173	! xoperands[0] = operands[0];
174	output_asm_insn ("st %r1,%0", xoperands);
175	xoperands[0] = inc_reg;
176	output_asm_insn ("add -4,%0,%0", xoperands);
177	--- 995,1018 ----
178	else if (GET_CODE (XEXP (operands[0], 0)) == PLUS)
179	{
180	rtx inc_reg = XEXP (XEXP (operands[0], 0), 0);
181	+ rtx to = operands[0];
182	if (inc_reg == frame_pointer_rtx
183	&& GET_CODE (XEXP (XEXP (operands[0], 0), 1)) == REG
184	! && XEXP (XEXP (operands[0], 0), 1) != frame_pointer_rtx)
185	inc_reg = XEXP (XEXP (operands[0], 0), 1);
186	if (inc_reg == frame_pointer_rtx)
187	{
188	output_asm_insn ("mov %%fp,%%g1", xoperands);
189	inc_reg = gen_rtx (REG, SImode, 1);
190	+ to = gen_rtx (GET_CODE (operands[0]),
191	+ GET_MODE (operands[0]),
192	+ gen_rtx (PLUS, GET_MODE (XEXP (operands[0], 0)),
193	+ inc_reg,
194	+ XEXP (XEXP (operands[0], 0), 1)));
195	}
196	xoperands[0] = inc_reg;
197	output_asm_insn ("add 4,%0,%0", xoperands);
198	! xoperands[0] = to;
199	output_asm_insn ("st %r1,%0", xoperands);
200	xoperands[0] = inc_reg;
201	output_asm_insn ("add -4,%0,%0", xoperands);
202
203	On a Sun 3 and other 68k machines, using libg++ 1.37.0 you will need
204	to apply the following change to g++-include/math.h:
205
206	*** math.h- Sat Jan 6 14:09:52 1990
207	--- math.h Tue Mar 13 02:07:01 1990
208	***************
209	* 32,39 **
210
211
212	#ifdef __HAVE_68881__ /* MC68881/2 Floating-Point Coprocessor */
213	- #include <math-68881.h>
214	extern "C" { /* fill in what we've left out */
215
216	double acosh(double);
217	double asinh(double);
218	--- 32,39 ----
219
220
221	#ifdef __HAVE_68881__ /* MC68881/2 Floating-Point Coprocessor */
222	extern "C" { /* fill in what we've left out */
223	+ #include <math-68881.h>
224
225	double acosh(double);
226	double asinh(double);
227
228	If you have bison 1.11, you will need to apply the following fix to
229	bison.simple if you want change any of the grammars:
230
231	*** bison.simple.~1~ Fri Aug 10 12:13:41 1990
232	--- bison.simple Fri Aug 10 12:24:46 1990
233	***************
234	* 20,26 **
235	--- 20,28 ----
236
237
238	#ifdef __GNUC__
239	+ #ifndef alloca
240	#define alloca __builtin_alloca
241	+ #endif /* Not alloca. */
242	#else /* Not GNU C. */
243	#if (!defined (__STDC__) && defined (sparc)) \|\| defined (__sparc__)
244	#include <alloca.h>
245	***************
246	* 114,123 **
247	--- 116,129 ----
248	/* This is the most reliable way to avoid incompatibilities
249	in available built-in functions on various systems. */
250	static void
251	+ #ifdef __cplusplus
252	+ __yy_bcopy (char from, char to, int count)
253	+ #else
254	__yy_bcopy (from, to, count)
255	char *from;
256	char *to;
257	int count;
258	+ #endif
259	{
260	register char *f = from;
261	register char *t = to;
262	***************
263	* 127,133 **
264	t++ = f++;
265	}
266
267	! #line 131 "/usr/local/lib/bison.simple"
268	int
269	yyparse()
270	{
271	--- 133,139 ----
272	t++ = f++;
273	}
274
275	! #line 137 "/usr/local/lib/bison.simple"
276	int
277	yyparse()
278	{
279
280	For gas 1.36 on a Sun 4, the following fix is desirable:
281
282	*** sparc.c.~1~ Mon May 21 19:06:18 1990
283	--- sparc.c Sat Aug 11 11:09:12 1990
284	***************
285	* 56,65 **
286	--- 56,67 ----
287	static struct hash_control *op_hash = NULL;
288
289	static void s_seg(), s_proc(), s_data1(), s_reserve(), s_common();
290	+ static void s_sparc_align();
291	extern void s_globl(), s_long(), s_short(), s_space(), cons();
292
293	pseudo_typeS
294	md_pseudo_table[] = {
295	+ { "align", s_sparc_align, 0 },
296	{ "common", s_common, 0 },
297	{ "global", s_globl, 0 },
298	{ "half", cons, 2 },
299
300	*** read.c.~1~ Tue Mar 6 21:08:29 1990
301	--- read.c Sat Aug 11 11:07:23 1990
302	***************
303	* 175,181 **
304	--- 175,183 ----
305	potable[] =
306	{
307	{ "abort", s_abort, 0 },
308	+ #ifndef SPARC
309	{ "align", s_align, 0 },
310	+ #endif
311	{ "ascii", stringer, 0 },
312	{ "asciz", stringer, 1 },
313	{ "byte", cons, 1 },
314
315
316	On a Sequent Symmetry S27 running Dynix 3.0.17, you'll need to use GNU
317	make or add 'MAKE=make' to Makefiles which use $(MAKE). You'll also
318	need to change
319
320	dev=${GROFF_TYPESETTER:-@DEVICE@}
321
322	to
323
324	dev=$GROFF_TYPESETTER
325
326	in groff.sh. You should use gcc to compile xditview.
327
328	You should only have to edit the top-level Makefile. The comments
329	should make it clear what has to be changed. If you don't have a
330	separate directory tree for local manual pages you can make
331	MAN[157]EXT be l (that's an ell) or n, and MANROOT be /usr/man. The
332	changes you make to the top-level Makefile will be propagated to
333	sub-makes, but this won't happen if you invoke make in the
334	sub-directories.
335
336	You might also need to edit groff.sh. This is a shell-script that
337	runs gtroff, an appropriate postprocessor and optionally various
338	preprocessors. (Actually, the shell-script is created from groff.sh
339	by substituting for some variables surrounded by @s). If your kernel
340	doesn't understand #!, you will need to arrange for the script to be
341	run by /bin/sh in some other way.
342
343	If you want to use existing troff drivers you should change groff.sh
344	so that it recognises them. It is also a good idea to copy over the
345	dev* directory for the device into a directory that's only searched by
346	groff (eg /usr/local/lib/groff/font), so that you can take advantage
347	of the groff extensions to the DESC and font formats. Groff only uses
348	the ASCII versions of the device files so you only need copy them. If
349	you want to use GNU eqn, it is essential that the font files contain
350	correct height and depth information. The format for this information
351	is described in the groff_font(5) page. The best way to add this
352	information is to modify the program that generates the font files.
353	As a last resort you could try using the program addftinfo: it
354	attempts to guess plausible heights and depths. To obtain good
355	results you would probably have to do more work on addftinfo.
356
357	To compile everything, just do a `make'. If that works, then do a
358	`make install'.
359
360	If you have problems compiling pic/pic.tab.c or eqn/eqn.tab.c, you might
361	want to try using your system's yacc. Set YACC=yacc in the top-level
362	Makefile, and also do
363
364	mv pic/pic.tab.c pic/pic.tab.c.dist
365	mv eqn/eqn.tab.c eqn/eqn.tab.c.dist
366
367	so that the parsers will be regenerated using yacc (the supplied
368	*.tab.[ch] files were generated by bison.)
369
370	If you want to install xditview, you'll need to do that separately:
371	change directory to xditview, edit the Makefile, do a make and a make
372	install. You'll need to be running X11R4.
373
374	The dvi files produced by grodvi can use fonts at non-standard
375	magnifications. You may need to compile fonts with Metafont at these
376	magnifications. The CompileFonts script in the dvi/devdvi directory
377	may help you to do this. (It will take a long time.)
378
379	If you have problems printing existing troff documents, read the
380	section on `Incompatbilities' in gtroff(1). If you have existing
381	macro packages that are in the habit of omitting the space between a
382	macro or request and its arguments, it is good idea to produce a
383	version with spaces so that you can use it with groff (without having
384	to use the -C flag). The file macros/fixmacros.sed is a sed script
385	which will attempt to edit a file of macros so that it can be used
386	with groff without the -C flag. If you have the DWB 2.0 mm macros
387	installed on your machine, you might want to do a `make install.mm';
388	this will copy the mm macros to groff's macro directory and fix a few
389	problems that occur when using the mm macros with groff; this requires
390	the `patch' program. If the patch in macros/mm.diff is rejected,
391	carefully apply it by hand.
392
393	You can share groff with a friend who has the same type of machine as
394	you, but does not have a C++ compiler. First do `make bindist'; this
395	will create a subdirectory `bindist' containing a set of binaries, a
396	Makefile and a README. If you want to strip the binaries, now do a
397	`make strip' in the bindist directory. Rename the bindist directory
398	to something more meaningful, tar it up, and give to your friend along
399	with the original groff source distribution. Your friend can then
400	install groff just by editing the Makefile in the bindist directory
401	and doing a make there; this will automatically install the non-binary
402	parts of the groff source distribution as well as the binaries from
403	the bindist directory.