Patchwork [cpp,doc] Add a bit of background on assertions

login
register
mail settings
Submitter Gerald Pfeifer
Date Feb. 18, 2011, 12:12 a.m.
Message ID <alpine.LNX.2.00.1102180109040.7945@gerinyyl.fvgr>
Download mbox | patch
Permalink /patch/83518/
State New
Headers show

Comments

Gerald Pfeifer - Feb. 18, 2011, 12:12 a.m.
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.

Patch

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.