Update Doxygen config file and fix Doxygen warnings (#2324)

A lot of warnings remained hibben because 'EXTRACT_ALL' was previously set to YES.

JerryScript-DCO-1.0-Signed-off-by: László Langó llango.u-szeged@partner.samsung.com

jerry-core/ecma/builtin-objects/ecma-builtin-global.c

@@ -591,7 +591,7 @@ ecma_builtin_global_object_character_is_in (uint32_t character, /**< character *
   return (bitset[character >> 3] & (1u << (character & 0x7))) != 0;
 } /* ecma_builtin_global_object_character_is_in */
 
-/*
+/**
  * Unescaped URI characters bitset:
  *   One bit for each character between 0 - 127.
  *   Bit is set if the character is in the unescaped URI set.
@@ -602,7 +602,7 @@ static const uint8_t unescaped_uri_set[16] =
   0xff, 0xff, 0xff, 0x87, 0xfe, 0xff, 0xff, 0x47
 };
 
-/*
+/**
  * Unescaped URI component characters bitset:
  *   One bit for each character between 0 - 127.
  *   Bit is set if the character is in the unescaped component URI set.
@@ -613,18 +613,11 @@ static const uint8_t unescaped_uri_component_set[16] =
   0xfe, 0xff, 0xff, 0x87, 0xfe, 0xff, 0xff, 0x47
 };
 
-/*
+/**
  * Format is a percent sign followed by two hex digits.
  */
 #define URI_ENCODED_BYTE_SIZE (3)
 
-/*
- * These two types shows whether the byte is present in
- * the original stream or decoded from a %xx sequence.
- */
-#define URI_DECODE_ORIGINAL_BYTE 0
-#define URI_DECODE_DECODED_BYTE 1
-
 /**
  * Helper function to decode URI.
  *
@@ -1100,17 +1093,17 @@ ecma_builtin_global_object_encode_uri_component (ecma_value_t this_arg, /**< thi
 
 #ifndef CONFIG_DISABLE_ANNEXB_BUILTIN
 
-/*
+/**
  * Maximum value of a byte.
  */
 #define ECMA_ESCAPE_MAXIMUM_BYTE_VALUE (255)
 
-/*
+/**
  * Format is a percent sign followed by lowercase u and four hex digits.
  */
 #define ECMA_ESCAPE_ENCODED_UNICODE_CHARACTER_SIZE (6)
 
-/*
+/**
  * Escape characters bitset:
  *   One bit for each character between 0 - 127.
  *   Bit is set if the character does not need to be converted to %xx form.

jerry-core/ecma/builtin-objects/ecma-builtin-number-prototype.c

@@ -125,6 +125,11 @@ ecma_builtin_number_prototype_helper_to_string (lit_utf8_byte_t *digits_p, /**<
   return (lit_utf8_size_t) (p - to_digits_p);
 } /* ecma_builtin_number_prototype_helper_to_string */
 
+/**
+ * Helper function to convert a binary floating point number to string.
+ *
+ * @return size of result string
+ */
 static inline lit_utf8_size_t JERRY_ATTR_ALWAYS_INLINE
 ecma_builtin_binary_floating_number_to_string (lit_utf8_byte_t *digits_p, /**< number as string
                                                                            * in binary-floating point number */

jerry-core/ecma/builtin-objects/ecma-builtin-object.c

@@ -153,6 +153,9 @@ ecma_builtin_object_object_get_prototype_of (ecma_value_t this_arg, /**< 'this'
  *
  * See also:
  *          ES2015 9.1.2
+ *
+ * @return true  - if success
+ *         false - otherwise
  */
 static bool
 ecma_set_prototype_of (ecma_value_t o_value, /**< O */

jerry-core/ecma/builtin-objects/ecma-builtin-string-prototype.c

@@ -629,7 +629,7 @@ typedef struct
   ecma_length_t match_end; /**< end position of the match */
 
   /* Replace value callable part. */
-  ecma_object_t *replace_function_p;
+  ecma_object_t *replace_function_p; /**< replace function */
 
   /* Replace value string part. */
   ecma_string_t *replace_string_p; /**< replace string */

jerry-core/ecma/builtin-objects/ecma-builtins.c

@@ -39,13 +39,21 @@ static void ecma_instantiate_builtin (ecma_builtin_id_t id);
  */
 typedef const ecma_builtin_property_descriptor_t *ecma_builtin_property_list_reference_t;
 
+/**
+ * Definition of built-in dispatch routine function pointer.
+ */
 typedef ecma_value_t (*ecma_builtin_dispatch_routine_t)(uint16_t builtin_routine_id,
                                                         ecma_value_t this_arg,
                                                         const ecma_value_t arguments_list[],
                                                         ecma_length_t arguments_number);
+/**
+ * Definition of built-in dispatch call function pointer.
+ */
 typedef ecma_value_t (*ecma_builtin_dispatch_call_t)(const ecma_value_t arguments_list[],
                                                      ecma_length_t arguments_number);
-
+/**
+ * List of the built-in routines.
+ */
 static const ecma_builtin_dispatch_routine_t ecma_builtin_routines[] =
 {
   #define BUILTIN(a, b, c, d, e)
@@ -70,6 +78,9 @@ static const ecma_builtin_dispatch_routine_t ecma_builtin_routines[] =
   #undef BUILTIN_ROUTINE
 };
 
+/**
+ * List of the built-in call functions.
+ */
 static const ecma_builtin_dispatch_call_t ecma_builtin_call_functions[] =
 {
   #define BUILTIN(a, b, c, d, e)
@@ -84,6 +95,9 @@ static const ecma_builtin_dispatch_call_t ecma_builtin_call_functions[] =
   #undef BUILTIN
 };
 
+/**
+ * List of the built-in construct functions.
+ */
 static const ecma_builtin_dispatch_call_t ecma_builtin_construct_functions[] =
 {
   #define BUILTIN(a, b, c, d, e)
@@ -131,7 +145,7 @@ static const ecma_builtin_property_list_reference_t ecma_builtin_property_list_r
  * @return the number of properties
  */
 static size_t
-ecma_builtin_get_property_count (ecma_builtin_id_t builtin_id)
+ecma_builtin_get_property_count (ecma_builtin_id_t builtin_id) /**< built-in ID */
 {
   const ecma_builtin_property_descriptor_t *property_list_p = ecma_builtin_property_list_references[builtin_id];
 
@@ -147,6 +161,9 @@ ecma_builtin_get_property_count (ecma_builtin_id_t builtin_id)
 
 /**
  * Check if passed object is the instance of specified built-in.
+ *
+ * @return true  - if the object is instance of the specified built-in
+ *         false - otherwise
  */
 bool
 ecma_builtin_is (ecma_object_t *obj_p, /**< pointer to an object */