[PATCH] Haddockify some comments in compiler/hsSyn/HsBinds.lhs

Ian Lynagh ian at well-typed.com
Sat Jul 13 17:26:58 CEST 2013

Hi Mateusz,

On Thu, Jun 06, 2013 at 11:31:47PM +0100, Mateusz Kowalczyk wrote:
> I have turned some comments in compiler/hsSyn/HsBinds.lhs into Haddock
> format. They were just sitting there, hidden from the world (to spite
> anyone scratching their heads when looking through the generated docs,
> like myself). They were already written so why not use them?

I agree, they may as well be haddock comments. However, I tried applying
your patch, and the build failed with errors like:

    parse error on input `-- ^ Bindings in a 'let' expression
                               -- or a 'where' clause'

doc comment parse failed:  If @co :: T ts ~ rep_ty@ then:

Ian Lynagh, Haskell Consultant
Well-Typed LLP, http://www.well-typed.com/

More information about the ghc-devs mailing list