From 1411634cd1dcf7c04cebcf26103ea6aea0038c7f Mon Sep 17 00:00:00 2001
From: Kazu Yamamoto <kazu@iij.ad.jp>
Date: Wed, 4 Sep 2024 14:20:01 +0900
Subject: [PATCH] improving document

---
 Network/Socket/Info.hsc | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/Network/Socket/Info.hsc b/Network/Socket/Info.hsc
index 260b42aa..72f212a1 100644
--- a/Network/Socket/Info.hsc
+++ b/Network/Socket/Info.hsc
@@ -207,7 +207,9 @@ class GetAddrInfo t where
     -- | Resolve a host or service name to one or more addresses.
     -- The 'AddrInfo' values that this function returns contain 'SockAddr'
     -- values that you can pass directly to 'connect' or
-    -- 'bind'.
+    -- 'bind'. Instances for the hidden 'GetAddrInfo' class are lists and
+    -- 'NonEmpty' only. Use of 'NonEmpty' is recommended as getaddrinfo() never
+    -- returns an empty list.
     --
     -- This function is protocol independent.  It can return both IPv4 and
     -- IPv6 address information.