[Haskell-cafe] Problems with code blocks in the description field in a .cabal file

Ryan Yates fryguybob at gmail.com
Mon Feb 4 14:01:48 CET 2013


Hi Josef,

You should be fine if you follow Haddock formatting.  For example:

http://hackage.haskell.org/package/lens

Is from the cabal file:

http://hackage.haskell.org/packages/archive/lens/3.8.5/lens.cabal


Ryan


On Mon, Feb 4, 2013 at 7:30 AM, Josef Svenningsson <
josef.svenningsson at gmail.com> wrote:

> Hi,
>
> I'm putting together a cabal package and I'd like to have some code
> examples in my description file. In particular I would like to have a code
> block containing markdown containing a code block of Haskell, like this:
>
> > ~~~{ .haskell }
> > module Main where
> >
> > main = putStrLn "Hello World!"
> > ~~~
>
> When I put the above code in my .cabal file and do `cabal haddock
> --executables` I get the following error:
>
> haddock: failed to parse haddock prologue from file:
> dist/doc/html/codeExtract/codeExtract/haddock-prolog31969.txt
>
> In general I can provoke the parse error from haddock whenever I have
> something inside curly braces.
>
> So the error seems to stem from haddock. I've tried to track down what
> happens inside haddock but I've run out steam. I'd like to know if there is
> anything I can do to be able to write something like the above as part of
> the description in my .cabal file.
>
> Thanks,
>
> Josef
>
> _______________________________________________
> Haskell-Cafe mailing list
> Haskell-Cafe at haskell.org
> http://www.haskell.org/mailman/listinfo/haskell-cafe
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.haskell.org/pipermail/haskell-cafe/attachments/20130204/a4c2cd69/attachment.htm>


More information about the Haskell-Cafe mailing list