From ae06072e8843da76478989707543d0946b3efd24 Mon Sep 17 00:00:00 2001
From: Brad House <brad@brad-house.com>
Date: Mon, 11 Dec 2023 07:13:47 -0500
Subject: [PATCH] reference alternative to ares_getsock() in docs

---
 docs/ares_getsock.3 | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/ares_getsock.3 b/docs/ares_getsock.3
index dc306275..6d040c03 100644
--- a/docs/ares_getsock.3
+++ b/docs/ares_getsock.3
@@ -55,6 +55,9 @@ extract the information appropriately:
 This function was added in c-ares 1.3.1 and deprecated in c-ares 1.20.0 due to
 the implementation of \fBARES_OPT_MAX_UDP_QUERIES\fP which makes it likely to
 exceed 16 open file descriptors.
+
+It is recommended to use socket state callbacks (\fBARES_OPT_SOCK_STATE_CB\fP)
+registered via \fBares_init_options(3)\fP.
 .SH SEE ALSO
 .BR ares_timeout (3),
 .BR ares_fds (3),