Hi Reuben, Reuben ua Brig wrote on Sun, Jun 27, 2021 at 05:26:29PM +1000: > From: Stuart Henderson <[email protected]> >> Maybe not for man-pages-posix, it looks like embedded tbl(7) support >> is needed. mandoc doesn't do this, so they still need to be formatted >> with groff.
> cheers. will see what i can do. i have not noticed any problems with > the output of man so far (havent tried html etc.), All output modes are wqually broken because these are parsing issues rather than formatting issues. > and am not familiar with roff, so are have you noticed any problem > pages in particular? See my last mail to you, it contains some examples - not a full list though since even drafting a full list would cause significant work, of limited usefulness given how difficult it is to fix all that. If something is so difficult that there is no chance fixing it any time soon, spending lots of effort on describing all the problems in detail is a waste of time. > p.s. just tried MANPAGER=w3m man -T html 3p sigaction; and the table > for struct sigaction looks alright, though there are too many empty > lines in the C text under `Establishing a Signal Handler'. That's a relatively minor, purely HTML formatting issue that would definitely not stand in the way of using mandoc. In general, -Tascii and -Tutf8 output have a much higher quality and are much more important than HTML output (even though mandoc HTML output is vastly superior to groff HTML output, and lots of work was spent, and is being spent, on improving HTML output). What you are reporting here are valid concerns in the mandoc roff(7) to HTML formatter, which is among the youngest formatting modules. Using <br/> inside <pre> for .nf may be less than ideal, and representing .P inside .nf by closing and reopening the <pre> even less so. It's not completely trivial because it likely can't be solved in roff_html.c alone but the interactions with html.c and possibly man_html.c and maybe even mdoc_html.c need to be considered. So i added your report to the TODO file for now: - HTML formatting of .nf should avoid <br/> and not close and re-open <pre> on .P Reuben ua Brig 27 Jun 2021 17:26:29 +1000 loc ** exist ** algo * size * imp ** Thanks for the report, Ingo
