[bug #60637] [man] HTML rendering of multiple documents doesn't make much sense

[G. Branden Robinson]

Update of bug #60637 (project groff):

                  Status:                    None => Postponed              
                 Summary: [PATCH] [man] HTML rendering of multiple documents
doesn't make much sense => [man] HTML rendering of multiple documents doesn't
make much sense

    _______________________________________________________

Follow-up Comment #3:

Thanks, Dave.

Unfortunately life still sucks.

I tried an updated version of the patch, along with something ambitious to
exercise it.


diff --git a/doc/doc.am b/doc/doc.am
index 806058d9e..7dd553e0c 100644
--- a/doc/doc.am
+++ b/doc/doc.am
@@ -59,7 +59,8 @@ GENERATEDDOCFILES = \
 # Files generated in the build tree
 if USE_GROHTML
 PROCESSEDDOCFILES_HTML = \
-  doc/pic.html
+  doc/pic.html \
+  doc/groff-man-pages.html
 endif
 if USE_GROPDF
 PROCESSEDDOCFILES_PDF = \
@@ -251,6 +252,12 @@ man-clean:
        $(RM) $(GROFF_MAN_PAGES_ALL)
 
 # Many pages use tbl, a few use eqn, and soelim(1) uses pic.
+doc/groff-man-pages.html: $(GROFF_MAN_PAGES_ALL) eqn pic tbl
+       $(GROFF_V)$(DOC_GROFF) -pet -Thtml -mandoc -rC1 \
+         -rCHECKSTYLE=3 $(GROFF_MAN_PAGES1) \
+         $(tmac_srcdir)/sv.tmac $(GROFF_MAN_PAGES2) \
+         $(tmac_srcdir)/en.tmac $(GROFF_MAN_PAGES3) > $@
+
 doc/groff-man-pages.pdf: $(GROFF_MAN_PAGES_ALL) eqn pic tbl
        $(GROFF_V)$(DOC_GROFF) -pet -Tpdf -P-e -mandoc -rC1 \
          -rCHECKSTYLE=3 $(GROFF_MAN_PAGES1) \
diff --git a/tmac/an.tmac b/tmac/an.tmac
index 88b25163f..41170fdbb 100644
--- a/tmac/an.tmac
+++ b/tmac/an.tmac
@@ -210,6 +210,8 @@
 .  if !\\n[an-is-first-page-of-document] \{\
 .    ie \\n[cR] .an-end
 .    el         .an-start-new-document
+.    if \\n[an-is-output-html] \
+.      ab \\*[an]: fatal error: cannot render multiple documents to HTML
 .    nr an-is-first-page-of-document 1
 .  \}
 .


The results?


$ make doc/groff-man-pages.html
  GROFF    doc/groff-man-pages.html
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':658:
macro 'an-break-paragraph'
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':666:
macro 'SH'
troff: backtrace: file './src/devices/grolbp/grolbp.1':261
troff:./src/devices/grolbp/grolbp.1:261: error: suppression limit registers
span more than a page; grohtml-info for image 8 will be wrong
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':974:
macro 'RE'
troff: backtrace: file './src/preproc/tbl/tbl.1':1765
troff:./src/preproc/tbl/tbl.1:1765: error: suppression limit registers span
more than a page; grohtml-info for image 12 will be wrong
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':658:
macro 'an-break-paragraph'
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':751:
macro 'P'
troff: backtrace: file './man/groff.7':817
troff:./man/groff.7:817: error: suppression limit registers span more than a
page; grohtml-info for image 16 will be wrong
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':658:
macro 'an-break-paragraph'
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':693:
macro 'SS'
troff: backtrace: file './man/groff_char.7':597
troff:./man/groff_char.7:597: error: suppression limit registers span more
than a page; grohtml-info for image 22 will be wrong
troff: backtrace: file './man/groff_char.7':1010
troff:./man/groff_char.7:1010: warning: special character '.j' not defined
troff: backtrace: file './man/groff_char.7':1019
troff:./man/groff_char.7:1019: error: suppression limit registers span more
than a page; grohtml-info for image 24 will be wrong
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':658:
macro 'an-break-paragraph'
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':693:
macro 'SS'
troff: backtrace: file './man/groff_char.7':1187
troff:./man/groff_char.7:1187: error: suppression limit registers span more
than a page; grohtml-info for image 27 will be wrong
troff: backtrace: file './man/groff_char.7':1407
troff:./man/groff_char.7:1407: error: suppression limit registers span more
than a page; grohtml-info for image 30 will be wrong
troff: backtrace: file './man/groff_char.7':1430
troff:./man/groff_char.7:1430: warning: special character 'vA' not defined
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':658:
macro 'an-break-paragraph'
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':693:
macro 'SS'
troff: backtrace: file './man/groff_char.7':1540
troff:./man/groff_char.7:1540: error: suppression limit registers span more
than a page; grohtml-info for image 33 will be wrong
troff: backtrace: file './man/groff_char.7':1559
troff:./man/groff_char.7:1559: warning: special character 'bs' not defined
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':658:
macro 'an-break-paragraph'
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':693:
macro 'SS'
troff: backtrace: file './man/groff_char.7':1650
troff:./man/groff_char.7:1650: error: suppression limit registers span more
than a page; grohtml-info for image 37 will be wrong
troff: backtrace: file './man/groff_char.7':1730
troff:./man/groff_char.7:1730: warning: special character '-+' not defined
troff: backtrace: file './man/groff_char.7':1779
troff:./man/groff_char.7:1779: warning: special character 'coproduct' not
defined
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':658:
macro 'an-break-paragraph'
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':693:
macro 'SS'
troff: backtrace: file './man/groff_char.7':1805
troff:./man/groff_char.7:1805: error: suppression limit registers span more
than a page; grohtml-info for image 38 will be wrong
troff: backtrace: file './man/groff_char.7':1874
troff:./man/groff_char.7:1874: warning: special character '+e' not defined
troff: backtrace: file './man/groff_char.7':1882
troff:./man/groff_char.7:1882: error: suppression limit registers span more
than a page; grohtml-info for image 39 will be wrong
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':658:
macro 'an-break-paragraph'
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':779:
macro 'IP'
troff: backtrace: file './tmac/groff_man_style.7':1879
troff:./tmac/groff_man_style.7:1879: error: suppression limit registers span
more than a page; grohtml-info for image 82 will be wrong
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':658:
macro 'an-break-paragraph'
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':751:
macro 'P'
troff: backtrace: file './tmac/groff_me.7':170
troff:./tmac/groff_me.7:170: error: suppression limit registers span more than
a page; grohtml-info for image 92 will be wrong
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':658:
macro 'an-break-paragraph'
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':751:
macro 'P'
troff: backtrace: file './tmac/groff_me.7':332
troff:./tmac/groff_me.7:332: error: suppression limit registers span more than
a page; grohtml-info for image 93 will be wrong
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':974:
macro 'RE'
troff: backtrace: file './contrib/mm/groff_mm.7':1225
troff:./contrib/mm/groff_mm.7:1225: error: suppression limit registers span
more than a page; grohtml-info for image 104 will be wrong
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':974:
macro 'RE'
troff: backtrace: file './contrib/mm/groff_mm.7':2553
troff:./contrib/mm/groff_mm.7:2553: error: suppression limit registers span
more than a page; grohtml-info for image 112 will be wrong
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':974:
macro 'RE'
troff: backtrace: file './contrib/mm/groff_mm.7':4463
troff:./contrib/mm/groff_mm.7:4463: error: suppression limit registers span
more than a page; grohtml-info for image 128 will be wrong
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':658:
macro 'an-break-paragraph'
troff: backtrace: '/home/branden/src/GIT/groff/build/../tmac/an.tmac':666:
macro 'SH'
troff: backtrace: file './tmac/groff_ms.7':2734
troff:./tmac/groff_ms.7:2734: error: suppression limit registers span more
than a page; grohtml-info for image 139 will be wrong
an.tmac: fatal error: cannot render multiple documents to HTML


Except for the last line, all that spew is typical of rendering our man page
corpus as HTML.

No, the really sad part is this.


[all that crap above]
an.tmac: fatal error: cannot render multiple documents to HTML
$ echo $?
0


Something is *still* eating my god damn nonzero exit status.

And, no, bug #60782 really is fixed.


$ bash -x ../src/roff/groff/tests/ab_works.sh
[...]
+ for d in ascii cp1047 dvi html latin1 lbp lj4 pdf ps utf8
+ echo 'verifying exit status of .ab request using html device'
verifying exit status of .ab request using html device
+ printf '.ab\n'
+ ./test-groff -Thtml
pre-grohtml: fatal error: 'pre-grohtml' exited with status 1; re-run
'pre-grohtml' with a different output driver to see diagnostic messages
+ test 1 -eq 1


So this is blocked on some other bizarre bug.


    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?60637>

_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/