On Tue, Feb 01, 2005 at 11:02:45AM -0000, Simon Marlow wrote:
So the new approach is to try to build up a global table of the "best" destinations to link to for each entity.
Having a canonical home location for each entity might also help with another bugbear with Haddock: determining whether two unqualified names refer to the same entity. This is impossible at present because Haddock doesn't show qualified names (because doing so would be too cumbersome) and anyway the defining module is often hidden. It's not clear which of the documented catch functions are Control.Cuncurrent.catch, and which are System.IOError.catch. With the new scheme, documentation for an entity in a module other than its home could include a cross-reference to its home.