[GHC] #10921: weird "optimisation levels" in man page

GHC ghc-devs at haskell.org
Wed Sep 30 13:42:55 UTC 2015


#10921: weird "optimisation levels" in man page
-------------------------------------+-------------------------------------
           Reporter:  osa1           |             Owner:
               Type:  task           |            Status:  new
           Priority:  lowest         |         Milestone:
          Component:  Documentation  |           Version:  7.10.2
           Keywords:  manpage,       |  Operating System:  Unknown/Multiple
  newcomer                           |
       Architecture:                 |   Type of failure:  None/Unknown
  Unknown/Multiple                   |
          Test Case:                 |        Blocked By:
           Blocking:                 |   Related Tickets:
Differential Rev(s):                 |
-------------------------------------+-------------------------------------
 Man page shows this:

 {{{
    Optimisation levels
        -O0 -O  -O or -O1 -O0  -O2 -O0  -Odph
 }}}

 This looks very weird:

 - Why -O and -O0 listed twice?
 - That `or` looks weird, how do I read that?

 Apparently the man page is auto-generated from the user manual(thanks
 @int-e), and while doing that "reverse" column is also included. We should
 probably either ignore "reverse" column while parsing the user manual
 parts or somehow re-format generated man page lines.

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


More information about the ghc-tickets mailing list