[Hackage] #936: Add Haddock-Options field to Cabal package description
Hackage
cvs-ghc at haskell.org
Tue Apr 3 00:48:25 CEST 2012
#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 duncan):
Hmm, but this isn't something that authors want to specify on a per-
file/module basis like other haddock directives?
With haddock, the usual rule of thumb is that author-specified directives
go in the source files themselves (e.g. hide, pune etc) while things the
builder should specify are command line options (which we partially
reflect as cabal haddock features or via --haddock-options).
I found the bit in the user guide for `--qual` but I have to admit it's
not clear to me the purpose or who should be setting it, and if it's
really a package global or module local option. Is there any ticket or
other discussion that gives some explanation or motivation for the
feature?
--
Ticket URL: <http://hackage.haskell.org/trac/hackage/ticket/936#comment:3>
Hackage <http://haskell.org/cabal/>
Hackage: Cabal and related projects
More information about the cabal-devel
mailing list