Document the issue with host/port defaults and endpoints.

jwp · jwp · commit 05ee2b083527 · 2020-09-18T11:32:55.000-07:00
diff --git a/postgresql/driver/dbapi20.py b/postgresql/driver/dbapi20.py
@@ -401,6 +401,9 @@ def rollback(self):
 def connect(**kw):
 	"""
 	Create a DB-API connection using the given parameters.
+
+	Due to the way defaults are populated, when connecting to a local filesystem socket
+	using the `unix` keyword parameter, `host` and `port` must also be set to ``None``.
 	"""
 	std_params = pg_param.collect(prompt_title = None)
 	params = pg_param.normalize(
