Hi,
this is merely for your information:
I just completed a major cleanup, started about one and a half weeks
ago, of both the mandoc(1) -Thtml code itself and the HTML code it
generates, both in multiple respects, and installed the new version
on man.openbsd.org. If you notice anything odd (other than the
fact that in tagged lists, the body always starts on the next line
even when the tag is short, which i still don't know how to fix),
please do tell me, i'm around to deal with any potential fallout.
If the casual user sees no difference, i'm content.
But you may want to configure your browser to show you the HTML
source code for man.openbsd.org in the future rather than the
rendered version, it's quite readable now and contains more
information than in the rendered form. =;c)
Enjoy,
Ingo
P.S.
Some highlights of what is new:
* major features
- HTML class attributes now use mdoc(7) macro names
- mandoc.css cleaned up and arranged in the same order
as the mdoc(7) manual MACRO OVERVIEW section
- HTML code is properly indented and broken into 80-character lines
for human readability (required some new code to implement)
* bugfixes
- no more static buffer that can get exhausted while
writing HTML attributes
- fixed horizontal alignment of headers and footers
- .No no longer produces <code> markup
- and a number of other markup fixes
* HTML code cleanup
- in various places, less elements are written
- less constant attributes are written, more is now done
in the style sheet
- no more abuse of <blockquote>
* C source code cleanup
- much simplified print_otag() internal interface, resulting
in a few hundred lines less code in *_html.c
- no more struct htmlpair, no more ugly PAIR_*() macros
- all text production now done in the validators,
none in the formatters, resulting in a better parse
tree and also in overall code reduction
$ cd /usr/src/usr.bin/mandoc
$ cvs diff -Nup -D 2017-01-07 -r HEAD > tmp.patch
$ grep -c '^-[^-]' tmp.patch
1861
$ grep -c '^+[^+]' tmp.patch
1701
$ wc tmp.patch
7194 28136 189307 tmp.patch
$ grep -c ^Index: tmp.patch
27
