Follow-up Comment #6, bug #58831 (group groff): At 2025-11-15T17:29:05-0500, Doug McIlroy wrote: > Follow-up Comment #5, bug #58831 (group groff): > > It would be sinful to distribute a program without a man page.
It's a...uh...uh...example, not a program. :)
/home/branden/groff-HEAD/share/doc/groff-1.23.0/examples/install-font.bash
Its execute bit is not set.
Another interesting trait it has is that it builds its man page in...
$ bash $(find ~/groff-HEAD -name "install-font*") -H
USAGE:
install-font.sh [-hHlscpn] [-P dir] [-C dir] [-F family] [-f groff
fontname] file1 file2 ...
DESCRIPTION:
A utility to make TrueType (.ttf), OpenType (.otf), and
PostScript Type1 (.pfa, .pfb) fonts available for use with
groff.
With no options, for every file named on the command line,
install-font prompts for
- a family name
- a groff fontname
- whether to make the font available to gropdf
- whether to copy the input file(s) to a system-wide location
install-font.sh calls fontforge to convert TrueType and OpenType
fonts to PostScript Type42 (.t42) and Type1 (.pfa), from which
a groff font is generated. The .t42 and groff fonts are moved
to site-font/devps/ and registered in the 'download' file. If
the font is to be available to gropdf, the .pfa is moved to
site-font/devpdf/ and registered in its 'download' file. A
symlink is made to the groff font in site-font/devps.
PostScript fonts are converted to .pfa, even those with a .pfa
extension. The newly-generated .pfa has a filename derived from the
font's PostScript name. This is helpful in the case of fonts with
cryptic names like 'bchri8a.pfa', which becomes 'CharterBT-Italic.pfa'.
In all cases, the original file is preserved with its original
name in the directory from which the font is being installed.
The .pfa and groff fonts are moved to site-font/devps/ and
registered in the 'download' file. If the font is to be
available to gropdf, symlinks are made in site-font/devpdf/ to
both the .pfa and the groff font, and the .pfa is registered
in /site-font/devpdf/download.
OPTIONS
Options not requiring an argument may be grouped.
-h Short help.
-H Long help.
-l Assume prefix /usr/local/share/groff for all directories. (default)
-s Assume prefix /usr/share/groff for all directories.
-P dir
Path to the top-level groff directory if groff has been
installed in a non-default location.
-c Copy file(s) named on the command line to a system-accessible
location. If neither -s nor -C is given, copy to the family
directory (see -F) under /usr/local/share/fonts/<fonttype>/,
where <fonttype> is one of 'truetype', 'type1', or 'opentype'.
If -s is given, copy to the family directory located under
/usr/share/fonts/<fonttype>/.
If neither -c nor -C is given, a prompt asks whether to copy
the file(s) named on the command line.
-n Don't copy file(s) named on the command line to a system-accessible
location.
-d Make font available to gropdf.
-D Do not make font available to gropdf.
-p Ask before overwriting or linking files. Default is to
overwrite without asking.
-C dir
Copy file(s) named on the command line to the family directory
(see -F) in dir.
-F family
Family to which the font belongs. Creates a family for the
groff font, which can then be accessed by calls to .fam or
.FAMILY (mom macros). Also creates a family directory for
fonts being made available system-wide (see -c and -C).
-F is useful for batch processing fonts that belong to the
same family. Use with care, since all files named on the
command line will be assigned to family.
If -F is not given, a prompt asks for the family name.
-f name or +STYLE
Name by which to access the font with calls to .ft or
.FT (mom macros). name may be arbitrary, or
a '+' sign prefixed to an uppercase fontstyle recognized
by groff, eg +R, +I, +B, +BI, which respectively stand for
regular, italic, bold, and bold italic. The mom macros
provide additional styles, which may also be used.
+STYLE is affixed to the family name to arrive at the
groff fontname.
install-font -F Garamond -f +R <file>
creates font GaramondR, which can be accessed by
.fam Garamond
.ft R
or
.ft GaramondR
-f is not compatible with batch processing. install-font
will abort if the -f option is given and multiple files are
named on the command line.
If -f is not given, a prompt asks for the font name.
How's my lawyering? ;-)
_______________________________________________________
Reply to this item at:
<https://savannah.gnu.org/bugs/?58831>
_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/
signature.asc
Description: PGP signature
