[Haskell-cafe] haddock (on hackage/stackage) missing references to external libraries

[Simon Jakobi]

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 at 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.html
>
> 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.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.haskell.org/pipermail/haskell-cafe/attachments/20181127/18b6bc4a/attachment.html>