Add a section in style guide: __func__ should be used over __FUNCTION__.

Change-Id: I93eb3e512b6030818b06a63f13999bd45dcfec4e

1 files changed, 6 insertions, 0 deletions

diff --git a/doc/style_guide.md b/doc/style_guide.md
index e08be0a4a..1637ed255 100644
--- a/doc/style_guide.md
+++ b/doc/style_guide.md
@@ -152,6 +152,12 @@ compile-time checks.
 Use booleans to represent boolean state, instead of a set of masks into an
 integer. It's more transparent and readable, and less error prone.
 
+### Function names as strings
+C99 defines `__func__` as an identifier that represents the function's name
+in which it is used. The magic identifier `__FUNCTION__` should not be used
+as it is a non-standard language extension and an equivalent standardized
+mechanism exists. In other words, use `__func__` over `__FUNCTION__`.
+
 ## Bluedroid conventions
 This section describes coding conventions that are specific to Bluedroid.
 Whereas the _Language_ section describes the use of language features, this