adns_str* etc.: Return NULL rather than crashing, and docs

[adns.git] / src / adns.h

diff --git a/src/adns.h b/src/adns.h
index 899a7319f0c13e19ac50bf883987c2f567f9fc2c..b8072eeb77b37c9b288eb4ba3615799c369c4507 100644 (file)
--- a/src/adns.h
+++ b/src/adns.h
@@ -1085,8 +1085,11 @@ const char *adns_errtypeabbrev(adns_status st);
  * the abbreviation of the error - eg, for adns_s_timeout it returns
  * "timeout".  adns_errtypeabbrev returns the abbreviation of the
  * error class: ie, for values up to adns_s_max_XXX it will return the
- * string XXX.  You MUST NOT call these functions with status values
- * not returned by the same adns library.
+ * string XXX.
+ *
+ * If you call these functions with status values not actually
+ * returned from other functions in the same adns library, the
+ * returned information may be NULL.
  */
 
 #ifdef __cplusplus