#2337: Data.Array documentation utterly broken
------------------------------+---------------------------------------------
Reporter: japple | Owner: igloo
Type: bug | Status: new
Priority: high | Milestone: 6.12 branch
Component: Documentation | Version: 6.11
Severity: normal | Resolution:
Keywords: | Difficulty: Unknown
Testcase: | Architecture: Unknown/Multiple
Os: Unknown/Multiple |
------------------------------+---------------------------------------------
Comment (by igloo):
Replying to [comment:18 simonmar]:
> That Haddock bug only applies to references to modules from inside
documentation, so the hyperlinks for the actual names should still work,
right?
Yes. I was trying to say "Look in GHC.Arr for docs".
> Also, could we do something like this:
>
> {{{
> module Data.Array where
> import qualified GHC.Arr
>
> -- | .. documentation for 'array'
> array = GHC.Arr.array
> }}}
>
> only works for functions, of course.
Also, if GHC.Arr.array and Data.Array.array are both in scope then you
have an ambiguous variable.
But links to array in the docs go to GHC.Arr now, so it's only people
browsing to the Data.Array docs who will have the inconvenience of having
to manually browse to the GHC.Arr docs.
It's not a perfect situation, but I think it's good enough for now.
--
Ticket URL: <http://hackage.haskell.org/trac/ghc/ticket/2337#comment:19>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler_______________________________________________
Glasgow-haskell-bugs mailing list
[email protected]
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs
