INSTALL revision 104862
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 818099Spstgroff is written in C++, so you will need a C++ compiler. The C++ 918099Spstsource files use a suffix of `.cc', so your C++ compiler must be able 1018099Spstto handle this. If you don't already have a C++ compiler, I suggest 1118099Spstgcc 2.7.1 or later (gcc version 2 includes GNU C++ as well as GNU C). 1218099SpstFrom gcc 2.5, it is no longer necessary to install libg++: the C++ 1318099Spstheader files needed by groff are created by the gcc installation 1418099Spstprocess. To override configure's choice of C++ compiler, you can set 1518099Spstthe CXX environment variable. 1618099Spst 1718099SpstIf you have a library that provides a faster malloc than your system's 1818099Spstusual malloc, it is good idea to include it in LIBS. For example, 1955839Sasmodaiusing the malloc that comes with GNU Emacs version 20 can give a 2018099Spstworthwhile (and sometimes spectacular) performance improvement. 2118099Spst 2275584SruIf you want A4 or letter paper format and the configure script produces 2375584Sruan incorrect guess, say 2475584Sru 2575584Sru PAGE=xxx ./configure 2675584Sru 2775584Sruwhere `xxx' should be either `A4' or `letter'. Note that this will only 2875584Sruaffect the paper selection for grops. For compatibility with ditroff, 2975584Sruthe default page length in gtroff is always 11 inches. The page length 3075584Srucan be changed with the `pl' request. 3175584Sru 3244777SobrienWhen you have built groff, you can use the test-groff script to try 3318099Spstgroff out on one of the man pages. (Use the .n files not the .man 3418099Spstfiles.) The test-groff script sets up environment variables to allow 3518099Spstgroff to run without being installed. The current directory must be 3618099Spstthe build directory when the script is run. For example, you could do 3718099Spst 3869626Sru ./test-groff -man -Tascii src/roff/groff/groff.n | less 3918099Spst 4069626SruIf you want to compile and install gxditview (an X11 previewer), 4169626Srufollow the instructions in the INSTALL file in the src/xditview 4269626Srusubdirectory. 4318099Spst 44104862SruTo get a DVI, PDF, or HTML version of the groff texinfo manual, say `make 45104862Srugroff.dvi', `make groff.pdf', or `make groff.html', respectively, in the 46104862Sru`doc' subdirectory (after compiling the groff package). Note that you 47104862Sruneed texinfo version 4.2 or newer as a prerequisite. 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