From: ian <ian>
Date: Sun, 19 Dec 2004 20:59:18 +0000 (+0000)
Subject: document log message format
X-Git-Tag: before-srv-2006-04-04~10^2~1
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=commitdiff_plain;h=4db1559fd37ee7d078383217228124cf365ef3a4;p=adns.git

document log message format
---

diff --git a/src/adns.h b/src/adns.h
index 5102446..9be8b68 100644
--- a/src/adns.h
+++ b/src/adns.h
@@ -363,9 +363,11 @@ 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
+  /* 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. */
+   * a newline.  Log messages start with `adns debug:' or `adns
+   * warning:' or `adns:' (for errors), or `adns debug [PID]:'
+   * etc. if adns_if_logpid is set. */
 
 int adns_init_logfn(adns_state *newstate_r, adns_initflags flags,
 		    const char *configtext /*0=>use default config files*/,