Document pragmatics of why gdb_assert() is lowercase.

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index d498458..d3d62be 100644 (file)
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,5 +1,9 @@
 2001-03-01  Andrew Cagney  <ac131313@redhat.com>
 
+       * gdb_assert.h: Document pragmatics behind gdb_assert's case.
+
+2001-03-01  Andrew Cagney  <ac131313@redhat.com>
+
        * Makefile.in (gdbtk-cmds.o): Add $(regcache_h) to dependency
        lists.
        (mi-main.o): Ditto.

diff --git a/gdb/gdb_assert.h b/gdb/gdb_assert.h
index c9979db..4f0bcdc 100644 (file)
--- a/gdb/gdb_assert.h
+++ b/gdb/gdb_assert.h
@@ -21,6 +21,11 @@
 #ifndef GDB_ASSERT_H
 #define GDB_ASSERT_H
 
+/* PRAGMATICS: "gdb_assert.h":gdb_assert() is a lower case (rather
+   than upper case) macro since that provides the closest fit to the
+   existing lower case macro <assert.h>:assert() that it is
+   replacing. */
+
 #define gdb_assert(expr)                                                      \
   ((void) ((expr) ? 0 :                                                       \
           (gdb_assert_fail (#expr, __FILE__, __LINE__, ASSERT_FUNCTION), 0)))