From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp-2.sys.kth.se (smtp-2.sys.kth.se [130.237.32.160]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id oBONLFCw001556 for ; Fri, 24 Dec 2010 18:21:16 -0500 (EST) Received: from smtp-2.sys.kth.se (localhost [127.0.0.1]) by smtp-2.sys.kth.se (Postfix) with ESMTP id D13E114C223 for ; Sat, 25 Dec 2010 00:21:09 +0100 (CET) X-Virus-Scanned: by amavisd-new at kth.se Received: from smtp-2.sys.kth.se ([127.0.0.1]) by smtp-2.sys.kth.se (smtp-2.sys.kth.se [127.0.0.1]) (amavisd-new, port 10024) with LMTP id JCtx9gpdOl2E for ; Sat, 25 Dec 2010 00:20:58 +0100 (CET) X-KTH-Auth: kristaps [46.109.54.191] X-KTH-mail-from: kristaps@bsd.lv X-KTH-rcpt-to: discuss@mdocml.bsd.lv Received: from macky.local (unknown [46.109.54.191]) by smtp-2.sys.kth.se (Postfix) with ESMTP id C732C14C133 for ; Sat, 25 Dec 2010 00:20:56 +0100 (CET) Message-ID: <4D152AD8.9040300@bsd.lv> Date: Sat, 25 Dec 2010 01:20:56 +0200 From: Kristaps Dzonsons User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv:1.9.2.12) Gecko/20101027 Thunderbird/3.1.6 X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 To: discuss@mdocml.bsd.lv Subject: Re: mandoc -Thtml cleanup References: <201012222235.oBMMZ5ZA025569@cvs.openbsd.org> <20101222225049.GE1480@hera.home> <20101223202724.GA8744@iris.usta.de> <4D14B277.6070204@bsd.lv> <4d14e976.0aeb640a.6fa9.ffffb4b9@mx.google.com> In-Reply-To: <4d14e976.0aeb640a.6fa9.ffffb4b9@mx.google.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Anthony, > I'm really happy to see the improved HTML output of mandoc. It really > looks great compared to the
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