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/parser/js/byte-code.c

@@ -33,6 +33,9 @@ JERRY_STATIC_ASSERT ((sizeof (cbc_uint16_arguments_t) % sizeof (jmem_cpointer_t)
  * @{
  */
 
+/**
+ * Compact bytecode definition
+ */
 #define CBC_OPCODE(arg1, arg2, arg3, arg4) \
   ((arg2) | (((arg3) + CBC_STACK_ADJUST_BASE) << CBC_STACK_ADJUST_SHIFT)),
 

jerry-core/parser/js/js-lexer.c

@@ -33,6 +33,9 @@
  * @{
  */
 
+/**
+ * Check whether the UTF-8 intermediate is an octet or not
+ */
 #define IS_UTF8_INTERMEDIATE_OCTET(byte) (((byte) & LIT_UTF8_EXTRA_BYTE_MASK) == LIT_UTF8_2_BYTE_CODE_POINT_MIN)
 
 /**
@@ -279,12 +282,17 @@ lexer_skip_spaces (parser_context_t *context_p) /**< context */
  */
 typedef struct
 {
-  const uint8_t *keyword_p;     /**< keyword string */
-  lexer_token_type_t type;      /**< keyword token type */
+  const uint8_t *keyword_p; /**< keyword string */
+  lexer_token_type_t type;  /**< keyword token type */
 } keyword_string_t;
 
+/**
+ * @{
+ * Keyword defines
+ */
 #define LEXER_KEYWORD(name, type) { (const uint8_t *) (name), (type) }
 #define LEXER_KEYWORD_END()       { (const uint8_t *) NULL, LEXER_EOS }
+/** @} */
 
 /**
  * Keywords with 2 characters.
@@ -971,6 +979,12 @@ lexer_parse_number (parser_context_t *context_p) /**< context */
   context_p->source_p = source_p;
 } /* lexer_parse_number */
 
+/**
+ * One character long token (e.g. comma).
+ *
+ * @param char1 character
+ * @param type1 type
+ */
 #define LEXER_TYPE_A_TOKEN(char1, type1) \
   case (uint8_t) (char1) : \
   { \
@@ -979,6 +993,14 @@ lexer_parse_number (parser_context_t *context_p) /**< context */
     break; \
   }
 
+/**
+ * Token pair, where the first token is prefix of the second (e.g. % and %=).
+ *
+ * @param char1 first character
+ * @param type1 type of the first character
+ * @param char2 second character
+ * @param type2 type of the second character
+ */
 #define LEXER_TYPE_B_TOKEN(char1, type1, char2, type2) \
   case (uint8_t) (char1) : \
   { \
@@ -994,6 +1016,16 @@ lexer_parse_number (parser_context_t *context_p) /**< context */
     break; \
   }
 
+/**
+ * Three tokens, where the first is the prefix of the other two (e.g. &, &&, &=).
+ *
+ * @param char1 first character
+ * @param type1 type of the first character
+ * @param char2 second character
+ * @param type2 type of the second character
+ * @param char3 third character
+ * @param type3 type of the third character
+ */
 #define LEXER_TYPE_C_TOKEN(char1, type1, char2, type2, char3, type3) \
   case (uint8_t) (char1) : \
   { \
@@ -1393,7 +1425,9 @@ lexer_process_char_literal (parser_context_t *context_p, /**< context */
   context_p->literal_count++;
 } /* lexer_process_char_literal */
 
-/* Maximum buffer size for identifiers which contains escape sequences. */
+/**
+ * Maximum local buffer size for identifiers which contains escape sequences.
+ */
 #define LEXER_MAX_LITERAL_LOCAL_BUFFER_SIZE 48
 
 /**
@@ -2113,11 +2147,17 @@ lexer_expect_identifier (parser_context_t *context_p, /**< context */
   parser_raise_error (context_p, PARSER_ERR_IDENTIFIER_EXPECTED);
 } /* lexer_expect_identifier */
 
+/**
+ * Description of "get" literal string.
+ */
 static const lexer_lit_location_t lexer_get_literal =
 {
   (const uint8_t *) "get", 3, LEXER_IDENT_LITERAL, false
 };
 
+/**
+ * Description of "set" literal string.
+ */
 static const lexer_lit_location_t lexer_set_literal =
 {
   (const uint8_t *) "set", 3, LEXER_IDENT_LITERAL, false

jerry-core/parser/js/js-parser-statm.c

@@ -31,9 +31,13 @@
  * @{
  */
 
-/* Strict mode string literal in directive prologues */
+/**
+ * @{
+ * Strict mode string literal in directive prologues
+ */
 #define PARSER_USE_STRICT_LITERAL  "use strict"
 #define PARSER_USE_STRICT_LENGTH   10
+/** @} */
 
 /**
  * Parser statement types.
@@ -253,6 +257,8 @@ parser_stack_iterator_init (parser_context_t *context_p, /**< context */
 
 /**
  * Read the next byte from the stack.
+ *
+ * @return byte
  */
 static inline uint8_t
 parser_stack_iterator_read_uint8 (parser_stack_iterator_t *iterator) /**< iterator */
@@ -496,6 +502,9 @@ parser_parse_if_statement_start (parser_context_t *context_p) /**< context */
 
 /**
  * Parse if statement (ending part).
+ *
+ * @return true  - if parsing an 'else' statement
+ *         false - otherwise
  */
 static bool
 parser_parse_if_statement_end (parser_context_t *context_p) /**< context */

jerry-core/parser/js/js-parser-util.c

@@ -72,6 +72,12 @@ parser_emit_two_bytes (parser_context_t *context_p, /**< context */
   }
 } /* parser_emit_two_bytes */
 
+/**
+ * Append byte to the end of the current byte code stream.
+ *
+ * @param context_p parser context
+ * @param byte byte
+ */
 #define PARSER_APPEND_TO_BYTE_CODE(context_p, byte) \
   if ((context_p)->byte_code.last_position >= PARSER_CBC_STREAM_PAGE_SIZE) \
   { \
@@ -476,7 +482,9 @@ parser_emit_cbc_forward_branch (parser_context_t *context_p, /**< context */
 } /* parser_emit_cbc_forward_branch */
 
 /**
- * Append a branch byte code and create an item
+ * Append a branch byte code and create an item.
+ *
+ * @return newly created parser branch node
  */
 parser_branch_node_t *
 parser_emit_cbc_forward_branch_item (parser_context_t *context_p, /**< context */

jerry-core/parser/js/js-parser.c

@@ -1361,6 +1361,12 @@ parse_print_final_cbc (ecma_compiled_code_t *compiled_code_p, /**< compiled code
 
 #endif /* PARSER_DUMP_BYTE_CODE */
 
+/**
+ * Forward iterator: move to the next byte code
+ *
+ * @param page_p page
+ * @param offset offset
+ */
 #define PARSER_NEXT_BYTE(page_p, offset) \
   do { \
     if (++(offset) >= PARSER_CBC_STREAM_PAGE_SIZE) \
@@ -1370,6 +1376,13 @@ parse_print_final_cbc (ecma_compiled_code_t *compiled_code_p, /**< compiled code
     } \
   } while (0)
 
+/**
+ * Forward iterator: move to the next byte code. Also updates the offset of the previous byte code.
+ *
+ * @param page_p page
+ * @param offset offset
+ * @param real_offset real offset
+ */
 #define PARSER_NEXT_BYTE_UPDATE(page_p, offset, real_offset) \
   do { \
     page_p->bytes[offset] = real_offset; \