[bug #60061] Narrow scope of groff Texinfo manual

[Deri James]

Follow-up Comment #7, bug #60061 (project groff):

A little more polished, with options (see README) and the default build mimics
the version produced by pdftex, although that is not my favourite!

README
======

To build the groff book use make. The default settings will produce a book in
a very similar style to pdftex, using mainly Computer Modern fonts. However,
there are a number of parameters you can change which will change the style.
The parameters are entered in this way:-

make ARGS='parameter value ...'

The major parameter is "--ver" which can be set to either "original" (the
default if the parameter is not present), or "new" which uses the groff fonts
Helvetica and Courier. This parameter sets all the other parameters listed
below to default values but these can be separately overriden.

These are the separate parameters which can appear in ARGS:-

fam : the font family to use for the body text. Defaults to "H" for new and
CMT for the original.

codefam : the font family to use for monospaced text, set to "C" for new and
"CMC" for original.

hdcol : this should be one of the named colours which groff has
pre-configured, "forestgreen" used for new and "black" for original. It
specifies the colour for all text headings.

baseind : this is the amount of indent to use when indenting text. It is set
to 1.5c for both versions. Note that bulletted lists use a fixed indent
amount
which can't be changed.

psz : the default point size, 12p for new and 13.25p for original.

vsz : the default vertical space for the font, 14.5p for both versions.

po : is the margin size, set to 2c for new and 3c for original.

ll : this is the line length used for the book. Since the book is designed
for
A4 pages, you should use "c" as the units for po and ll (centimeters).
Normally you don't need this parameter since the default for both versions is
21c-(2*po), which gives symetrical margins.

For example:-

make ARGS='--po 2c'

will generate the original style but with 2cm margins. And:-

make ARGS='--ver new --codefam CMC'

Would generate a new style book but using Computer Modern monospaced instead
of Courier for the code snippets.

Please note that these parameters do not affect the section of the book which
documents "Introduction to PIC" since this section has to have specified
values for the "pictures" to render correctly.

After the book has been generated, in order to generate it again, either do
a 'make clean' or call make like this:-

touch groff.texi; make ARGS='...'

Deri James



(file #51016)
    _______________________________________________________

Additional Item Attachment:

File name: texi2groff-beta2.tgz           Size:734 KB
    <https://file.savannah.gnu.org/file/texi2groff-beta2.tgz?file_id=51016>



    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?60061>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/