IDoc extracts interface documentation and declarations from Haskell modules based on standard Haskell layout rules and a small number of clues that the programmer embeds in interface comments. These clues have been designed to be visually non-imposing when displaying the source in a text editor. Interface documentation is rendered in standard markup languages (currently, only HTML is supported). IDoc has been designed to be simple to use and install.
You may want to have a look at a (somewhat silly) example of an IDoc-generated interface document. It
was generated from Foo.hs.
The latest news:
IDoc is written in plain Haskell 98, and thus, should work with any standards conforming Haskell system.
All features that were planned during initial system design are
implemented. The system has, however, only been tested lightly so far.
1These binaries are for glibc2.2-based Linux
systems (they were built on a Red Hat 7.2 system).
For those living on the bleeding edge of development, get the latest
IDoc code per anonymous CVS. Here is how it works (your input
is in bold face; the password will, of course, not be echoed):
From here on it is like a normal install; just follow the instructions
in
You may like to have a look at the IDoc online
documentation.
If you have any comments, suggestions, or a bug report, please let me know. Code contributions are
of course also welcome. If you send me patches, please send me context
diffs relative to the latest version in CVS or, if
you don't have CVS access, relative to the last release. If you feel
unsure about how to do this, just send me an email.
The code is released under the GNU General Public
Licence (GPL). This means that you can basically do with it what
you want as long as you contribute improvements to the tool itself
back to the community. Any documentation that you generate with the
tool is, however, free from any license restrictions from my side. The
situation is the same as with, say, the GNU C Compiler (gcc).
Last modified: Fri May 14 17:01:52 EST 2004
Releases
idoc-0.2.6
[
tar.gz
|
i386.rpm
|
src.rpm
|
i386.deb
|
i386-unknown-linux.tar.gz
]idoc-0.2.5
[
tar.gz
|
i386.rpm
|
src.rpm
|
i386.deb
|
i386-unknown-linux.tar.gz
]
Anonymous CVS
% cvs -d :pserver:anonymous@ceres.cse.unsw.edu.au:/home/chakcvs/cvs login
(Logging in to anonymous@ceres.cse.unsw.edu.au)
CVS password: anonymous
% cvs -d :pserver:anonymous@ceres.cse.unsw.edu.au:/home/chakcvs/cvs checkout idoc
list of checked out files
README.
Documentation
Feedback
License
This page is part of Manuel Chakravarty's
WWW-stuff.