Update of bug #60929 (project groff):
Category: None => Device - others/general
Summary: Improve documentation of which fonts groff provides
by default => device man pages should consistently document font repertoire
_______________________________________________________
Follow-up Comment #1:
I propose that device man pages should have a section "Typefaces", relatively
early in the narrative (before "Options", I should think) since this is a
crucial feature to users, that lists all styles/fonts for which groff ships
descriptions by default. (A subsection of "Description" might also be
apropos.)
* grodvi(1) pretty much has this already, as "Usage".
* grohtml(1) does as well. It supports only the four basic styles.
* grolbp(1) has it already under the desired section heading.
* grolj4(1) has nothing. There is however the entire man page lj4_font(5),
which I propose to merge into this one. Even that, however, does not
comprehensively enumerate the font descriptions available. So this is the
longest pole so far.
* gropdf(1) has a list under "Usage", albeit mixed with a great deal of other
material, including a huge list of device control commands.
* grops(1)'s structure is parallel to gropdf(1)'s.
* grotty(1) has this information in a "Typefaces" subsection of "Description".
It's similar to grohtml in that it only covers styles.
* gxditview(1) has this information in subsection "Default font map" of
"Description".
I don't know who still keeps an HP LaserJet jacked to their machine (we don't
ever get any bug reports about the driver), but it seems like that's the place
to start; it will also enable us to kill one of the 3 groff man pages on my
Death List (the others are ditroff(7) and groff_filenames(5)).
_______________________________________________________
Reply to this item at:
<https://savannah.gnu.org/bugs/?60929>
_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/
