From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp-1.sys.kth.se (smtp-1.sys.kth.se [130.237.32.175]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id p43FNQ1i016990 for ; Tue, 3 May 2011 11:23:26 -0400 (EDT) Received: from mailscan-1.sys.kth.se (mailscan-1.sys.kth.se [130.237.32.91]) by smtp-1.sys.kth.se (Postfix) with ESMTP id 5CB21154134 for ; Tue, 3 May 2011 17:23:20 +0200 (CEST) X-Virus-Scanned: by amavisd-new at kth.se Received: from smtp-1.sys.kth.se ([130.237.32.175]) by mailscan-1.sys.kth.se (mailscan-1.sys.kth.se [130.237.32.91]) (amavisd-new, port 10024) with LMTP id CNA0+IJKSzXC for ; Tue, 3 May 2011 17:23:18 +0200 (CEST) X-KTH-Auth: kristaps [193.10.49.5] X-KTH-mail-from: kristaps@bsd.lv X-KTH-rcpt-to: discuss@mdocml.bsd.lv Received: from [172.16.18.84] (unknown [193.10.49.5]) by smtp-1.sys.kth.se (Postfix) with ESMTP id 71B7A154129 for ; Tue, 3 May 2011 17:23:16 +0200 (CEST) Message-ID: <4DC01DE4.7030203@bsd.lv> Date: Tue, 03 May 2011 17:23:16 +0200 From: Kristaps Dzonsons User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.16) Gecko/20110303 Icedove/3.0.11 X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 To: discuss@mdocml.bsd.lv Subject: Update: mandoc-cgi Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Hi, This is the last note about mandoc-cgi to this list: if you have comments about it, please let me know as soon as possible! I'll be putting it aside except for little tweaks before BSDCan. But I'll be happy to hack in any neat suggestions. So if you haven't heard, mandoc-cgi pushes the "MDOC IS SEMANTIC!" line by actually mining for data in manuals. To the best of my knowledge, it's the only utility that takes advantage of semantic UNIX manual content. ("Apropos" doesn't count.) For example... Which manuals reference the POSIX real-time extension? http://mdocml.bsd.lv/cgi-bin/mandoc.cgi?key=1003.1b Which manuals list deraadt@ as an author? http://mdocml.bsd.lv/cgi-bin/mandoc.cgi?key=de+raadt Which manuals list "stdlib.h" as an includes, sorted by title? http://mdocml.bsd.lv/cgi-bin/mandoc.cgi?key=stdlib.h&sort=mtitle Where can you find the "opterr" variable documented? http://mdocml.bsd.lv/cgi-bin/mandoc.cgi?key=opterr Anyway, the CGI is generic (uses templating for its output) and thus has its own project page. See http://mdocml.bsd.lv/mandoc-cgi/index.html for a list of its goodies. For example, you can search using UTF-8 strings, sort output by relevance/title/etc., use a text-based browser (this was very important), and so on. I've focussed on the CGI aspect, but of course, this can easily be changed around to be a CLI application, a GNOME-browser plugin for manuals, or whatever. I'm remarkably unimaginative in this regard, so speak up (with code, preferrably) if you've suggestions. I do, however, foresee mandoc-db mining for more and more data, which of course would be searchable via mandoc-cgi. Thanks, Kristaps P.S., note that mandoc-cgi uses the CVS version of mandoc for its stuff, so if you want to play with it on your own and you don't have CVS access, let me know. -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv