diff --git a/src/net/net.go b/src/net/net.go
index 82dc222de1..917bef4d54 100644
--- a/src/net/net.go
+++ b/src/net/net.go
@@ -134,6 +134,8 @@ type Conn interface {
 
 	// Close closes the connection.
 	// Any blocked Read or Write operations will be unblocked and return errors.
+	// Close may or may not block until any buffered data is sent;
+	// for TCP connections see [*TCPConn.SetLinger].
 	Close() error
 
 	// LocalAddr returns the local network address, if known.