Revert "Revert "Fix intApp TC failure""

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

diff --git a/inc/FBaseLog.h b/inc/FBaseLog.h
index b2e251b..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
  */
@@ -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
  *
@@ -388,7 +388,7 @@ 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]  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.
@@ -432,7 +432,7 @@ 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]  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
@@ -448,13 +448,13 @@ 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]    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
@@ -469,7 +469,7 @@ 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
  *
@@ -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,7 +505,7 @@ 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
  *
@@ -523,7 +523,7 @@ 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
  *
@@ -539,7 +539,7 @@ 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
  *
@@ -554,7 +554,7 @@ 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
 *
@@ -578,9 +578,9 @@ 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]  expr                    Expressions that are evaluated before going to the CATCH label
  * @param[in]  ...                             The message to display
  * @hideinitializer
  */
@@ -598,9 +598,9 @@ 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]  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
@@ -616,14 +616,14 @@ 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]    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
@@ -638,11 +638,11 @@ 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
@@ -656,11 +656,11 @@ 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
@@ -676,11 +676,11 @@ 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
@@ -695,11 +695,11 @@ 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
  * @hideinitializer
@@ -712,11 +712,11 @@ 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]  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,11 +728,11 @@ 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
@@ -767,9 +767,9 @@ extern "C" {
 
 #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,9 +822,9 @@ 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
  *
@@ -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,13 +932,13 @@ 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]  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,13 +979,13 @@ 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]  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
@@ -1001,15 +1001,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.
- * 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]    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,9 +1024,9 @@ 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
  *
@@ -1043,9 +1043,9 @@ 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
  *
@@ -1064,9 +1064,9 @@ 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
  *
@@ -1084,9 +1084,9 @@ 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
  *
@@ -1102,9 +1102,9 @@ 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
  *
@@ -1119,9 +1119,9 @@ 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
  *
@@ -1142,14 +1142,14 @@ 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]  expr                    Expressions that are evaluated before going to the CATCH label
  * @param[in]  ...                             The message to display
  * @hideinitializer
  */
@@ -1164,14 +1164,14 @@ 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]  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
@@ -1187,16 +1187,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.
- * 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]    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,13 +1211,13 @@ 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
@@ -1231,13 +1231,13 @@ 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
@@ -1253,13 +1253,13 @@ 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]  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
@@ -1274,13 +1274,13 @@ 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
  * @hideinitializer
@@ -1293,13 +1293,13 @@ 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
  * @hideinitializer
@@ -1311,13 +1311,13 @@ extern "C" {
        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]    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