Update of bug #68407 (group groff):
Status: Confirmed => Fixed
Open/Closed: Open => Closed
Planned Release: None => 1.25.0
_______________________________________________________
Follow-up Comment #1:
I forgot to add a bug-closer to the ChangeLog entry and thus the commit log
message.
commit addb8619890bc0c9cf11ac4c37f57164c195ef69
Author: G. Branden Robinson <[email protected]>
Date: Fri Jul 3 00:17:07 2026 -0500
[doc,man]: Add line layout diagram.
* doc/line-layout.roff: New file uses pic(1) to replace ASCII art
diagram of *roff output line geometry.
* doc/doc.am: Define new macros `DOC_LINE_LAYOUT_EPS` and
`DOC_LINE_LAYOUT_PNG` to track names of rendered forms of the
foregoing pic(1) image. Clean these files from the build directory.
Add them as prerequisites to the `$(GROFF_DVI)` and `$(GROFF_PDF)`
targets, respectively. Add the new file and its rendered forms to the
`EXTRA_DIST` macro to ship them in our distribution archive.
($(GROFF_HTML)): Add `DOC_LINE_LAYOUT_PNG` as prerequisite. Copy that
file into the directory used by the split-by-node version of our
Texinfo manual in HTML form, as required for makeinfo(1) to generate a
non-broken "<img src>" element.
(maintainer-clean-local): Clean the rendered image files from the
build directory.
(install-html-local): Install the rendered image file where the
monolithic version of our Texinfo manual in HTML form can find it.
(dist-gnueps): XXX Drop apparently unneeded target, and `dist-hook`'s
use of it as a prerequisite.
($(DOC_LINE_LAYOUT_EPS)): New target rule renders the new file as
Encapsulated PostScript file using groff(1), gs(1) {Ghostscript}, and
sed(1), as documented in grops(1).
($(DOC_LINE_LAYOUT_PNG)): New target rule renders the new file as a
Portable Network Graphics file using convert(1) {ImageMagick}.
* doc/groff.texi.in (Line Layout): Inline image. Retain the ASCII art
version, but output it only `ifinfo`--rendering to a format that
doesn't support inline images.
* man/groff.7.man (Line layout): Inline aforementioned pic(1) document
with a `so` request, only if in troff mode. Otherwise, use the
existing ASCII art version. So that installed systems don't have to
manage the installation location of the file...
* Makefile.am: ...update `.man` suffix rule to depend on soelim(1), and
unconditionally run all man pages (which are generated files already
anyway) through soelim(1), literally inlining the pic(1) region. Pass
soelim(1) `-I` options so that the "line-layout.roff" file should be
found whether the build takes place inside or outside of the build
tree.
Thanks to Stefan Möding for the new diagram!
ANNOUNCE: Acknowledge Stefan.
_______________________________________________________
Reply to this item at:
<https://savannah.gnu.org/bugs/?68407>
_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/
signature.asc
Description: PGP signature
