Wanted: documentation for STM

Samuel Bronson naesten at gmail.com
Mon Dec 11 17:45:01 EST 2006


On 12/11/06, Simon Marlow <simonmarhaskell at gmail.com> wrote:
> Spencer Janssen wrote:
> > Clicking on any of the names takes you to the documentation for
> > GHC.Conc, and each function seems reasonably documented there.  Is
> > Haddock able to show the documentation of these re-exported functions?
>
> The problem is that Haddock doesn't store all the documentation in the .haddock
> file for a package, so it can't propagate documentation for re-exported
> identifiers across package boundaries.  Including all the documentation in the
> .haddock file would bloat the file quite a bit, I think.
>
> However, maybe we could export the documentation on a module-by-module basis,
> selected by an option in the module source.  We should at least improve the
> presentation for identifiers that don't have documentation becuase they are
> re-exported from another package.

Maybe you could make haddock record the documentation for modules that
are hidden (perhaps only if their identifiers aren't re-exported
anywhere else in the same package)?


More information about the Libraries mailing list