Subject: NetBSD C library source and documentation in hypertext (HTML) format.
To: None <current-users@NetBSD.ORG>
From: Tomi Ollila <firstname.lastname@example.org>
Date: 04/30/1997 11:38:21
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
Source files patched (named original + `.html') to contain hypertext
cross-reference links/info, put into comments so the files are still
Other stuff I don't remember now ;)
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: