Re: Sx quoting and Header

[Ingo Schwarze <schwarze@usta.de>]

Hi Kristaps,

Kristaps Dzonsons wrote on Mon, Dec 27, 2010 at 02:04:09AM +0200:

> To assuage the trauma of dealing with -T[x]html, I've a patch on hand

OK, so i'm not committing.

> that stashes the mdoc_validate.c concatenated `Sh' string (see
> post_sh()) into a mdoc_sh structure.  This buffer is then pumped
> right into html_idcat(), removing all those stupid loops over
> children.
> 
> The neat part about this is that, if I add a sorted list among
> these, I can do the same in `Sx' and add a check that makes sure
> `Sx' links actually go somewhere AND that sections/subsections/etc.
> aren't duplicates.  It's only little bits of code, but since this
> isn't checked by nroff, I'll post it here for a relevancy check
> before it goes in.

I think that plan does make sense.
Of course, all this should only cause warnings, not errors.

Not sure whether a duplicate section or subsection, or a subsection
with the same name as a section, warrants a warning, though.
I guess a warning is only needed when a reference is ambiguous.
Thus, the list nodes should probably contain a flag with the values
OK, DUPE, WARNED, and when a DUPE gets referenced, a warning should
be issued and the flag advanced to WARNED.

> Note, if I haven't ever explained myself, that the hex encoding is
> just to get around the fact that IDs are case-insensitive, while
> -mdoc is case-sensitive (NAME != name)...

Hm.  In mdoc(7), it could actually happen that we might get
both a `ds' and a `Ds' section.  So yes, properly dealing with
case appears to be relevant.

Yours,
  Ingo
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv