On 24.07.2011 13:11, Joris Putcuyps wrote:
On Sat, 23 Jul 2011 19:25:53 -0700
Greg Weber<[email protected]>  wrote:

[1] http://hackage.haskell.org/package/hamlet

The cabal file should be compact, and quite often the
description field is very lengthy.
I would like it alot if I could reference a README.??? (pandoc
compatible extension) from cabal. Then it would be compatible with
github and give me more information in my haddock html pages which
were generated by `cabal haddock`.

To this end I sometimes wrote a dummy module containing more documentation. In the Cabal description file I refer to this module with a quotation like "Module". This way, I can even organize the documentation in chapters. I added DEPRECATED pragmas to these modules, in order to prevent people from importing them.

_______________________________________________
Haskell-Cafe mailing list
[email protected]
http://www.haskell.org/mailman/listinfo/haskell-cafe

Reply via email to