haskell / haddock

Haskell Documentation Tool
www.haskell.org/haddock/
BSD 2-Clause "Simplified" License
361 stars 241 forks source link

Controlling layout of re-exported modules #940

Open merijn opened 6 years ago

merijn commented 6 years ago

First off, the new comprehensive listing of partially re-exported modules is awesome, however the docs from the re-exported module appear to be in a completely random order, which is a shame.

Consider this original module: https://hackage.haskell.org/package/broadcast-chan-0.2/candidate/docs/BroadcastChan.html

And this module that re-exports the above: https://hackage.haskell.org/package/broadcast-chan-0.2/candidate/docs/BroadcastChan-Throw.html#g:1

The re-exports are in a jumbled order with no apparent sense (it's not alphabetical, it's not the export list of the original module). This is a shame, ideally there should be some way to control how the documentation for these re-exports is produced (either alphabetical or in export order) or perhaps even an option to select between those (and more?) options.

sjakobi commented 5 years ago

Hi Haddock is going to contain a solution for this problem. I'm currently trying to work out a specification. I'll link to it once I have it written down.

Kleidukos commented 3 years ago

@sjakobi Hi! Do you have any news on that front? :)