document the fact that you have to reassemble the messages

diff --git a/src/adns.h b/src/adns.h
index 99e32b109cf6ece9ac434d7632947b7724fe8bfd..51024468c7cebb78b2f8ec5d37da6aac0e58c691 100644 (file)
--- a/src/adns.h
+++ b/src/adns.h
@@ -363,6 +363,9 @@ int adns_init_strcfg(adns_state *newstate_r, adns_initflags flags,
 
 typedef void adns_logcallbackfn(adns_state ads, void *logfndata,
                                const char *fmt, va_list al);
+  /* will be called perhaps several times for each message; when the
+   * message is complete, the string implied by fmt and al will end in
+   * a newline. */
 
 int adns_init_logfn(adns_state *newstate_r, adns_initflags flags,
                    const char *configtext /*0=>use default config files*/,