This commit clarifies the behaviour of ares_cancel() with respect to
callbacks and adds missing documentation of ARES_ECANCELLED to the man
pages of the affected functions.
the callbacks for each pending query on the channel, passing a status of
.BR ARES_ECANCELLED .
These calls give the callbacks a chance to clean up any state which
-might have been stored in their arguments.
+might have been stored in their arguments. If such a callback invocation adds
+a new request to the channel, that request will \fInot\fP be cancelled by the
+current invocation of \fBares_cancel\fP.
.SH SEE ALSO
.BR ares_init (3)
.BR ares_destroy (3)
.B ARES_ENOMEM
Memory was exhausted.
.TP 19
+.B ARES_ECANCELLED
+The query was cancelled.
+.TP 19
.B ARES_EDESTRUCTION
The name service channel
.I channel
.B ARES_ENOMEM
Memory was exhausted.
.TP 19
+.B ARES_ECANCELLED
+The query was cancelled.
+.TP 19
.B ARES_EDESTRUCTION
The name service channel
.I channel
.B ARES_ENOMEM
Memory was exhausted.
.TP 19
+.B ARES_ECANCELLED
+The query was cancelled.
+.TP 19
.B ARES_EDESTRUCTION
The name service channel
.I channel
.B ARES_ENOMEM
Memory was exhausted.
.TP 19
+.B ARES_ECANCELLED
+The query was cancelled.
+.TP 19
.B ARES_EDESTRUCTION
The name service channel
.I channel
.B ARES_ENOMEM
Memory was exhausted.
.TP 19
+.B ARES_ECANCELLED
+The query was cancelled.
+.TP 19
.B ARES_EDESTRUCTION
The name service channel
.I channel
.B ARES_ENOMEM
Memory was exhausted.
.TP 19
+.B ARES_ECANCELLED
+The query was cancelled.
+.TP 19
.B ARES_EDESTRUCTION
The name service channel
.I channel