Subject: Re: NetBSD C library source and documentation in hypertext (HTML) format.
To: Tomi Ollila <email@example.com>
From: David Brownlee <firstname.lastname@example.org>
Date: 04/30/1997 18:18:02
This is really rather nice :)
Would it be possible to use something like this on the NetBSD
Some misc thoughts...
Indexing all the man pages in /usr/src.
Installing the formatted pages into $DESTDIR/...
Making #include statements links to include files.
- Oakwood apartments -
- $1300 a month and people steal your laundry - What a place -
On Wed, 30 Apr 1997, Tomi Ollila wrote:
> 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
> 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:
> Tomi Ollila