/contrib/groff/INSTALL

https://bitbucket.org/freebsd/freebsd-head/ · #! · 50 lines · 38 code · 12 blank · 0 comment · 0 complexity · 679f07ee836f7da4806b3a112d275d5a MD5 · raw file

  1. To install groff, follow the instructions in the file INSTALL.gen.
  2. This file contains information that supplements those instructions.
  3. (For instructions how to build groff with DJGPP tools for MS-DOS and
  4. MS-Windows, see the file arch/djgpp/README.)
  5. (For instructions how to build groff with the MinGW tools for
  6. MS-Windows, see the file README.MinGW.)
  7. groff is written in C++, so you will need a C++ compiler. The C++
  8. source files use a suffix of `.cpp', so your C++ compiler must be able
  9. to handle this. If you don't already have a C++ compiler, I suggest
  10. gcc 2.7.1 or later (gcc version 2 includes GNU C++ as well as GNU C).
  11. From gcc 2.5, it is no longer necessary to install libg++: the C++
  12. header files needed by groff are created by the gcc installation
  13. process. To override configure's choice of C++ compiler, you can set
  14. the CXX environment variable.
  15. If you have a library that provides a faster malloc than your system's
  16. usual malloc, it is good idea to include it in LIBS. For example,
  17. using the malloc that comes with GNU Emacs version 20 can give a
  18. worthwhile (and sometimes spectacular) performance improvement.
  19. If you want A4 or letter paper format and the configure script produces
  20. an incorrect guess, say
  21. PAGE=xxx ./configure
  22. where `xxx' should be either `A4' or `letter'. Note that this will only
  23. affect the paper selection of some device drivers like grops (which can
  24. be still overridden on the command line). For compatibility with
  25. ditroff, the default page length in gtroff is always 11 inches. The
  26. page length can be changed with the `pl' request.
  27. When you have built groff, you can use the test-groff script to try
  28. groff out on one of the man pages. (Use the .n files not the .man
  29. files.) The test-groff script sets up environment variables to allow
  30. groff to run without being installed. For example, you could do
  31. ./test-groff -man -Tascii src/roff/groff/groff.n | less
  32. To get a DVI, PDF, or HTML version of the groff texinfo manual, say `make
  33. groff.dvi', `make groff.pdf', or `make groff.html', respectively, in the
  34. `doc' subdirectory (after configuring the groff package). Note that you
  35. need texinfo version 4.6 as a prerequisite. Neither older versions nor
  36. texinfo 4.7 (due to a bug) will work.
  37. If you have problems, read the PROBLEMS file. If this doesn't help
  38. send a bug report using the form in the file BUG-REPORT.