INSTALL revision 69626
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 2244777SobrienWhen you have built groff, you can use the test-groff script to try 2318099Spstgroff out on one of the man pages. (Use the .n files not the .man 2418099Spstfiles.) The test-groff script sets up environment variables to allow 2518099Spstgroff to run without being installed. The current directory must be 2618099Spstthe build directory when the script is run. For example, you could do 2718099Spst 2869626Sru ./test-groff -man -Tascii src/roff/groff/groff.n | less 2918099Spst 3069626SruIf you want to compile and install gxditview (an X11 previewer), 3169626Srufollow the instructions in the INSTALL file in the src/xditview 3269626Srusubdirectory. 3318099Spst 3469626SruTo get PostScript versions of the documentation resp. reference files 3569626Srufor the `me' macros and the `pic' preprocessor, simply say `make' in 3669626Sruthe `doc' subdirectory. 3755839Sasmodai 3818099SpstIf you have problems, read the PROBLEMS file. If this doesn't help 3918099Spstsend a bug report using the form in the file BUG-REPORT. 40