This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
[cpp,doc] Add a bit of background on assertions
- From: Gerald Pfeifer <gerald at pfeifer dot com>
- To: gcc-patches at gcc dot gnu dot org
- Date: Fri, 18 Feb 2011 01:12:16 +0100 (CET)
- Subject: [cpp,doc] Add a bit of background on assertions
RMS requested that we add some background on assertions, specifically
that we did not actually come up with the idea.
The patch just adds "we added them for compatibility with existing
compilers", the rest is reformatting.
I applied this to head and am thinking to also include it on the GCC 4.5
branch in a bit.
Gerald
2011-02-18 Gerald Pfeifer <gerald@pfeifer.com>
* doc/cpp.texi (Obsolete Features): Add background on the
origin of assertions.
Index: doc/cpp.texi
===================================================================
--- doc/cpp.texi (revision 169771)
+++ doc/cpp.texi (working copy)
@@ -4200,9 +4200,10 @@
define them with preprocessing directives or command-line options.
Assertions were intended to provide a more systematic way to describe
-the compiler's target system. However, in practice they are just as
-unpredictable as the system-specific predefined macros. In addition, they
-are not part of any standard, and only a few compilers support them.
+the compiler's target system and we added them for compatibility with
+existing compilers. In practice they are just as unpredictable as the
+system-specific predefined macros. In addition, they are not part of
+any standard, and only a few compilers support them.
Therefore, the use of assertions is @strong{less} portable than the use
of system-specific predefined macros. We recommend you do not use them at
all.