2001-04-19 16:47:42 +04:00
|
|
|
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.)
|
|
|
|
|
|
Import groff-1.19.1. Changes since 1.19:
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.
2004-07-30 18:44:08 +04:00
|
|
|
(For instructions how to build groff with the MinGW tools for
|
|
|
|
|
MS-Windows, see the file README.MinGW.)
|
|
|
|
|
|
2001-04-19 16:47:42 +04:00
|
|
|
groff is written in C++, so you will need a C++ compiler. The C++
|
2003-06-30 21:51:41 +04:00
|
|
|
source files use a suffix of `.cpp', so your C++ compiler must be able
|
2001-04-19 16:47:42 +04:00
|
|
|
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.
|
|
|
|
|
|
2003-06-30 21:51:41 +04:00
|
|
|
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
|
Import groff-1.19.1. Changes since 1.19:
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.
2004-07-30 18:44:08 +04:00
|
|
|
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.
|
2003-06-30 21:51:41 +04:00
|
|
|
|
2001-04-19 16:47:42 +04:00
|
|
|
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
|
2006-02-06 21:10:27 +03:00
|
|
|
groff to run without being installed. For example, you could do
|
2001-04-19 16:47:42 +04:00
|
|
|
|
|
|
|
|
./test-groff -man -Tascii src/roff/groff/groff.n | less
|
|
|
|
|
|
2003-06-30 21:51:41 +04:00
|
|
|
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
|
Import groff-1.19.1. Changes since 1.19:
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.
2004-07-30 18:44:08 +04:00
|
|
|
`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.
|
2001-04-19 16:47:42 +04:00
|
|
|
|
|
|
|
|
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.
|