OSDN Git Service

PR c/3414
authorjsm28 <jsm28@138bc75d-0d04-0410-961f-82ee72b054a4>
Sun, 4 Jan 2004 20:37:52 +0000 (20:37 +0000)
committerjsm28 <jsm28@138bc75d-0d04-0410-961f-82ee72b054a4>
Sun, 4 Jan 2004 20:37:52 +0000 (20:37 +0000)
* doc/extend.texi: Clarify definition of malloc attribute.

git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@75395 138bc75d-0d04-0410-961f-82ee72b054a4

gcc/ChangeLog
gcc/doc/extend.texi

index a1b09c0..f37704c 100644 (file)
@@ -1,3 +1,8 @@
+2004-01-04  Joseph S. Myers  <jsm@polyomino.org.uk>
+
+       PR c/3414
+       * doc/extend.texi: Clarify definition of malloc attribute.
+
 2004-01-04  Jan Hubicka  <jh@suse.cz>
 
        * Makefile.in (cgraph.o, cgraphunit.o): Add intl.h dependency.
index ac03855..abd8415 100644 (file)
@@ -1,4 +1,4 @@
-@c Copyright (C) 1988,1989,1992,1993,1994,1996,1998,1999,2000,2001,2002, 2003
+@c Copyright (C) 1988,1989,1992,1993,1994,1996,1998,1999,2000,2001,2002,2003,2004
 @c Free Software Foundation, Inc.
 @c This is part of the GCC manual.
 @c For copying conditions, see the file gcc.texi.
@@ -2355,9 +2355,14 @@ and linker.
 @item malloc
 @cindex @code{malloc} attribute
 The @code{malloc} attribute is used to tell the compiler that a function
-may be treated as if it were the malloc function.  The compiler assumes
-that calls to malloc result in pointers that cannot alias anything.
+may be treated as if any non-@code{NULL} pointer it returns cannot
+alias any other pointer valid when the function returns.
 This will often improve optimization.
+Standard functions with this property include @code{malloc} and
+@code{calloc}.  @code{realloc}-like functions have this property as
+long as the old pointer is never referred to (including comparing it
+to the new pointer) after the function returns a non-@code{NULL}
+value.
 
 @item alias ("@var{target}")
 @cindex @code{alias} attribute