[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