Re: [Haskell-cafe] Monospace code in Haddock

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