Date: 08 May 1997 14:29:59 +0200 From: Wolfram Schneider <wosch@apfel.de> To: doc@freebsd.org Subject: [Tomi Ollila <too@ajk.tele.fi>] NetBSD C library source and documentation in hypertext (HTML) format. Message-ID: <p1irafi1708.fsf@campa.panke.de>
next in thread | raw e-mail | index | archive | help
------- Start of forwarded message ------- Message-Id: <199704300838.LAA00837@smtp.th.tele.fi> Date: Wed, 30 Apr 1997 11:38:21 +0300 From: Tomi Ollila <too@ajk.tele.fi> Reply-To: <too@ajk.tele.fi> 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 -------
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?p1irafi1708.fsf>