Hi Justina,

justina colmena wrote on Thu, May 24, 2018 at 05:54:45PM +0000:

> On Wed, 23 May 2018 11:47:47 +0200
> Marko Cupać <marko.cu...@mimar.rs> wrote:

>> I am sure OpenBSD will correct their errors in html/css code, if any,

> Right now, https://man.openbsd.org/relayd.conf.5 fails html validation.
> https://validator.w3.org/nu/?doc=https%3A%2F%2Fman.openbsd.org%2Frelayd.conf.5
> There are several html <code> elements with duplicate IDs.

Sure, that's on the TODO list:

  http://mandoc.bsd.lv/cgi-bin/cvsweb/TODO?rev=HEAD

--- HTML issues --------------------------------------------------------

- duplicate names generate duplicate href="#..." anchor attributes
  possibly use "#..._<N>" suffixes?
  Jakub Klinkovsky <j dot l dot k at gmx dot com> 3 Oct 2017 21:23:36 +0200
  see also the thread: gre(4): Rename duplicate sections
  up to 20 Apr 2018 15:27:33 +0200
  loc *  exist *  algo *  size *  imp ***

It's not the worst HTML syntax violation left in mandoc,
and it's among the easier ones to fix.

Actually, just skipping dupes may be better than suffixes because
permalinks with suffixes don't make much sense.  As soon as someone
inserts or deletes text, subsequent permalink anchors with suffixes
might suddenly point to different places, ehich defeats the very
purpose of permalinks.

Besides, the main virtue of mandoc permalinks is their simplicity,
allowing people to type them by hand without even looking at the
manual page first.  I just know that

  https://man.openbsd.org/cat#v

will work (and is harmful), without even testing it first.
Appending suffixes would compromise that virtue.

Yours,
  Ingo

Reply via email to