Re: mandoc -Thtml cleanup

[Kristaps Dzonsons <kristaps@bsd.lv>]

Anthony,

> I'm really happy to see the improved HTML output of mandoc. It really
> looks great compared to the<div>  output from before.
>
> I notice there's a redundant 'font-family: monospace;' declaration in
> style.css that is immediately overwritten with 'font-family: Times, serif;':
> http://mdocml.bsd.lv/cgi-bin/cvsweb/style.css?rev=1.19&content-type=text/x-cvsweb-markup&cvsroot=mdocml

Fixed, thanks!

>> example, to tag function prototypes and utility syntaxes in the SYNOPSIS
>> section with an A NAME, then link up to them from within the document
>
> FYI, A NAME and A ID are more-or-less interchangeable, and you might want
> to use ID for consistency since mandoc uses IDs elsewhere. Or not, since
> there's almost no difference between the two.
>
> http://www.w3.org/TR/html401/struct/links.html#h-12.2.3

This page is quite useful.  I'll get some of this integrated to avoid 
superfluous tags (using IDs instead of NAMEs).

>> There's
>> always that Table of Contents, which man.cgi generates but we don't...
>
> There are some link types that may be useful semantically for this kind
> of thing:
>
> http://www.w3.org/TR/html401/types.html#type-links
> http://www.w3.org/TR/html401/struct/links.html#h-12.3

Those look really cool!  Unfortunately, I don't see Firefox (for one) 
actually using this data in any way---I could easily supply SECTION and 
SUBSECTION fragment href's instead of having some clunky TOC, but that 
doesn't get me anywhere if the links aren't listed.

> I do think it would be funny to see mdoc beat texinfo at its own game
> (namely, hyperlinking)! ;)

I don't know much about texinfo's "hyperlinking", but mdoc's semantic 
annotation makes a great deal possible (e.g., function names linking to 
the SYNOPSIS prototype, etc.).

Thanks again,

Kristaps
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv