2012-02-15 Andrew MacLeod <amacleod@redhat.com>

	* extend.texi: Reserve upper bits of memory model for future use.

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

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 3cbbf18..9d860de 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,7 @@
+2012-02-15  Andrew MacLeod  <amacleod@redhat.com>
+
+       * extend.texi: Reserve upper bits of memory model for future use.
+
 2012-01-15  Georg-Johann Lay  <avr@gjlay.de>
            Anatoly Sokolov <aesok@post.ru>
            Eric Weddington <eric.weddington@atmel.com>

diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi
index b666a2e..e4d17cf 100644 (file)
--- a/gcc/doc/extend.texi
+++ b/gcc/doc/extend.texi
@@ -7092,6 +7092,11 @@ functions will map any runtime value to @code{__ATOMIC_SEQ_CST} rather
 than invoke a runtime library call or inline a switch statement.  This is
 standard compliant, safe, and the simplest approach for now.
 
+The memory model parameter is a signed int, but only the lower 8 bits are
+reserved for the memory model.  The remainder of the signed int is reserved
+for future use and should be 0.  Use of the predefined atomic values will
+ensure proper usage.
+
 @deftypefn {Built-in Function} @var{type} __atomic_load_n (@var{type} *ptr, int memmodel)
 This built-in function implements an atomic load operation.  It returns the
 contents of @code{*@var{ptr}}.