Non-recognised declarations can "get in the way" of Haddock comments being recognised

[waern]

Pragmas and other non-recognised declarations can stop Haddock commentation being recognised.

e.g. This is undocumented in the resulting haddock ("A comment" is missing).

-- | A comment.
{-# INLINE genVennAsList #-}
genVennAsList :: (a -> b -> COrdering c) -> AVL a -> AVL b -> (AVL a, [c], AVL b)
genVennAsList cmp = genVennToList cmp []

.. but this is OK

-- | A comment.
genVennAsList :: (a -> b -> COrdering c) -> AVL a -> AVL b -> (AVL a, [c], AVL b)
{-# INLINE genVennAsList #-}
genVennAsList cmp = genVennToList cmp []

[waern]

Reported by Adrian Hey.

[waern]

The problem here is that we match up Haddock comments with their declarations by going through a list of all declarations and matching using SrcLoc?'s. This would work perfectly if the list of all declarations actually contained all declarations :) Currently it only contains those types of delcarations that we care about in Haddock. The fix should be easy to implement.

[wren ng thornton]

Any progress on this? It's a regression since version 2.0.0.0 [1] and it's affecting all of Hackage now.

[1] http://community.haskell.org/~wren/bytestring-trie/dist/doc/html/bytestring-trie/Data-Trie.html

[2] http://hackage.haskell.org/packages/archive/bytestring-trie/0.1.4/doc/html/Data-Trie.html

[waern]

Will try to get this into the next release.

[anonymous]

Milestone 2.4.2 deleted