commit 719af92e108ea3b31729cb09077673b8f13905d2
author Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Thu Aug 26 12:54:52 2021 -0700
committer GitHub <noreply@github.com> Thu Aug 26 12:54:52 2021 -0700
tree adcf3ecba9349a802b86dd7bfe5d5f8d7cddec09
parent 9a79242567d79f42ad1a953cce2b1c4a94df23ea

bpo-40635: Fix getfqdn() docstring and docs (GH-27971)


Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit fdcb675eed47b1f6054fae381af4388b16a6fff4)

Co-authored-by: andrei kulakov <andrei.avk@gmail.com>

Lib/socket.py

diff --git a/Lib/socket.py b/Lib/socket.py
index fc11eb7..63ba0ac 100755
--- a/Lib/socket.py
+++ b/Lib/socket.py
@@ -782,8 +782,9 @@ def getfqdn(name=''):
     An empty argument is interpreted as meaning the local host.
 
     First the hostname returned by gethostbyaddr() is checked, then
-    possibly existing aliases. In case no FQDN is available, hostname
-    from gethostname() is returned.
+    possibly existing aliases. In case no FQDN is available and `name`
+    was given, it is returned unchanged. If `name` was empty or '0.0.0.0',
+    hostname from gethostname() is returned.
     """
     name = name.strip()
     if not name or name == '0.0.0.0':