Fix N_SE-56436 for Screen lock.

[platform/framework/native/appfw.git] / inc / FBaseLog.h

diff --git a/inc/FBaseLog.h b/inc/FBaseLog.h
index cec83bc..fbbb6d9 100644 (file)
--- a/inc/FBaseLog.h
+++ b/inc/FBaseLog.h
@@ -34,7 +34,7 @@ extern "C" {
 /**
  * @defgroup GroupMacros Debugging Macros
  *
- * This page describes Tizen debugging macros.
+ * This page describes the Tizen debugging macros.
  *
  * @since 2.0
  */
@@ -70,13 +70,13 @@ extern "C" {
        else {;}
 
 #define AppAssert(condition) \
-       if (!(condition)) { \
+       if (!(condition)) {     \
                AppassertInternal(__PRETTY_FUNCTION__, __LINE__); \
        } \
        else {;}
 
 #define AppAssertf(condition, ...)     \
-       if (!(condition)) { \
+       if (!(condition)) {     \
                AppassertfInternal(# condition, __PRETTY_FUNCTION__, __LINE__, __VA_ARGS__); \
        } \
        else {;}
@@ -88,7 +88,7 @@ extern "C" {
  * @{
  */
 /**
- * This macro allows display of arbitrary messages for future examination.
+ * This macro allows the display of arbitrary messages for future examination.
  *
  * @since 2.0
  *
@@ -187,7 +187,7 @@ extern "C" {
  * @since 2.0
  *
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  ...                     The message to print, if the assertion fails
+ * @param[in]  ...                             The message to print, if the assertion fails
  *
  * @image html debugging_appassert.png
  *
@@ -219,7 +219,7 @@ extern "C" {
  * @since 2.0
  *
  * @param[in]  expression              The expression to evaluate
- * @param[in]  ...                     The message to display
+ * @param[in]  ...                             The message to display
  *
  * The following example demonstrates how to use the AppLogIf macro.
  *
@@ -243,7 +243,7 @@ extern "C" {
  * @since 2.0
  *
  * @param[in]  expression              The expression to evaluate
- * @param[in]  ...                     The message to display
+ * @param[in]  ...                             The message to display
  *
  * The following example demonstrates how to use the AppLogDebugIf macro.
  *
@@ -267,7 +267,7 @@ extern "C" {
  * @since 2.0
  *
  * @param[in]  expression              The expression to evaluate
- * @param[in]  ...                     The message to display
+ * @param[in]  ...                             The message to display
  *
  * The following example demonstrates how to use the AppLogExceptionIf macro.
  *
@@ -388,8 +388,8 @@ extern "C" {
  * @since 2.0
  *
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  expr                    Expressions that are evaluated before going to CATCH label
- * @param[in]  ...                     The message to display
+ * @param[in]  expr                    Expressions that are evaluated before going to the CATCH label
+ * @param[in]  ...                             The message to display
  *
  * The following example demonstrates how to use the Try macro.
  *
@@ -418,7 +418,7 @@ extern "C" {
  * @hideinitializer
  */
 #define TryCatch(condition, expr, ...) \
-       if (!(condition)) { \
+       if (!(condition)) {     \
                AppLogException(__VA_ARGS__); \
                expr; \
                goto CATCH;     \
@@ -432,9 +432,9 @@ extern "C" {
  * @since 2.0
  *
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  expr                    Expressions that are evaluated before going to CATCH label
- * @param[in]  r                       The last result to set
- * @param[in]  ...                     The message to display
+ * @param[in]  expr                    Expressions that are evaluated before going to the CATCH label
+ * @param[in]  r                               The last result to set
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define TryCatchResult(condition, expr, r, ...) \
@@ -448,15 +448,15 @@ extern "C" {
 
 /**
 * If the condition is @c false, it prints a message, sets the last result, evaluates a cleanup expression
-* and goes to label.
+* and goes to the catch label.
 *
 * @since 2.1
 *
 * @param[in]    condition              The condition that is expected to be true
-* @param[in]    expr                   Expressions that are evaluated before going to catchLabel
-* @param[in]    catchLabel             The label for goto operation
-* @param[in]    r                      The last result to set
-* @param[in]    ...                    The message to display
+* @param[in]    expr                   Expressions that are evaluated before going to the CATCH label
+* @param[in]    catchLabel             The label for the goto operation
+* @param[in]    r                              The last result to set
+* @param[in]    ...                            The message to display
 * @hideinitializer
 */
 #define TryCatchLabelResult(condition, expr, catchLabel, r, ...) \
@@ -469,13 +469,13 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed and a value is returned.
+ * If the condition is @c false, a message is printed and a value is returned.
  *
  * @since 2.0
  *
  * @param[in]  condition               The condition that is expected to be true
  * @param[in]  returnValue             The value to return when the condition is @c false
- * @param[in]  ...                     The message to display
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define TryReturn(condition, returnValue, ...) \
@@ -486,14 +486,14 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed, sets the last result and a value is returned.
+ * If the condition is @c false, a message is printed, the last result is set and a value is returned.
  *
  * @since 2.0
  *
  * @param[in]  condition               The condition that is expected to be true
  * @param[in]  returnValue             The value to return when the condition is @c false
- * @param[in]  r                       The last result to set
- * @param[in]  ...                     The message to display
+ * @param[in]  r                               The last result to set
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define TryReturnResult(condition, returnValue, r, ...)        \
@@ -505,11 +505,11 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed, sets the last result and no value is returned.
+ * If the condition is @c false, a message is printed, the last result is set and no value is returned.
  *
  * @since 2.0
  *
- * @param[in]  condition               The condition that is expected to be true
+ * @param[in]  condition       The condition that is expected to be true
  * @param[in]  r                       The last result to set
  * @param[in]  ...                     The message to display
  * @hideinitializer
@@ -523,12 +523,12 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed and no value is returned.
+ * If the condition is @c false, a message is printed and no value is returned.
  *
  * @since 2.0
  *
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  ...                     The message to display
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define TryReturnVoid(condition, ...) \
@@ -539,12 +539,12 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed.
+ * If the condition is @c false, a message is printed.
  *
  * @since 2.0
  *
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  ...                     The message to display
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define TryLog(condition, ...) \
@@ -554,13 +554,13 @@ extern "C" {
        else {;}
 
 /**
-* If the condition is @c false, the informative log message is printed and a value is returned.
+* If the condition is @c false, an informative log message is printed and a value is returned.
 *
 * @since 2.1
 *
 * @param[in]    condition              The condition that is expected to be true
 * @param[in]    returnValue            The value to return when the condition is @c false
-* @param[in]    ...                    The message to display
+* @param[in]    ...                            The message to display
 * @hideinitializer
 */
 #define TryLogReturn(condition, returnValue, ...) \
@@ -578,10 +578,10 @@ extern "C" {
  *
  * @since 2.0
  *
- * @param[in]  tag                     Used to identify the source of a log message
+ * @param[in]  tag                             Used to identify the source of the log message
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  expr                    Expressions that are evaluated before going to CATCH label
- * @param[in]  ...                     The message to display
+ * @param[in]  expr                    Expressions that are evaluated before going to the CATCH label
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define TryCatchTag(tag, condition, expr, ...) \
@@ -598,11 +598,11 @@ extern "C" {
  *
  * @since 2.0
  *
- * @param[in]  tag                     Used to identify the source of a log message
+ * @param[in]  tag                             Used to identify the source of the log message
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  expr                    Expressions that are evaluated before going to CATCH label
- * @param[in]  r                       The last result to set
- * @param[in]  ...                     The message to display
+ * @param[in]  expr                    Expressions that are evaluated before going to the CATCH label
+ * @param[in]  r                               The last result to set
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define TryCatchResultTag(tag, condition, expr, r, ...) \
@@ -616,16 +616,16 @@ extern "C" {
 
 /**
 * If the condition is @c false, it prints a message with a tag, sets the last result, evaluates a cleanup expression
-* and goes to label.
+* and goes to the catch label.
 *
 * @since 2.1
 *
-* @param[in]    tag                    Used to identify the source of a log message
+* @param[in]    tag                            Used to identify the source of the log message
 * @param[in]    condition              The condition that is expected to be true
-* @param[in]    expr                   Expressions that are evaluated before going to catchLabel
-* @param[in]    catchLabel             The label for goto operation
-* @param[in]    r                      The last result to set
-* @param[in]    ...                    The message to display
+* @param[in]    expr                   Expressions that are evaluated before going to the CATCH label
+* @param[in]    catchLabel             The label for the goto operation
+* @param[in]    r                              The last result to set
+* @param[in]    ...                            The message to display
 * @hideinitializer
 */
 #define TryCatchLabelResultTag(tag, condition, expr, catchLabel, r, ...) \
@@ -638,14 +638,14 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed with a tag and a value is returned.
+ * If the condition is @c false, a message is printed with a tag and a value is returned.
  *
  * @since 2.0
  *
- * @param[in]  tag                     Used to identify the source of a log message
+ * @param[in]  tag                             Used to identify the source of the log message
  * @param[in]  condition               The condition that is expected to be true
  * @param[in]  returnValue             The value to return when the condition is @c false
- * @param[in]  ...                     The message to display
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define TryReturnTag(tag, condition, returnValue, ...) \
@@ -656,15 +656,15 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed with a tag, sets the last result and a value is returned.
+ * If the condition is @c false, it prints a message with a tag, sets the last result and returns a value.
  *
  * @since 2.0
  *
- * @param[in]  tag                     Used to identify the source of a log message
+ * @param[in]  tag                             Used to identify the source of the log message
  * @param[in]  condition               The condition that is expected to be true
  * @param[in]  returnValue             The value to return when the condition is @c false
- * @param[in]  r                       The last result to set
- * @param[in]  ...                     The message to display
+ * @param[in]  r                               The last result to set
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define TryReturnResultTag(tag, condition, returnValue, r, ...)        \
@@ -676,14 +676,14 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed with a tag, sets the last result and no value is returned.
+ * If the condition is @c false, it prints a message with a tag, sets the last result and does not return any value.
  *
  * @since 2.0
  *
- * @param[in]  tag                     Used to identify the source of a log message
+ * @param[in]  tag                             Used to identify the source of the log message
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  r                       The last result to set
- * @param[in]  ...                     The message to display
+ * @param[in]  r                               The last result to set
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define TryReturnVoidResultTag(tag, condition, r, ...) \
@@ -695,13 +695,13 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed with a tag and no value is returned.
+ * If the condition is @c false, a message is printed with a tag and no value is returned.
  *
  * @since 2.0
  *
- * @param[in]  tag                     Used to identify the source of a log message
+ * @param[in]  tag                             Used to identify the source of the log message
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  ...                     The message to display
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define TryReturnVoidTag(tag, condition, ...) \
@@ -712,12 +712,12 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed with a tag.
+ * If the condition is @c false, a message is printed with a tag.
  *
  * @since 2.0
  *
- * @param[in]  tag                     Used to identify the source of a log message
- * @param[in]  condition               The condition that is expected to be true
+ * @param[in]  tag                     Used to identify the source of the log message
+ * @param[in]  condition       The condition that is expected to be true
  * @param[in]  ...                     The message to display
  * @hideinitializer
  */
@@ -728,14 +728,14 @@ extern "C" {
        else {;}
 
 /**
-* If the condition is @c false, the informative log message is printed with a tag and a value is returned.
+* If the condition is @c false, an informative log message is printed with a tag and a value is returned.
 *
 * @since 2.1
 *
-* @param[in]    tag                    Used to identify the source of a log message
+* @param[in]    tag                            Used to identify the source of the log message
 * @param[in]    condition              The condition that is expected to be true
 * @param[in]    returnValue            The value to return when the condition is @c false
-* @param[in]    ...                    The message to display
+* @param[in]    ...                            The message to display
 * @hideinitializer
 */
 #define TryLogReturnTag(tag, condition, returnValue, ...) \
@@ -757,19 +757,19 @@ extern "C" {
 
 #if (defined(_APP_LOG) || defined(_OSP_DEBUG_) || defined(_DEBUG)) && defined(_SECURE_LOG)
 
-#define AppSecureLog(...)                      AppLogInternal(__PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
+#define AppSecureLog(...)                              AppLogInternal(__PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
 #define AppSecureLogDebug(...)                 AppLogDebugInternal(__PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
 #define AppSecureLogException(...)             AppLogExceptionInternal(__PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
 
-#define AppSecureLogTag(tag, ...)              AppLogTagInternal(tag, __PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
+#define AppSecureLogTag(tag, ...)                      AppLogTagInternal(tag, __PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
 #define AppSecureLogDebugTag(tag, ...)         AppLogDebugTagInternal(tag, __PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
 #define AppSecureLogExceptionTag(tag, ...)     AppLogExceptionTagInternal(tag, __PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
 
 #else
 /**
- * This macro is to protect informative log messages which needs to keep security.
- * It allows display of informative log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect informative log messages which need security.
+ * It allows the display of informative log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
  *
  * @since 2.1
  *
@@ -791,9 +791,9 @@ extern "C" {
 #define AppSecureLog(...)
 
 /**
- * This macro is to protect debug log messages which needs to keep security.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect debug log messages which need security.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
  *
  * @since 2.1
  *
@@ -822,13 +822,13 @@ extern "C" {
 #define AppSecureLogDebug(...)
 
 /**
- * This macro is to protect exception log messages which needs to keep security.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect exception log messages which need security.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
  *
  * @since 2.1
  *
- * @param[in]  ...                     The message to display 
+ * @param[in]  ...                     The message to display
  *
  * The following example demonstrates how to use the AppSecureLogException macro.
  *
@@ -853,9 +853,9 @@ extern "C" {
 #define AppSecureLogException(...)
 
 /**
- * This macro is to protect informative log messages which needs to keep security, with a tag.
- * It allows display of informative log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect informative log messages which need security, with a tag.
+ * It allows the display of informative log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
  *
  * @since 2.1
  *
@@ -878,9 +878,9 @@ extern "C" {
 #define AppSecureLogTag(tag, ...)
 
 /**
- * This macro is to protect debug log messages which needs to keep security, with a tag.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect debug log messages which need security, with a tag.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
  *
  * @since 2.1
  *
@@ -903,9 +903,9 @@ extern "C" {
 #define AppSecureLogDebugTag(tag, ...)
 
 /**
- * This macro is to protect exception log messages which needs to keep security, with a tag.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect exception log messages which need security, with a tag.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
  *
  * @since 2.1
  *
@@ -932,14 +932,14 @@ extern "C" {
 /**
  * If the condition is @c false, it prints a message, evaluates a cleanup expression,
  * and goes to <tt>CATCH</tt>.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  expr                    Expressions that are evaluated before going to CATCH label
- * @param[in]  ...                     The message to display
+ * @param[in]  expr                    Expressions that are evaluated before going to the CATCH label
+ * @param[in]  ...                             The message to display
  *
  * The following example demonstrates how to use the SecureTry macro.
  *
@@ -979,15 +979,15 @@ extern "C" {
 /**
  * If the condition is @c false, it prints a message, sets the last result, evaluates a cleanup expression
  * and goes to <tt>CATCH</tt>.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * It allows the display of exception log messages if compiled with "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  expr                    Expressions that are evaluated before going to CATCH label
- * @param[in]  r                       The last result to set
- * @param[in]  ...                     The message to display
+ * @param[in]  expr                    Expressions that are evaluated before going to the CATCH label
+ * @param[in]  r                               The last result to set
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define SecureTryCatchResult(condition, expr, r, ...) \
@@ -1001,16 +1001,16 @@ extern "C" {
 
 /**
  * If the condition is @c false, it prints a message, sets the last result, evaluates a cleanup expression
- * and goes to label.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * and goes to the catch label.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
  * @param[in]    condition             The condition that is expected to be true
- * @param[in]    expr                  Expressions that are evaluated before going to catchLabel
- * @param[in]    catchLabel            The label for goto operation
- * @param[in]    r                     The last result to set
+ * @param[in]    expr                  Expressions that are evaluated before going to the CATCH label
+ * @param[in]    catchLabel            The label for the goto operation
+ * @param[in]    r                             The last result to set
  * @param[in]    ...                   The message to display
  * @hideinitializer
  */
@@ -1024,15 +1024,15 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
  * @param[in]  condition               The condition that is expected to be true
  * @param[in]  returnValue             The value to return when the condition is @c false
- * @param[in]  ...                     The message to display
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define SecureTryReturn(condition, returnValue, ...)   \
@@ -1043,16 +1043,16 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed, sets the last result and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality  will be removed in the compile time.
+ * If the condition is @c false, it prints a message, sets the last result and returns a value.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
  * @param[in]  condition               The condition that is expected to be true
  * @param[in]  returnValue             The value to return when the condition is @c false
- * @param[in]  r                       The last result to set
- * @param[in]  ...                     The message to display
+ * @param[in]  r                               The last result to set
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define SecureTryReturnResult(condition, returnValue, r, ...)  \
@@ -1064,15 +1064,15 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed, sets the last result and no value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed, the last result is set and no value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  r                       The last result to set
- * @param[in]  ...                     The message to display
+ * @param[in]  r                               The last result to set
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define SecureTryReturnVoidResult(condition, r, ...)   \
@@ -1084,14 +1084,14 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed and no value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed and no value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  ...                     The message to display
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define SecureTryReturnVoid(condition, ...) \
@@ -1102,14 +1102,14 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  ...                     The message to display
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define SecureTryLog(condition, ...)   \
@@ -1119,15 +1119,15 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the informative log message is printed and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, an informative log message is printed and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
- * @param[in]    condition             The condition that is expected to be true
+ * @param[in]    condition                     The condition that is expected to be true
  * @param[in]    returnValue           The value to return when the condition is @c false
- * @param[in]    ...                   The message to display
+ * @param[in]    ...                           The message to display
  * @hideinitializer
  */
 #define SecureTryLogReturn(condition, returnValue, ...) \
@@ -1142,15 +1142,15 @@ extern "C" {
 /**
  * If the condition is @c false, it prints a message with a tag, evaluates a cleanup expression
  * and goes to <tt>CATCH</tt>.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
- * @param[in]  tag                     Used to identify the source of a log message
+ * @param[in]  tag                             Used to identify the source of the log message
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  expr                    Expressions that are evaluated before going to CATCH label
- * @param[in]  ...                     The message to display
+ * @param[in]  expr                    Expressions that are evaluated before going to the CATCH label
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define SecureTryCatchTag(tag, condition, expr, ...) \
@@ -1164,16 +1164,16 @@ extern "C" {
 /**
  * If the condition is @c false, it prints a message with a tag, sets the last result, evaluates a cleanup expression,
  * and goes to <tt>CATCH</tt>.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
- * @param[in]  tag                     Used to identify the source of a log message
+ * @param[in]  tag                             Used to identify the source of the log message
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  expr                    Expressions that are evaluated before going to CATCH label
- * @param[in]  r                       The last result to set
- * @param[in]  ...                     The message to display
+ * @param[in]  expr                    Expressions that are evaluated before going to the CATCH label
+ * @param[in]  r                               The last result to set
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define SecureTryCatchResultTag(tag, condition, expr, r, ...) \
@@ -1187,17 +1187,17 @@ extern "C" {
 
 /**
  * If the condition is @c false, it prints a message with a tag, sets the last result, evaluates a cleanup expression
- * and goes to label.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * and goes to the catch label.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
- * @param[in]    tag                   Used to identify the source of a log message
+ * @param[in]    tag                   Used to identify the source of the log message
  * @param[in]    condition             The condition that is expected to be true
- * @param[in]    expr                  Expressions that are evaluated before going to catchLabel
- * @param[in]    catchLabel            The label for goto operation
- * @param[in]    r                     The last result to set
+ * @param[in]    expr                  Expressions that are evaluated before going to the CATCH label
+ * @param[in]    catchLabel            The label for the goto operation
+ * @param[in]    r                             The last result to set
  * @param[in]    ...                   The message to display
  * @hideinitializer
  */
@@ -1211,16 +1211,16 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed with a tag and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
- * @param[in]  tag                     Used to identify the source of a log message
+ * @param[in]  tag                             Used to identify the source of the log message
  * @param[in]  condition               The condition that is expected to be true
  * @param[in]  returnValue             The value to return when the condition is @c false
- * @param[in]  ...                     The message to display
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define SecureTryReturnTag(tag, condition, returnValue, ...)   \
@@ -1231,17 +1231,17 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed with a tag, sets the last result and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag, the last result is set and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
- * @param[in]  tag                     Used to identify the source of a log message
+ * @param[in]  tag                             Used to identify the source of the log message
  * @param[in]  condition               The condition that is expected to be true
  * @param[in]  returnValue             The value to return when the condition is @c false
- * @param[in]  r                       The last result to set
- * @param[in]  ...                     The message to display
+ * @param[in]  r                               The last result to set
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define SecureTryReturnResultTag(tag, condition, returnValue, r, ...)  \
@@ -1253,14 +1253,14 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed with a tag, sets the last result and no value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag, the last result is set and no value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
- * @param[in]  tag                     Used to identify the source of a log message
- * @param[in]  condition               The condition that is expected to be true
+ * @param[in]  tag                     Used to identify the source of the log message
+ * @param[in]  condition       The condition that is expected to be true
  * @param[in]  r                       The last result to set
  * @param[in]  ...                     The message to display
  * @hideinitializer
@@ -1274,15 +1274,15 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed with a tag and no value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag and no value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
- * @param[in]  tag                     Used to identify the source of a log message
+ * @param[in]  tag                             Used to identify the source of the log message
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  ...                     The message to display
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define SecureTryReturnVoidTag(tag, condition, ...) \
@@ -1293,34 +1293,34 @@ extern "C" {
        else {;}
 
 /**
- * If the condition is @c false, the message is printed with a tag.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
- * @param[in]  tag                     Used to identify the source of a log message
+ * @param[in]  tag                             Used to identify the source of the log message
  * @param[in]  condition               The condition that is expected to be true
- * @param[in]  ...                     The message to display
+ * @param[in]  ...                             The message to display
  * @hideinitializer
  */
 #define SecureTryLogTag(tag, condition, ...)   \
-       if (!(condition)) { \
+       if (!(condition)) {     \
                AppSecureLogTag(tag, __VA_ARGS__); \
        } \
        else {;}
 
 /**
- * If the condition is @c false, the informative log message is printed with a tag and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, an informative log message is printed with a tag and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
  *
  * @since 2.1
  *
- * @param[in]    tag                   Used to identify the source of a log message
- * @param[in]    condition             The condition that is expected to be true
+ * @param[in]    tag                           Used to identify the source of the log message
+ * @param[in]    condition                     The condition that is expected to be true
  * @param[in]    returnValue           The value to return when the condition is @c false
- * @param[in]    ...                   The message to display
+ * @param[in]    ...                           The message to display
  * @hideinitializer
  */
 #define SecureTryLogReturnTag(tag, condition, returnValue, ...) \