update make_release.sh
[cparser] / parser.h
index 4bc63fb..f402908 100644 (file)
--- a/parser.h
+++ b/parser.h
@@ -1,6 +1,6 @@
 /*
  * This file is part of cparser.
- * Copyright (C) 2007-2008 Matthias Braun <matze@braunis.de>
+ * Copyright (C) 2007-2009 Matthias Braun <matze@braunis.de>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU General Public License
 
 typedef struct environment_entry_t environment_entry_t;
 
+/**
+ * Initialize parser. Should be called once when the program starts
+ */
 void init_parser(void);
+/**
+ * Frees resources occupied by parser. Should be called once before the program
+ * exits.
+ */
 void exit_parser(void);
 
+/**
+ * Start parsing a new compilation unit
+ */
 void start_parsing(void);
+
+/**
+ * Parse input. The source of the input is determined by the lexer module
+ */
 void parse(void);
+
+/**
+ * Finish parsing a complete compilation unit and return the AST.
+ */
 translation_unit_t *finish_parsing(void);
 
 type_t   *revert_automatic_type_conversion(const expression_t *expression);
@@ -37,4 +55,6 @@ entity_t *expression_is_variable(const expression_t *expression);
 
 void prepare_main_collect2(entity_t *entity);
 
+entity_t *record_entity(entity_t *entity, bool is_definition);
+
 #endif