[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:
            Type:  task              |               Status:  new
        Priority:  normal            |            Milestone:  8.2.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:                    |
-------------------------------------+-------------------------------------
Description changed by siddhanathan:

@@ -7,1 +7,1 @@
- flags` directives already present in the users guide. This will involve a
+ flag` directives already present in the users guide. This will involve a

New description:

 Since the move to ReStructuredText and Sphinx we've generated the options
 summary tables and manpage with `utils/mkUserGuidePart`. The options are
 described in a set of Haskell modules which are a pain to edit and may
 easily fall out of date.

 It would be far better if we could generate these tables from the `.. ghc-
 flag` directives already present in the users guide. This will involve a
 bit of hacking with Sphinx, although it should be more than up to the
 task.

--

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