Set up the fonctions comment block, boring but useful, Daniel.
diff --git a/error.c b/error.c
index 4c4bac5..a67bdbd 100644
--- a/error.c
+++ b/error.c
@@ -1,15 +1,25 @@
/*
- * error.c: module displaying errors
+ * error.c: module displaying/handling XML parser errors
+ *
+ * Daniel Veillard <Daniel.Veillard@w3.org>
*/
#include <stdio.h>
#include <stdarg.h>
#include "parser.h"
-/*
- * Display and format error messages.
+/**
+ * xmlParserError:
+ * @ctxt: an XML parser context
+ * @msg: the message to display/transmit
+ * @...: extra parameters for the message display
+ *
+ * Display and format an error messages, gives file, line, position and
+ * extra parameters.
*/
-void xmlParserError(xmlParserCtxtPtr ctxt, const char *msg, ...) {
+void
+xmlParserError(xmlParserCtxtPtr ctxt, const char *msg, ...)
+{
const CHAR *cur, *base;
va_list args;
int n;
@@ -52,10 +62,18 @@
fprintf(stderr,"^\n");
}
-/*
- * Display and format error messages.
+/**
+ * xmlParserWarning:
+ * @ctxt: an XML parser context
+ * @msg: the message to display/transmit
+ * @...: extra parameters for the message display
+ *
+ * Display and format a warning messages, gives file, line, position and
+ * extra parameters.
*/
-void xmlParserWarning(xmlParserCtxtPtr ctxt, const char *msg, ...) {
+void
+xmlParserWarning(xmlParserCtxtPtr ctxt, const char *msg, ...)
+{
const CHAR *cur, *base;
va_list args;
int n;
@@ -91,3 +109,4 @@
}
fprintf(stderr,"^\n");
}
+