haskell-cafe@haskell.org
[Top] [All Lists]

Re: [Haskell-cafe] "doctest" for haskell -- a good project?

Subject: Re: [Haskell-cafe] "doctest" for haskell -- a good project?
From: Roman Cheplyaka
Date: Sat, 22 Mar 2008 10:29:33 +0200
* Shaun Cutts <shaun@xxxxxxxxxxxxx> [2008-03-22 02:20:38-0400]
> Hello,
>  
> I am an experienced programmer, currently learning Haskell. Currently I
> write many things in python. I use both the "doctest" and "unittest" modules
> extensively. As I write code, I simultaneously write doctest code in the doc
> strings to explain/set out the "typical narrative" of how the code is used.
> Then finishing off a module I write unittests for boundary conditions, more
> complex test cases, and generally code that would be annoying to write &
> read in doctests.
>  
> I note that there is a unit testing framework for Haskell, but I don't see
> any doctest module. Might this be a good project?
>  
> If so, suggestions as to resources would be greatly appreciated. I believe I
> can't just "introspect" Haskell modules to get at documentation/comments,
> like I can in python? (Why not? :)) I notice that there are a few
> "documentation generators". Should I try to write an extension of one of
> these? Haddock, for instance? Are there any Haddock developers hanging out
> on this list, to encourage or dissuade me? :) (And where is the Haddock doc
> for Haddock?)
>  
> In any case, thanks in advance for any comments & advice.
>  
> - Shaun Cutts


Did you try haddock?

-- 
Roman I. Cheplyaka :: http://ro-che.info/
...being in love is totally punk rock...
_______________________________________________
Haskell-Cafe mailing list
Haskell-Cafe@xxxxxxxxxxx
http://www.haskell.org/mailman/listinfo/haskell-cafe
<Prev in Thread] Current Thread [Next in Thread>