Follow-up Comment #3, bug #68525 (group groff): At 2026-07-14T22:20:36-0400, Dave wrote: > Follow-up Comment #2, bug #68525 (group groff): > > [comment #1 comment #1:] >> Since we have no HTML-only docs, another technique is to steer >> make(1) toward building a non-HTML counterpart of the document. > > I personally don't care about building _any_ docs just to test the > software. But the build system builds them by default (and you've > been resistant to requests to decouple them, as I recall), so when > problems arise in the default build, I report them to hopefully keep > other users from stumbling over them, not because I care what > documentation is built.
Okay. I appreciate the report. Let's see if we can figure it out.
> In this case, it appears doc/webpage.ms is looking for gnu.eps, which
> (a quick "find" confirms) does not exist in the groff tree I'm
> building in.
That would be a/the problem, then.
doc/doc.am:
...
# These images are used by several documents in the groff source tree.
DOC_GNU_EPS = doc/gnu.eps
DOC_GNU_PNG = doc/gnu.png
DOC_LINE_LAYOUT_EPS = doc/line-layout.eps
DOC_LINE_LAYOUT_PNG = doc/line-layout.png
...
doc/webpage.ps: $(DOC_GNU_EPS) tmac/pspic.tmac tmac/www.tmac tbl
doc/webpage.ps: $(doc_srcdir)/webpage.ms $(TMAC_PACKAGE_MS)
$(GROFF_V)$(MKDIR_P) `dirname $@` \
&& $(DOC_GROFF) -I $(doc_srcdir) -I $(doc_builddir) -t -Tps \
-ms -mwww $(doc_srcdir)/webpage.ms >$@
...
# XXX: See XXX comment before "pic.html" target above.
doc/webpage.html: $(DOC_GNU_PNG) tmac/www.tmac tbl
doc/webpage.html: $(doc_srcdir)/groff.css
doc/webpage.html: $(doc_srcdir)/webpage.ms $(TMAC_PACKAGE_MS)
$(GROFF_V)$(MKDIR_P) $(doc_builddir) \
&& cd $(doc_builddir) \
&& $(DOC_GROFF) -t -I $(doc_srcdir) -I $(doc_builddir) \
-P-jwebpage -P-nrb -P-Iwebpage -P-Dimg -Thtml -ms \
$(doc_srcdir)/webpage.ms > webpage.html.tmp
$(AM_V_at)mv [email protected] $@
...and what this "comment above"?...
# XXX: We have to change directories into `doc_builddir` because
# pre-grohtml assumes that the argument to post-grohtml's `-D` option is
# a file specification resolvable relative to HTML "<img src=...>"
# elements, which is inflexible, and prevents us from writing to
# "[email protected]".
...
# maintainer mode targets
$(DOC_GNU_EPS): doc/gnu.xpm
$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
&& if test "$(XPMTOPPM)" != found; then \
echo "program 'xpmtoppm' is missing; can't generate $@" >&2; \
exit 1; \
fi; \
if test "$(pnmtops)" != found; then \
echo "program 'pnmtops' is missing; can't generate $@" >&2; \
exit 1; \
fi; \
if ! echo "$(pnmtops_nosetpage)" | grep -q nosetpage; then \
echo "program 'pnmtops' can't handle -nosetpage option;" \
"can't generate $@" >&2; \
exit 1; \
fi; \
xpmtoppm $(top_srcdir)/doc/gnu.xpm | pnmdepth 15 \
| $(pnmtops_nosetpage) -noturn -rle >$@
$(DOC_GNU_PNG): doc/gnu.xpm
$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
&& if test "$(XPMTOPPM)" != found; then \
echo "program 'xpmtoppm' is missing; can't generate $@" >&2; \
exit 1; \
fi; \
if test "$(pnmtops)" != found; then \
echo "program 'pnmtops' is missing; can't generate $@" >&2; \
exit 1; \
fi; \
if ! echo "$(pnmtops_nosetpage)" | grep -q nosetpage; then \
echo "program 'pnmtops' can't handle -nosetpage option;" \
"can't generate $@" >&2; \
exit 1; \
fi; \
xpmtoppm $(top_srcdir)/doc/gnu.xpm | pnmtopng >$@
> Offhand I'm not sure why this is. Whatever tools have successfully
> built gnu.eps in past groff builds should still be available: nothing
> has been removed from the system. So it smells like a faulty
> dependency graph: that "make" didn't realize it needed to perform some
> other step before trying to process webpage.ms.
Every relevant node in the graph should be covered in the "verbatim"
section above. I can't spot a problem. Can you?
If you can't, you might try manually specifying files as make targets to
see if something blows up.
make doc/gnu.xpm
make doc/gnu.eps
make doc/gnu.png
make doc/webpage.html
I'm unable to reproduce this problem with either in-tree or out-of-tree
builds.
_______________________________________________________
Reply to this item at:
<https://savannah.gnu.org/bugs/?68525>
_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/
signature.asc
Description: PGP signature
