[MERGED] libosmocore[master]: comment: utils: more accurately describe OSMO_STRINGIFY macro

[Harald Welte]

Harald Welte has submitted this change and it was merged.

Change subject: comment: utils: more accurately describe OSMO_STRINGIFY macro
......................................................................


comment: utils: more accurately describe OSMO_STRINGIFY macro

Change-Id: I7b057c026f9df90608b7cbd12481ab9e7a41d88c
---
M include/osmocom/core/utils.h
1 file changed, 3 insertions(+), 1 deletion(-)

Approvals:
  Harald Welte: Looks good to me, approved
  Jenkins Builder: Verified



diff --git a/include/osmocom/core/utils.h b/include/osmocom/core/utils.h
index c5cc138..0a3805d 100644
--- a/include/osmocom/core/utils.h
+++ b/include/osmocom/core/utils.h
@@ -15,7 +15,9 @@
 #define OSMO_MAX(a, b) ((a) >= (b) ? (a) : (b))
 /*! Return the minimum of two specified values */
 #define OSMO_MIN(a, b) ((a) >= (b) ? (b) : (a))
-/*! Stringify the contents of a macro, e.g. a port number */
+/*! Stringify the name of a macro x, e.g. an FSM event name.
+ * Note: if nested within another preprocessor macro, this will
+ * stringify the value of x instead of its name. */
 #define OSMO_STRINGIFY(x) #x
 /*! Make a value_string entry from an enum value name */
 #define OSMO_VALUE_STRING(x) { x, #x }

-- 
To view, visit https://gerrit.osmocom.org/5251
To unsubscribe, visit https://gerrit.osmocom.org/settings

Gerrit-MessageType: merged
Gerrit-Change-Id: I7b057c026f9df90608b7cbd12481ab9e7a41d88c
Gerrit-PatchSet: 2
Gerrit-Project: libosmocore
Gerrit-Branch: master
Gerrit-Owner: Neels Hofmeyr <nhofmeyr at sysmocom.de>
Gerrit-Reviewer: Harald Welte <laforge at gnumonks.org>
Gerrit-Reviewer: Jenkins Builder