fix doco bugs; note need to match relativize between dns.query.xfr() and dns.zone...

diff --git a/dns/query.py b/dns/query.py
index 86df19c9f2cfd91bf617a6033fe35159e2c2c11e..943d14e962d703f3e7e8c435c910595dc90bee58 100644 (file)
--- a/dns/query.py
+++ b/dns/query.py
@@ -86,7 +86,7 @@ def udp(q, where, timeout=None, port=53, af=None, source=None, source_port=0):
     @type source: string
     @param source_port: The port from which to send the message.
     The default is 0.
-    @type port: int"""
+    @type source_port: int"""
     
     wire = q.to_wire()
     if af is None:
@@ -179,7 +179,7 @@ def tcp(q, where, timeout=None, port=53, af=None, source=None, source_port=0):
     @type source: string
     @param source_port: The port from which to send the message.
     The default is 0.
-    @type port: int"""
+    @type source_port: int"""
     
     wire = q.to_wire()
     if af is None:
@@ -245,7 +245,8 @@ def xfr(where, zone, rdtype=dns.rdatatype.AXFR, rdclass=dns.rdataclass.IN,
     @param keyname: The name of the TSIG key to use
     @type keyname: dns.name.Name object or string
     @param relativize: If True, all names in the zone will be relativized to
-    the zone origin.
+    the zone origin.  It is essential that the relativize setting matches
+    the one specified to dns.zone.from_xfr().
     @type relativize: bool
     @param af: the address family to use.  The default is None, which
     causes the address family to use to be inferred from the form of of where.
@@ -260,7 +261,7 @@ def xfr(where, zone, rdtype=dns.rdatatype.AXFR, rdclass=dns.rdataclass.IN,
     @type source: string
     @param source_port: The port from which to send the message.
     The default is 0.
-    @type port: int"""
+    @type source_port: int"""
 
     if isinstance(zone, str):
         zone = dns.name.from_text(zone)