[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
           Keywords:                 |  Operating System:  Unknown/Multiple
       Architecture:                 |   Type of failure:  None/Unknown
  Unknown/Multiple                   |
          Test Case:                 |        Blocked By:
           Blocking:                 |   Related Tickets:
Differential Rev(s):                 |         Wiki Page:
-------------------------------------+-------------------------------------
 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-
 flags` 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>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler