48af41221f
Groff ----- o The argument of the command line option `-I' is now also passed to troff and grops, specifying a directory to search for files on the command line, files named in `so' and `psbb' requests, and files named in \X'ps: file' and \X'ps: import' escapes. o If option `-V' is used more than once, the commands will be both printed on standard error and run. Troff ----- o Two new read-only, string-valued registers `.m' and `.M' return the name of the current drawing and background color, respectively. o New read-only register `.U' which is set to 1 if in safer mode and set to 0 if in unsafe mode. o An input encoding file for latin-5 (a.k.a. ISO 8859-9) has been added. Example use: groff -Tdvi -mlatin5 my_file > my_file.dvi Note that some output devices don't support all glyphs of this encoding. o If the `return' request is called with an argument, it exits twice, namely the current macro and the macro one level higher. This is used to define a wrapper macro for `return' in trace.tmac. o For completeness, two new requests have been added: `dei1' and `ami1'. They are equivalent to `dei' and `ami', respectively, but the macros are executed with compatibility mode off (similar to `de1' and `am1'). o New command line option `-I' to specify a directory for files (both those on the command line and those named in `psbb' requests). This is also handled by the groff wrapper program. o Since version 1.19 you can say `.vs 0'. Older versions emit a warning and convert this to `.vs \n[.V]'. This hasn't been documented properly. Note that `.vs 0' isn't saved in a diversion since it doesn't result in vertical motion. Pic ___ o Dashed and dotted ellipses have been implemented. Tbl --- o New key character `x' to make tbl call a user-defined macro on a table cell. Patch by Heinz-Jürgen Oertel <hj.oertel@surfeu.de>. Grohtml ------- o New option `-j' to emit output splitted into multiple files. Grops ----- o New command line option `-I' to specify a directory to search for files on the command line and files named in \X'ps: import' and \X'ps: file' escapes. This is also handled by the groff wrapper program. o The default value for the `broken' keyword in the DESC file is now 0. Grolj4 ------ o A new man page `lj4_font(5)' documents how fonts are accessed with grolj4. o The built-in fonts for LJ4 and newer PCL 5 devices have been completely revised, mainly to access as much glyphs as possible. The provided metric files should be compatible with recent PCL 5 printers also. Additionally, font description files have been added for the Arial and Times New Roman family, the MS symbol, and Wingdings fonts. Hpftodit -------- o Completely revised to handle HP TrueType metric files also. See the hpftodit manual page for more details. Macro Packages -------------- o www.tmac: New macro `JOBNAME' to split output into multiple files. o In mdoc, multiple calls to `.Lb' are now supported in the LIBRARY section.
56 lines
2.5 KiB
Plaintext
56 lines
2.5 KiB
Plaintext
To install groff, follow the instructions in the file INSTALL.gen.
|
|
|
|
This file contains information that supplements those instructions.
|
|
|
|
(For instructions how to build groff with DJGPP tools for MS-DOS and
|
|
MS-Windows, see the file arch/djgpp/README.)
|
|
|
|
(For instructions how to build groff with the MinGW tools for
|
|
MS-Windows, see the file README.MinGW.)
|
|
|
|
groff is written in C++, so you will need a C++ compiler. The C++
|
|
source files use a suffix of `.cpp', so your C++ compiler must be able
|
|
to handle this. If you don't already have a C++ compiler, I suggest
|
|
gcc 2.7.1 or later (gcc version 2 includes GNU C++ as well as GNU C).
|
|
From gcc 2.5, it is no longer necessary to install libg++: the C++
|
|
header files needed by groff are created by the gcc installation
|
|
process. To override configure's choice of C++ compiler, you can set
|
|
the CXX environment variable.
|
|
|
|
If you have a library that provides a faster malloc than your system's
|
|
usual malloc, it is good idea to include it in LIBS. For example,
|
|
using the malloc that comes with GNU Emacs version 20 can give a
|
|
worthwhile (and sometimes spectacular) performance improvement.
|
|
|
|
If you want A4 or letter paper format and the configure script produces
|
|
an incorrect guess, say
|
|
|
|
PAGE=xxx ./configure
|
|
|
|
where `xxx' should be either `A4' or `letter'. Note that this will only
|
|
affect the paper selection of some device drivers like grops (which can
|
|
be still overridden on the command line). For compatibility with
|
|
ditroff, the default page length in gtroff is always 11 inches. The
|
|
page length can be changed with the `pl' request.
|
|
|
|
When you have built groff, you can use the test-groff script to try
|
|
groff out on one of the man pages. (Use the .n files not the .man
|
|
files.) The test-groff script sets up environment variables to allow
|
|
groff to run without being installed. The current directory must be
|
|
the build directory when the script is run. For example, you could do
|
|
|
|
./test-groff -man -Tascii src/roff/groff/groff.n | less
|
|
|
|
If you want to compile and install gxditview (an X11 previewer),
|
|
follow the instructions in the INSTALL file in the src/xditview
|
|
subdirectory.
|
|
|
|
To get a DVI, PDF, or HTML version of the groff texinfo manual, say `make
|
|
groff.dvi', `make groff.pdf', or `make groff.html', respectively, in the
|
|
`doc' subdirectory (after configuring the groff package). Note that you
|
|
need texinfo version 4.6 as a prerequisite. Neither older versions nor
|
|
texinfo 4.7 (due to a bug) will work.
|
|
|
|
If you have problems, read the PROBLEMS file. If this doesn't help
|
|
send a bug report using the form in the file BUG-REPORT.
|