[GHC] #14214: Users guide lies about default optimization level

[GHC]

#14214: Users guide lies about default optimization level
-------------------------------------+-------------------------------------
        Reporter:  bgamari           |                Owner:  bgamari
            Type:  bug               |               Status:  new
        Priority:  high              |            Milestone:  8.4.1
       Component:  Compiler          |              Version:  8.2.1
      Resolution:                    |             Keywords:
Operating System:  Unknown/Multiple  |         Architecture:
 Type of failure:  Documentation     |  Unknown/Multiple
  bug                                |            Test Case:
      Blocked By:                    |             Blocking:
 Related Tickets:                    |  Differential Rev(s):
       Wiki Page:                    |
-------------------------------------+-------------------------------------

Comment (by bgamari):

 In response to comment:2:

 Regarding (2): It would be great to have the documentation specify
 precisely which flags each of the optimisation levels implies. However, I
 think we would ideally like to have these lists generated from the
 implementation; otherwise it's only a matter of time until they fall out-
 of-date.

 Regarding (3): I believe that as of
 b2b416014e4276ebb660d85c3a612f7ca45ade78 there is now such a mention.

 Regarding (4): Indeed, it looks like this has been out-of-date for quite a
 long time; I don't remember a time when `-v` told you anything about which
 optimisation flags were used.

 Regarding (5): I absolutely agree. The documentation for some of these
 flags is incredibly confusing. What makes things complicated is that
 `-fopt-coercion` doesn't currently exist.

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