[GHC] #8864: Document heap allocation functions in StgCmmMonad/StgCmmLayout

[GHC]

#8864: Document heap allocation functions in StgCmmMonad/StgCmmLayout
-------------------------------------+------------------------------------
        Reporter:  tibbe             |            Owner:
            Type:  feature request   |           Status:  new
        Priority:  normal            |        Milestone:
       Component:  Documentation     |          Version:  7.6.3
      Resolution:                    |         Keywords:
Operating System:  Unknown/Multiple  |     Architecture:  Unknown/Multiple
 Type of failure:  None/Unknown      |       Difficulty:  Unknown
       Test Case:                    |       Blocked By:
        Blocking:                    |  Related Tickets:
-------------------------------------+------------------------------------

Comment (by tibbe):

 Replying to [comment:5 simonpj]:
 > It's never invalid, so far as I know.

 I think it's invalid as soon as Hp changes. See this comment:
 https://github.com/ghc/ghc/blob/master/compiler/codeGen/StgCmmHeap.hs#L80

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