aboutsummaryrefslogtreecommitdiff
path: root/gdb
diff options
context:
space:
mode:
authorJoel Brobecker <brobecker@adacore.com>2014-01-21 14:20:50 +0400
committerJoel Brobecker <brobecker@adacore.com>2014-01-22 09:02:45 +0400
commit3a80edfc74646ed5e651d60e7b4f95d165175a89 (patch)
treedf2748d2f47a05ca59d13ff59eddfeec58e13e0a /gdb
parent7dd9c6eb050bb23bff18b3139589f202d4c63a33 (diff)
downloadgdb-3a80edfc74646ed5e651d60e7b4f95d165175a89.zip
gdb-3a80edfc74646ed5e651d60e7b4f95d165175a89.tar.gz
gdb-3a80edfc74646ed5e651d60e7b4f95d165175a89.tar.bz2
Expand documentation of common-utils.h::FUNCTION_NAME
While looking at this macro, I noticed that it wasn't always necessarily defined. That prompted me to search the current sources to make sure that all uses were adequately protected, which they were. But to help prevent future uses to be made unprotected, this patch expands the current macro documentation a bit. gdb/ChangeLog: * common/common-utils.h (FUNCTION_NAME): Expand the macro's documentation a bit.
Diffstat (limited to 'gdb')
-rw-r--r--gdb/ChangeLog5
-rw-r--r--gdb/common/common-utils.h7
2 files changed, 11 insertions, 1 deletions
diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 66f040b..2ccf1cb 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,8 @@
+2014-01-22 Joel Brobecker <brobecker@adacore.com>
+
+ * common/common-utils.h (FUNCTION_NAME): Expand the macro's
+ documentation a bit.
+
2014-01-21 Roland McGrath <mcgrathr@google.com>
* configure.ac: Call AM_PROG_INSTALL_STRIP.
diff --git a/gdb/common/common-utils.h b/gdb/common/common-utils.h
index 2d99549..5960c55 100644
--- a/gdb/common/common-utils.h
+++ b/gdb/common/common-utils.h
@@ -25,7 +25,12 @@
#include <stddef.h>
#include <stdarg.h>
-/* Version 2.4 and later of GCC define a magical variable `__PRETTY_FUNCTION__'
+/* If possible, define FUNCTION_NAME, a macro containing the name of
+ the function being defined. Since this macro may not always be
+ defined, all uses must be protected by appropriate macro definition
+ checks (Eg: "#ifdef FUNCTION_NAME").
+
+ Version 2.4 and later of GCC define a magical variable `__PRETTY_FUNCTION__'
which contains the name of the function currently being defined.
This is broken in G++ before version 2.6.
C9x has a similar variable called __func__, but prefer the GCC one since