improve documentation

Author: daxlab

Lib/ssl.py

@@ -234,8 +234,7 @@ def _dnsname_match(dn, hostname):
 
     wildcards = leftmost.count('*')
     if wildcards == 1 and len(leftmost) > 1:
-        """ Only match wildcard in leftmost segment.
-        """
+        # Only match wildcard in leftmost segment.
         raise CertificateError(
             "wildcard can only be present in left most segment: " + repr(dn))
 

Lib/test/test_ssl.py

@@ -512,7 +512,8 @@ def fail(cert, hostname):
         fail(cert, 'Xa.com')
         fail(cert, '.a.com')
 
-        # only match wildcard in left-most segment
+        # only match wildcards when they are the only thing
+        # in left-most segment
         cert = {'subject': ((('commonName', 'f*.com'),),)}
         fail(cert, 'foo.com')
         fail(cert, 'f.com')