Re: [Haskell-cafe] Monospace code in Haddock

You are right, if I escape as you describe, it works. However, all the makes it quite hard to read in code, and as people often read the code when dealing with Haskell, I will probably stick with the non-inline approach. That also gives a nice blue highlighting in haddocks in addition to the monospace. On 05/09/12 21:29, Simon Hengel wrote:

On Wed, Sep 05, 2012 at 09:11:47PM +0100, Niklas Hambüchen wrote:

...

When you write:

-- | This function returns the string @hello@

and you have a function called hello in scope, haddock will hyperlink the the above hello to that function, which is confusing if your monospace string has actually nothing to do with that function.

In other words: Haddock always links to your functions in inline monospaced text, and you can't turn that off.

-- | Gives you @\hello\@

will therefore link to functions 'span' and 'hello' if they exist.

As far as I know Haddock markup is interpreted withing @-blocks. So if you write @`foo`@ it will get linked, but if you just write @foo@ it should not be linked. If you write @\`foo`@ it should again not be linked. It may be awkward at times, but I think you should be able to achieve what you want, no?

Please give a self-contained minimal example that illustrates your issue, if this still does not help.

Cheers, Simon