From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-yi0-f49.google.com (mail-yi0-f49.google.com [209.85.218.49]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id oBOIg5it017929 for ; Fri, 24 Dec 2010 13:42:06 -0500 (EST) Received: by yib2 with SMTP id 2so1208238yib.36 for ; Fri, 24 Dec 2010 10:41:59 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:received:to :subject:in-reply-to:references:comments:date:from; bh=ohs3SUooOOECy9NqzUXqeKXSLtgV6/R8UEYngeYpjwQ=; b=dAlAF/dH+DGMCOhTFyuTWgGFJu5zgf5yaUHEi5Wj94dZDBu5VCgAvJvc2hCmjh7wJT M3vd2FY9aZTVCXwdqxAH5ZNofRWOKbR7AkraNJme5U/BrWNCPpbJqB4GjO8FEL2f4aSU aYe/1RWd1XQE7SXfmTbQ07KCb1p+U3uPWmjI4= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:to:subject:in-reply-to:references:comments:date:from; b=JeYaaYJrymGsmZlD41xA7clNzVSQ1W9RTRC/8zerhp5acNgOHIpIxhXNFNHjZZUKsK A16O4WMgPBqA8B7SPiw/1D43ly4+8mGbJ+5XbXyu0JhWcuyzdLeNznB0uW2Lix4DDU79 5hKfX8q1II91NNh1oNe+XkNLAVNGdtKn4S2nQ= Received: by 10.100.46.7 with SMTP id t7mr5837795ant.174.1293216119510; Fri, 24 Dec 2010 10:41:59 -0800 (PST) Received: from pinetree.gateway.2wire.net (97-119-170-153.albq.qwest.net [97.119.170.153]) by mx.google.com with ESMTPS id i10sm14100572anh.12.2010.12.24.10.41.57 (version=TLSv1/SSLv3 cipher=OTHER); Fri, 24 Dec 2010 10:41:58 -0800 (PST) Message-ID: <4d14e976.0aeb640a.6fa9.ffffb4b9@mx.google.com> Received: from pinetree.gateway.2wire.net (localhost [127.0.0.1]) by pinetree.gateway.2wire.net (OpenSMTPD) with ESMTP id 1293216114.exgjADYdiUkXGjYI for ; Fri, 24 Dec 2010 11:41:54 -0700 (MST) To: discuss@mdocml.bsd.lv Subject: Re: mandoc -Thtml cleanup In-reply-to: <4D14B277.6070204@bsd.lv> References: <201012222235.oBMMZ5ZA025569@cvs.openbsd.org> <20101222225049.GE1480@hera.home> <20101223202724.GA8744@iris.usta.de> <4D14B277.6070204@bsd.lv> Comments: In-reply-to Kristaps Dzonsons message dated "Fri, 24 Dec 2010 16:47:19 +0200." Date: Fri, 24 Dec 2010 11:41:54 -0700 From: "Anthony J. Bentley" X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv Hi Kristaps, 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 > 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 > 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 I do think it would be funny to see mdoc beat texinfo at its own game (namely, hyperlinking)! ;) -- Thanks, Anthony J. Bentley -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv