Cabal documentation

[Ben Millwood]

On Sat, Mar 09, 2013 at 09:09:12AM +0000, C W Rose wrote:
>The current Cabal package documentation is in some form of markup language,
>and I'd like to convert that to HTML.  I suspect that Haddock is the
>preferred approach, but Haddock doesn't seem to recognise the file format.
>Is there anyway, short of hand editing, to convert these files (which have
>a .markup extension) to HTML?  Just building the package doesn't work.
>
>Thanks - Will

Do you perhaps mean .markdown? If so, you're probably talking about the 
User's Guide, and the files you refer to are meant to be compiled with 
Pandoc (http://johnmacfarlane.net/pandoc/ or cabal install pandoc), to 
HTML or PDF or any of the impressive range of output formats it 
supports.

The Makefile knows what commands to run: try 'make users-guide'.

There are also Haddock docs which can be built using 'cabal haddock' 
from the source directory.

It would be nice, IMO (I have no authority in the matter) if just 
building the package did build the docs too, but no-one's done the work 
yet. See also https://github.com/haskell/cabal/issues/1171

Hope this helps.

Regards,
Ben

(re-sent because I forgot to reply from the correct address the first 
time, and so Mailman rejected my first attempt).