[Bug other/56955] documentation for attribute malloc contradicts itself

[eggert at gnu dot org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=56955

Paul Eggert <eggert at gnu dot org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |eggert at gnu dot org

--- Comment #6 from Paul Eggert <eggert at gnu dot org> ---
Created attachment 32831
  --> https://gcc.gnu.org/bugzilla/attachment.cgi?id=32831&action=edit
Clarify documentation for __attribute__ ((malloc)).

This topic recently came up on the glibc mailing list and there's clearly a lot
of confusion about it.  See, for example,
<https://sourceware.org/ml/libc-alpha/2014-05/msg00519.html>.  Attaching a
proposed patch to the documentation to try to help clear this up.