[bug #68525] doc/webpage.html build failure

"G. Branden Robinson" <[email protected]> Wed, 15 Jul 2026 13:59:51 -0400 (EDT)
Newsgroups	gmane.comp.printing.groff.bugs
Message-ID	<[email protected]>
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 (application/pgp-signature, 228 B)