From owner-freebsd-doc Thu May 8 05:31:50 1997 Return-Path: Received: (from root@localhost) by hub.freebsd.org (8.8.5/8.8.5) id FAA23937 for doc-outgoing; Thu, 8 May 1997 05:31:50 -0700 (PDT) Received: from bsd.fs.bauing.th-darmstadt.de (bsd.fs.bauing.th-darmstadt.de [130.83.63.241]) by hub.freebsd.org (8.8.5/8.8.5) with ESMTP id FAA23932 for ; Thu, 8 May 1997 05:31:48 -0700 (PDT) Received: from campa.panke.de (anonymous226.ppp.cs.tu-berlin.de [130.149.17.226]) by bsd.fs.bauing.th-darmstadt.de (8.8.5/8.8.5) with ESMTP id OAA26231 for ; Thu, 8 May 1997 14:31:16 +0200 (MET DST) Received: (from wosch@localhost) by campa.panke.de (8.8.5/8.6.12) id OAA02506; Thu, 8 May 1997 14:30:29 +0200 (MET DST) To: doc@freebsd.org Subject: [Tomi Ollila ] NetBSD C library source and documentation in hypertext (HTML) format. From: Wolfram Schneider Date: 08 May 1997 14:29:59 +0200 Message-ID: Lines: 51 Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk ------- Start of forwarded message ------- Message-Id: <199704300838.LAA00837@smtp.th.tele.fi> Date: Wed, 30 Apr 1997 11:38:21 +0300 From: Tomi Ollila Reply-To: To: current-users@netbsd.org Cc: too@ajk.tele.fi Subject: NetBSD C library source and documentation in hypertext (HTML) format. Hi all We have written tools to generate HTML pages from C source and [gtn]roff (andoc) formatted documents. The system has been implemented (and tested) to be used w/ C library stuff (src/lib/libc in source tree), but should work with other libraries as well. IHMO these tools does pretty good job. These pages include: Hypertext links from documentation to function implementation and vice versa. Source files patched (named original + `.html') to contain hypertext cross-reference links/info, put into comments so the files are still compilable. Other stuff I don't remember now ;) Known problems: Hypertext link generation does not check manual page numbers (i.e. sysctl(3) and sysctl(8) links points to the same page). this is easy to fix. mandoc2html.perl is a quick hack (this was a school assigment), and it was fun to create. It does only `andoc', not `an'. Some [gtn]roff wizard should take a look of it (take the useful parts to totally new parser). Anyway, even in this current state, the output is pretty good in most cases. I'd like to know if you encounter problems not mentioned here. Check out the whole application, with all tools included to regenerate it at: `http://www.ajk.tele.fi/libc' Tomi Ollila ------- End of forwarded message -------