[GHC] #12155: Description of flags cut off

GHC ghc-devs at haskell.org
Sat Aug 12 02:46:30 UTC 2017


#12155: Description of flags cut off
-------------------------------------+-------------------------------------
        Reporter:  mikail            |                Owner:  (none)
            Type:  task              |               Status:  patch
        Priority:  low               |            Milestone:
       Component:  Documentation     |              Version:  8.0.1
      Resolution:                    |             Keywords:  flags
Operating System:  Unknown/Multiple  |         Architecture:
 Type of failure:  Documentation     |  Unknown/Multiple
  bug                                |            Test Case:
      Blocked By:                    |             Blocking:
 Related Tickets:  #11654            |  Differential Rev(s):  D3839
       Wiki Page:                    |
-------------------------------------+-------------------------------------
Changes (by patrickdoc):

 * status:  new => patch
 * differential:   => D3839
 * related:   => #11654


Comment:

 This was wrapped into the change from `mkUserGuidePart` to Sphinx based
 generation. Tables
 are manually sized in `flags.rst`, but even still it's not perfect. LaTeX
 can't break flags like `-XGeneralizedNewtypeDeriving`, which means that
 the sum of the minimum column widths is larger than the width of the line.
 I believe there aren't any egregious overlaps remaining, but some flags do
 spill out of their cells. Column widths are set in a percentage format
 that looks like `|\Y{20}|\Y{40}|\Y{10}|\Y{30}|`, which is reasonably
 amenable to change.

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


More information about the ghc-tickets mailing list