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