Hi Andrew,
On Wed, Jul 04, 2007 at 07:26:48PM +0100, Andrew Coppin wrote:
> >
> >Writing documentation for libraries is one way in which ordinary
> >Haskell users can really contribute to the Haskell community. It’s not
> >hard to do (grab the Darcs repo, type away), and it’s widely appreciated.
>
> How exactly do I get started?
>
> (Obviously I can't write the documentation for the monad transformers -
> I don't know how they work yet! But I could have a go at splicing all
> the Parsec goodness into the Haddoc pages...)
Get the latest source:
darcs get http://darcs.haskell.org/packages/parsec
cd parsec
Build the Cabal Setup program and configure the package:
ghc --make Setup
./Setup configure
Then actually update the documentation, in Text/ParserCombinators/...
Now run haddock:
./Setup haddock
and check that it looks reasonable. Open dist/doc/html/index.html in
your web browser and follow the relevant links.
It's probably also a good idea to check you haven't broken the code by
accident, i.e. test that it still builds:
./Setup build
If you are happy then record and send the patch:
darcs record
darcs send
If you think that the patch might be at all contentious then you should
follow the library submissions procedure instead of the last step:
http://www.haskell.org/haskellwiki/Library_submissions
but for just adding brief haddock docs that's probably overkill.
Thanks
Ian
_______________________________________________
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe
