[Haskell-cafe] Monospace code in Haddock

[Niklas Hambüchen]

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 @\<span\>hello\</span\>@
>>
>> 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
>