From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-io0-f176.google.com (mail-io0-f176.google.com [209.85.223.176]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id 4a9d4460 for ; Tue, 29 Aug 2017 03:47:15 -0500 (EST) Received: by mail-io0-f176.google.com with SMTP id k22so15173879iod.2 for ; Tue, 29 Aug 2017 01:47:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cathet-us.20150623.gappssmtp.com; s=20150623; h=sender:from:to:subject:in-reply-to:references:comments:mime-version :content-id:date:message-id; bh=jk7Dn+bdnZoPjStlce8wFJscHFx4sAUqHDuv2dLY4oE=; b=O2sL8THNcx4V+iJ8TCz/RtKFnb6oENQAQA0rwKXOt6e4Ui0Mony1zMyjy65c09YLr+ kEATqJ70avKAC5Fq9y1mt3YjuEvVxiwKIUVvFnyMOM0jtFCkJ01IHo9wFugUkBlFl8TF 3QDF3DvuGrV8hwk23WTtCKuPuscfHP0sNIgwDIhi5GGp/pPdSB0B4GEF+Lw1rw07wtOl AIf3VYDlYlEqGg2AIZSmZ1L2/7N70p6WnnvozSY0j/7YWUHP1Xd6oxfNHtWA/2OOI8Sj x57cBe8cUkCLBSaTVyQ0f7Go7C8yn2h7pXlIp20H916q5WNK8KuAJH0/s1rjH+WBUTcT V8Jg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:subject:in-reply-to:references :comments:mime-version:content-id:date:message-id; bh=jk7Dn+bdnZoPjStlce8wFJscHFx4sAUqHDuv2dLY4oE=; b=M3EPXXuF+prl7ATCzcwFr5++LiimEb8HCpyYxdvk/PQYNaZOnasm5i795m9PyuIFIl txTbT/d0CfuXYN/ZQ6YKjfzVDPhO7orvoM1eYhYzOiWDUhxqNCRCk+OqxkO+oY/FXjcn 4vU4FtsYNibYQ8uX40Yh8j8NiiZazXVy0Pf+jTt4yCQc5FTzdF2RNCqMTkQzwAvKMorV ssM5FvqPVaGFO9e/TR+A8WJrVeHETI9D52vsDP1FpVI3unZTdlnnfUZYdefTwh2Yc1j2 Pdo3Re4MwPTvqknmWL10rLh4pyQZmXJ3KrMWn9kpmCeZZiS2hTgeqHyjXFunTKw9coxA 5ZPw== X-Gm-Message-State: AHYfb5gT5nrFprM2IAi1sSYdwULf8wXpV5qb7oj2rXzHzewxH6eDH7DD ynUlAPOe/55aiBGkY/U= X-Received: by 10.107.170.74 with SMTP id t71mr1812393ioe.327.1503996433907; Tue, 29 Aug 2017 01:47:13 -0700 (PDT) Received: from cathet.us. (67-0-42-237.albq.qwest.net. [67.0.42.237]) by smtp.gmail.com with ESMTPSA id z72sm1128372ioz.13.2017.08.29.01.47.12 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 29 Aug 2017 01:47:13 -0700 (PDT) Sender: "Anthony J. Bentley" Received: from cathet.us (localhost [127.0.0.1]) by cathet.us. (OpenSMTPD) with ESMTP id 204bdfd5 for ; Tue, 29 Aug 2017 02:47:12 -0600 (MDT) From: "Anthony J. Bentley" To: discuss@mandoc.bsd.lv Subject: Re: mandoc HTML output: minor issues In-reply-to: References: Comments: In-reply-to Jackson Pauls message dated "Fri, 25 Aug 2017 10:52:58 +0100." X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <92452.1503996432.1@cathet.us> Date: Tue, 29 Aug 2017 02:47:12 -0600 Message-ID: <17497.1503996432@cathet.us> 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

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 (\, {, }, #, ^, [, ], <, |), > *
s appearing inside
s, and
> * mismatches between column count in  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