Hi Ryan,

As far as I can tell I'm following the Haddock formatting just fine. I'm using bird tracks for my code block and according to the Haddock manual those code blocks are interpreted literally without any additional markup.  To me that suggests that I should be able to write just about anything in these code blocks. But that's evidently not so.

The documentation for the lens package is indeed impressive. But it doesn't help me with my particular conundrum of the curly braces.

Thanks,

Josef

On Mon, Feb 4, 2013 at 2:01 PM, Ryan Yates <fryguybob@gmail.com> wrote:
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@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@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe