Serious upgrade of internal subset support, setup for gtk-doc, Daniel
diff --git a/entities.c b/entities.c
index ef6aa79..e16dc55 100644
--- a/entities.c
+++ b/entities.c
@@ -154,7 +154,7 @@
  *
  * Check whether this name is an predefined entity.
  *
- * return values: NULL if not, othervise the entity
+ * Returns NULL if not, othervise the entity
  */
 xmlEntityPtr
 xmlGetPredefinedEntity(const CHAR *name) {
@@ -241,7 +241,7 @@
  * Do an entity lookup in the Dtd entity hash table and
  * returns the corresponding entity, if found.
  * 
- * return values: A pointer to the entity structure or NULL if not found.
+ * Returns A pointer to the entity structure or NULL if not found.
  */
 xmlEntityPtr
 xmlGetDtdEntity(xmlDocPtr doc, const CHAR *name) {
@@ -268,7 +268,7 @@
  * returns the corrsponding entity, otherwise a lookup is done
  * in the predefined entities too.
  * 
- * return values: A pointer to the entity structure or NULL if not found.
+ * Returns A pointer to the entity structure or NULL if not found.
  */
 xmlEntityPtr
 xmlGetDocEntity(xmlDocPtr doc, const CHAR *name) {
@@ -317,7 +317,7 @@
  * TODO This routine is not reentrant and this will be changed, the interface
  *      should not be modified though.
  * 
- * return values: A newly allocated string with the substitution done.
+ * Returns A newly allocated string with the substitution done.
  */
 CHAR *
 xmlEncodeEntities(xmlDocPtr doc, const CHAR *input) {
@@ -423,7 +423,7 @@
  *
  * create and initialize an empty entities hash table.
  *
- * return values: the xmlEntitiesTablePtr just created or NULL in case of error.
+ * Returns the xmlEntitiesTablePtr just created or NULL in case of error.
  */
 xmlEntitiesTablePtr
 xmlCreateEntitiesTable(void) {
@@ -474,7 +474,7 @@
  *
  * Build a copy of an entity table.
  * 
- * return values: the new xmlEntitiesTablePtr or NULL in case of error.
+ * Returns the new xmlEntitiesTablePtr or NULL in case of error.
  */
 xmlEntitiesTablePtr
 xmlCopyEntitiesTable(xmlEntitiesTablePtr table) {