Re: mandoc HTML output: minor issues

["Anthony J. Bentley" <anthony@anjbe.name>]

Hi Jackson,

Jackson Pauls writes:
> 1. Duplicate IDs (invalid HTML). E.g. dash.1 gets two elements with
> id="HISTSIZE":

Indeed a problem with mandoc(1), which should not generate duplicate IDs
in HTML output.

> 2. Broken in-page links. E.g. in dash.1, there is an <h2> with
> id="White_Space_Splitting_(Field_Splitting)", but the link to that
> heading is missing the bit in parentheses
> (href="#White_Space_Splitting"):

This is a problem with the manual; if it names a section it should
refer to the section by that name.

> 3. In babel.1, for the -: flag, the colon appears outside the .Fl element:
> ...
>  21 .Op Fl i Ar input-type | Fl : Qo Ar SMILES-string Qc

Problem with the manual.
Should be Op Fl i Ar input-type | Fl \&: Qo Ar SMILES-string Qc

> 4. Running v.Nu (https://validator.github.io/validator/) on a
> collection of HTML files generated by mandoc picks up duplicate IDs,
> and a bunch of other issues:
> * unescaped characters in href attributes (%, "),
> * unescaped characters in URL fragments (\, {, }, #, ^, [, ], <, |),
> * <div>s appearing inside <pre>s, and
> * mismatches between column count in <colgroup> and table rows.
> I can gather a bunch of examples if of interest.

Please do. mandoc(1) could use some improvement when it comes to
producing valid HTML.

-- 
Anthony J. Bentley
--
 To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv