#936: Add Haddock-Options field to Cabal package description
----------------------------------+-----------------------------------------
Reporter: guest | Owner:
Type: enhancement | Status: new
Priority: normal | Milestone: Cabal-1.16
Component: Cabal specification | Version: 1.10.2.0
Severity: normal | Keywords:
Difficulty: unknown | Ghcversion:
Platform: |
----------------------------------+-----------------------------------------
Comment(by guest):
The feature request for the --qual option is in this ticket:
http://trac.haskell.org/haddock/ticket/22
I am currently adding a mode that is close to the proposed 'orig'
qualification mode.
Currently Haddock only allows to set the qualification style globally. The
reason is that you normally choose one style of identifiers for a whole
package. E.g. identifiers in the 'stm' package always contain a suffix
that reflects the module. You will usually write them unqualified. In
contrast to that package 'bytestring' re-uses the same function names in
different modules of the package and function names that are already
present in Prelude. Thus you will certainly use those identifiers in a
qualified way.
In principle we could add a Haddock-PRAGMA for a per-module setting,
but this seems to be less useful.
--
Ticket URL: <http://hackage.haskell.org/trac/hackage/ticket/936#comment:4>
Hackage <http://haskell.org/cabal/>
Hackage: Cabal and related projects
_______________________________________________
cabal-devel mailing list
cabal-devel@haskell.org
http://www.haskell.org/mailman/listinfo/cabal-devel
