X-Git-Url: https://git.dlugolecki.net.pl/?a=blobdiff_plain;f=gedcom%2Fmessage.c;h=c756356eb1e852b249569e15e8f98220ed5f946c;hb=60282b9f2f1326231ea5019e239d00bdccd6608b;hp=3fe288b079c993f155322718bc10e0edaf7de6af;hpb=8d7d7a57b31433fad9bcfb2bb21cfa5cd1090679;p=gedcom-parse.git

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;