INSTALL revision 256281
1193323SedTo install groff, follow the instructions in the file INSTALL.gen. 2193323Sed 3193323SedThis file contains information that supplements those instructions. 4193323Sed 5193323Sed(For instructions how to build groff with DJGPP tools for MS-DOS and 6193323SedMS-Windows, see the file arch/djgpp/README.) 7193323Sed 8193323Sed(For instructions how to build groff with the MinGW tools for 9193323SedMS-Windows, see the file README.MinGW.) 10193323Sed 11193323Sedgroff is written in C++, so you will need a C++ compiler. The C++ 12193323Sedsource files use a suffix of `.cpp', so your C++ compiler must be able 13193323Sedto handle this. If you don't already have a C++ compiler, I suggest 14193323Sedgcc 2.7.1 or later (gcc version 2 includes GNU C++ as well as GNU C). 15193323SedFrom gcc 2.5, it is no longer necessary to install libg++: the C++ 16193323Sedheader files needed by groff are created by the gcc installation 17193323Sedprocess. To override configure's choice of C++ compiler, you can set 18193323Sedthe CXX environment variable. 19193323Sed 20193323SedIf you have a library that provides a faster malloc than your system's 21193323Sedusual malloc, it is good idea to include it in LIBS. For example, 22193323Sedusing the malloc that comes with GNU Emacs version 20 can give a 23193323Sedworthwhile (and sometimes spectacular) performance improvement. 24193323Sed 25193323SedIf you want A4 or letter paper format and the configure script produces 26193323Sedan incorrect guess, say 27193323Sed 28193323Sed PAGE=xxx ./configure 29193323Sed 30193323Sedwhere `xxx' should be either `A4' or `letter'. Note that this will only 31193323Sedaffect the paper selection of some device drivers like grops (which can 32193323Sedbe still overridden on the command line). For compatibility with 33193323Sedditroff, the default page length in gtroff is always 11 inches. The 34193323Sedpage length can be changed with the `pl' request. 35193323Sed 36193323SedWhen you have built groff, you can use the test-groff script to try 37193323Sedgroff out on one of the man pages. (Use the .n files not the .man 38193323Sedfiles.) The test-groff script sets up environment variables to allow 39193323Sedgroff to run without being installed. For example, you could do 40193323Sed 41193323Sed ./test-groff -man -Tascii src/roff/groff/groff.n | less 42193323Sed 43193323SedTo get a DVI, PDF, or HTML version of the groff texinfo manual, say `make 44193323Sedgroff.dvi', `make groff.pdf', or `make groff.html', respectively, in the 45193323Sed`doc' subdirectory (after configuring the groff package). Note that you 46193323Sedneed texinfo version 4.6 as a prerequisite. Neither older versions nor 47193323Sedtexinfo 4.7 (due to a bug) will work. 48193323Sed 49193323SedIf you have problems, read the PROBLEMS file. If this doesn't help 50193323Sedsend a bug report using the form in the file BUG-REPORT. 51193323Sed