[GHC] #11654: User Guide: Generate command line options table from ghc-flags directives

[GHC]

#11654: User Guide: Generate command line options table from ghc-flags directives
-------------------------------------+-------------------------------------
        Reporter:  bgamari           |                Owner:  patrickdoc
            Type:  task              |               Status:  new
        Priority:  normal            |            Milestone:  8.4.1
       Component:  Documentation     |              Version:  7.10.3
      Resolution:                    |             Keywords:
Operating System:  Unknown/Multiple  |         Architecture:
                                     |  Unknown/Multiple
 Type of failure:  None/Unknown      |            Test Case:
      Blocked By:                    |             Blocking:
 Related Tickets:                    |  Differential Rev(s):
       Wiki Page:                    |
-------------------------------------+-------------------------------------

Comment (by patrickdoc):

 Things are mostly working now, but a question has arisen. How do we want
 to categorize the flags?

 We could just have them grouped by source file (inflexible but simple).
 Alternatively, we could add an additional option to
 the flag declaration that chooses the category (flexible but requires
 specifying where every single flag should go). I could even make it
 an optional override deal where it is put under source file by default,
 but you can choose another if you want. I believe the current system is
 mostly source file based, but not entirely.

 I'm hesistant to add a 4th field to the declaration, so I thought I would
 ask if this is something worth supporting or not.

-- 
Ticket URL: <http://ghc.haskell.org/trac/ghc/ticket/11654#comment:6>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler