[GHC] #8254: confusing comment on allocate()

[GHC]

#8254: confusing comment on allocate()
------------------------------------+--------------------------------------
       Reporter:  rwbarton          |             Owner:
           Type:  bug               |            Status:  new
       Priority:  normal            |         Milestone:
      Component:  Runtime System    |           Version:  7.7
       Keywords:                    |  Operating System:  Unknown/Multiple
   Architecture:  Unknown/Multiple  |   Type of failure:  Documentation bug
     Difficulty:  Unknown           |         Test Case:
     Blocked By:                    |          Blocking:
Related Tickets:                    |
------------------------------------+--------------------------------------
 {{{
 /*
 -----------------------------------------------------------------------------
    allocate()

    This allocates memory in the current thread - it is intended for
    use primarily from STG-land where we have a Capability.  It is
    better than allocate() because it doesn't require taking the
    sm_mutex lock in the common case.

    Memory is allocated directly from the nursery if possible (but not
    from the current nursery block, so as not to interfere with
    Hp/HpLim).
 --------------------------------------------------------------------------
 */
 }}}

 Not sure what, if anything, `allocate()` is better than, but it's not
 `allocate()`.

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