On 21/09/14 16:54, Simon Peyton Jones via ghc-devs wrote:
Yes, exactly. Notes have evolved into such a compellingly useful part of GHC
that I really think they deserve Haddock support.
But here’s another tension: the Haddock for a function should be about the user
interface; its specification. But many Notes are specifically about the
details of an implementation.
We could have haddock recognise and link the Note syntax in the
hyperlinked source only, not the exported documentation. Haddock could
process all comments, not just documentation comments for declarations
('-- |' '-- ^' etc.) and provide a way to identify and link to other
comments and declarations. These links could show up in the hyperlinked
source instead of the haddock page detailing the API.
_______________________________________________
ghc-devs mailing list
ghc-devs@haskell.org
http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-devs
