INSTALL revision 151497
118099SpstTo install groff, follow the instructions in the file INSTALL.gen. 218099Spst 318099SpstThis file contains information that supplements those instructions. 418099Spst 569626Sru(For instructions how to build groff with DJGPP tools for MS-DOS and 669626SruMS-Windows, see the file arch/djgpp/README.) 769626Sru 8151497Sru(For instructions how to build groff with the MinGW tools for 9151497SruMS-Windows, see the file README.MinGW.) 10151497Sru 1118099Spstgroff is written in C++, so you will need a C++ compiler. The C++ 12114402Srusource files use a suffix of `.cpp', so your C++ compiler must be able 1318099Spstto handle this. If you don't already have a C++ compiler, I suggest 1418099Spstgcc 2.7.1 or later (gcc version 2 includes GNU C++ as well as GNU C). 1518099SpstFrom gcc 2.5, it is no longer necessary to install libg++: the C++ 1618099Spstheader files needed by groff are created by the gcc installation 1718099Spstprocess. To override configure's choice of C++ compiler, you can set 1818099Spstthe CXX environment variable. 1918099Spst 2018099SpstIf you have a library that provides a faster malloc than your system's 2118099Spstusual malloc, it is good idea to include it in LIBS. For example, 2255839Sasmodaiusing the malloc that comes with GNU Emacs version 20 can give a 2318099Spstworthwhile (and sometimes spectacular) performance improvement. 2418099Spst 2575584SruIf you want A4 or letter paper format and the configure script produces 2675584Sruan incorrect guess, say 2775584Sru 2875584Sru PAGE=xxx ./configure 2975584Sru 3075584Sruwhere `xxx' should be either `A4' or `letter'. Note that this will only 31151497Sruaffect the paper selection of some device drivers like grops (which can 32151497Srube still overridden on the command line). For compatibility with 33151497Sruditroff, the default page length in gtroff is always 11 inches. The 34151497Srupage length can be changed with the `pl' request. 3575584Sru 3644777SobrienWhen you have built groff, you can use the test-groff script to try 3718099Spstgroff out on one of the man pages. (Use the .n files not the .man 3818099Spstfiles.) The test-groff script sets up environment variables to allow 39151497Srugroff to run without being installed. For example, you could do 4018099Spst 4169626Sru ./test-groff -man -Tascii src/roff/groff/groff.n | less 4218099Spst 43104862SruTo get a DVI, PDF, or HTML version of the groff texinfo manual, say `make 44104862Srugroff.dvi', `make groff.pdf', or `make groff.html', respectively, in the 45151497Sru`doc' subdirectory (after configuring the groff package). Note that you 46151497Sruneed texinfo version 4.6 as a prerequisite. Neither older versions nor 47151497Srutexinfo 4.7 (due to a bug) will work. 4855839Sasmodai 4918099SpstIf you have problems, read the PROBLEMS file. If this doesn't help 5018099Spstsend a bug report using the form in the file BUG-REPORT. 51