This is really rather nice :)

	Would it be possible to use something like this on the NetBSD
	website?

	Some misc thoughts...
		Indexing all the man pages in /usr/src.
		Installing the formatted pages into $DESTDIR/...
		Making #include statements links to include files.


                David/abs               abs@anim.dreamworks.com

    		       - 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 
>   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
>