From: Peter Verthez <Peter.Verthez@advalvas.be>
Date: Sat, 19 Apr 2003 14:50:22 +0000 (+0000)
Subject: Doxygen conversion of documentation (error handling).
X-Git-Url: https://git.dlugolecki.net.pl/?a=commitdiff_plain;h=989bc1d7262c6e767de09804fb530a5ebea55a5d;p=gedcom-parse.git

Doxygen conversion of documentation (error handling).
---

diff --git a/gedcom/message.c b/gedcom/message.c
index 3fe288b..c756356 100644
--- a/gedcom/message.c
+++ b/gedcom/message.c
@@ -30,6 +30,21 @@ void cleanup_mess_buffer();
 struct safe_buffer mess_buffer = { NULL, 0, NULL, 0, cleanup_mess_buffer };
 Gedcom_msg_handler msg_handler = NULL;
 
+/** This function registers a callback that is called if there are errors,
+    warnings or just messages coming from the parser.  See
+    \ref Gedcom_msg_handler for the signature of the callback.
+
+    For errors, the \c msg passed to the callback will have the format:
+    \code
+      Error on line <lineno>: <actual_message>
+    \endcode
+    Note that the entire string will be properly internationalized, and
+    encoded in UTF-8 (<a href=encoding.html>Why UTF-8?</a>).
+    Also, no newline is appended, so that
+    the application program can use it in any way it wants.  Warnings are
+    similar, but use "Warning" instead of "Error".  Messages are plain
+    text, without any prefix.
+*/
 void gedcom_set_message_handler(Gedcom_msg_handler func)
 {
   msg_handler = func;