[Haskell-cafe] File path programme

Keean Schupke k.schupke at imperial.ac.uk
Thu Jan 27 04:05:30 EST 2005


Georg Martius wrote:

> Hi,
>
> I think Isaac's idea is pretty nice, to have an easy way to add 
> documentation in a collaborative manner.
> I have the following in mind:
> A separate wiki which supports generating haddock documentation. 
> Ideally one would see the haddock documentation as it is and would 
> click to a function or type and change the comment for it. However, it 
> would also be enough to see the complete source-code and change the 
> comments there. The question is what happens if there is a parse 
> error. Furthermore there must be someone who maintains it in the sense 
> that changes are committed to cvs at some point and so on. 
> Additionally, it seams to be complicated to keep it synchronised with 
> "real" changes of the source code in the cvs.
> Probably the most simple, but less "wiki" solution is the do it the 
> traditional way. Just use cvs and a normal text editor and ask for a 
> cvs account :-).

Or, you could set the website to check out the code from CVS and use 
tex2html (assuming the comments are put in literate programming style) 
to generate the page.

    Keean.



More information about the Haskell-Cafe mailing list