haddock (on hackage/stackage) missing references to external libraries

Dear Cafe, it seems that haddock (as used on hackage) does not link to identifiers from other packages (neither in HTML nor in hyperlinked source). This hurts, especially if a project has several packages that are meant to be used together, but are split for others reasons (modularity, maintenance). Example: This index has an entry for "bpf", with a non-linked module name Csound.Base: https://hackage.haskell.org/package/csound-expression-5.3.2/docs/doc-index-B... The reason is (I think) that "bpf" is defined elsewhere, but re-exported, and "elsewhere" is in a different package. It is very hard to find the name of this package! (in this case, csound-expression-opcodes) Of course, in no way is this a complaint about Anton's csound-* project. I use it in teaching, and I wonder how could we make documentation more accessible - without extra manual work. Now, :doc of ghc-8.6 works, and :info helps somewhat: :info bpf ... -- Defined in ‘Csound.Typed.Opcode.SignalGenerators’ but it still does not show the name of the package. But at least we know the name of the module to look for. - J.W.

Hi Johannes, this is https://github.com/haskell/haddock/issues/682 I agree that it should be fixed. Cheers, Simon Am Di., 27. Nov. 2018 um 21:18 Uhr schrieb Johannes Waldmann < johannes.waldmann@htwk-leipzig.de>:
Dear Cafe,
it seems that haddock (as used on hackage) does not link to identifiers from other packages (neither in HTML nor in hyperlinked source).
This hurts, especially if a project has several packages that are meant to be used together, but are split for others reasons (modularity, maintenance).
Example: This index has an entry for "bpf", with a non-linked module name Csound.Base:
https://hackage.haskell.org/package/csound-expression-5.3.2/docs/doc-index-B...
The reason is (I think) that "bpf" is defined elsewhere, but re-exported, and "elsewhere" is in a different package.
It is very hard to find the name of this package! (in this case, csound-expression-opcodes)
Of course, in no way is this a complaint about Anton's csound-* project. I use it in teaching, and I wonder how could we make documentation more accessible - without extra manual work.
Now, :doc of ghc-8.6 works, and :info helps somewhat: :info bpf ... -- Defined in ‘Csound.Typed.Opcode.SignalGenerators’ but it still does not show the name of the package. But at least we know the name of the module to look for.
- J.W. _______________________________________________ Haskell-Cafe mailing list To (un)subscribe, modify options or view archives go to: http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe Only members subscribed via the mailman list are allowed to post.

also https://github.com/haskell/haddock/issues/496 (missing refs in hyperlinked source) - J.W.
participants (2)
-
Johannes Waldmann
-
Simon Jakobi