gbranden pushed a commit to branch master
in repository groff.
commit a590d47a4a5cfb863822eb3259f0f2a1cb4779e7
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Jan 22 15:20:50 2026 -0600
[gropdf,grops]: Document "install-font.bash".
...specifically, its availability.
NEWS: Add item for the same purpose.
Fixes <https://savannah.gnu.org/bugs/?58831>.
---
NEWS | 7 +++++++
src/devices/gropdf/gropdf.1.man | 41 +++++++++++++++++++++++++++++++++++++++++
src/devices/grops/grops.1.man | 41 +++++++++++++++++++++++++++++++++++++++++
3 files changed, 89 insertions(+)
diff --git a/NEWS b/NEWS
index 3a546cbf3..d9e72ab26 100644
--- a/NEWS
+++ b/NEWS
@@ -869,6 +869,13 @@ Utilities
command substitution feature of your shell; see section "Examples" of
groff(1).
+* groff now offers install-font.bash, a shell script that interactively
+ assists the configuration of fonts for use with the GNU troff
+ formatter and the gropdf and grops output drivers. For now, it is
+ provided as an example, as it lacks a man page. You can change to
+ its directory and run "bash install-font.bash -H" for a man page-like
+ description of its features and operation.
+
Miscellaneous
-------------
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 607195870..e7c420bac 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -1973,6 +1973,23 @@ does not yet support any font formats besides Adobe Type
1
.SH "Font installation"
.\" ====================================================================
.
+For your convenience,
+.I groff
+offers
+.IR install\-font.bash ,
+a shell script that interactively assists
+the configuration of fonts for use with the
+GNU
+.I troff \" GNU
+formatter
+and the
+.I gropdf
+output driver.
+.
+See section \[lq]Files\[rq] below.
+.
+.
+.P
The following is a step-by-step font installation guide for
.I gropdf.
.
@@ -2355,6 +2372,30 @@ see
.
It is automatically loaded by
.I troffrc.
+.
+.
+.TP
+.I @DOCDIR@/\:\%examples/\:install\-font\:.bash
+This script,
+contributed by
+.I mom
+macro package author Peter Schaffter
+and long available at his web site,
+assists with making
+TrueType
+.RI ( .ttf ),
+OpenType
+.RI ( .otf ),
+and PostScript Type\~1
+.RI ( .pfa ,
+.IR .pfb )
+fonts available to
+.IR groff .
+.
+.IP
+Change to its directory and run
+.RB \[lq] "bash install\-font.bash \-H" \[rq]
+for a man page-like description of its features and operation.
.\"
.\"
.\" .TP
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index 998c3732a..8671cbbd8 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -1456,6 +1456,23 @@ option.
.SH "Font installation"
.\" ====================================================================
.
+For your convenience,
+.I groff
+offers
+.IR install\-font.bash ,
+a shell script that interactively assists
+the configuration of fonts for use with the
+GNU
+.I troff \" GNU
+formatter
+and the
+.I grops
+output driver.
+.
+See section \[lq]Files\[rq] below.
+.
+.
+.P
The following is a step-by-step font installation guide for
.I grops.
.
@@ -1864,6 +1881,30 @@ can produce glyphs like eth (\[Sd]) and thorn (\[Tp])
that older
PostScript printers do not natively support.
.
.
+.TP
+.I @DOCDIR@/\:\%examples/\:install\-font\:.bash
+This script,
+contributed by
+.I mom
+macro package author Peter Schaffter
+and long available at his web site,
+assists with making
+TrueType
+.RI ( .ttf ),
+OpenType
+.RI ( .otf ),
+and PostScript Type\~1
+.RI ( .pfa ,
+.IR .pfb )
+fonts available to
+.IR groff .
+.
+.IP
+Change to its directory and run
+.RB \[lq] "bash install\-font.bash \-H" \[rq]
+for a man page-like description of its features and operation.
+.
+.
.P
.I grops
creates temporary files using the template
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
