Fix missing references [#1193]

diff --git a/dns/edns.py b/dns/edns.py
index ef57fbe93dfbceb8c430e9de5aed198bfc36dc32..8eebf9018a45982d4c36456f3866218553884b58 100644 (file)
--- a/dns/edns.py
+++ b/dns/edns.py
@@ -33,6 +33,8 @@ import dns.wire
 
 
 class OptionType(dns.enum.IntEnum):
+    """EDNS option type codes"""
+
     #: NSID
     NSID = 3
     #: DAU
@@ -326,6 +328,8 @@ class ECSOption(Option):  # lgtm[py/missing-equals]
 
 
 class EDECode(dns.enum.IntEnum):
+    """DNS EDE codes"""
+
     OTHER = 0
     UNSUPPORTED_DNSKEY_ALGORITHM = 1
     UNSUPPORTED_DS_DIGEST_TYPE = 2

diff --git a/dns/wire.py b/dns/wire.py
index 9f9b1573d521a924a43dde6c18a59912612798d8..cd027fa16a0f2592244b55014139f1970855ac47 100644 (file)
--- a/dns/wire.py
+++ b/dns/wire.py
@@ -9,7 +9,16 @@ import dns.name
 
 
 class Parser:
+    """Helper class for parsing DNS wire format."""
+
     def __init__(self, wire: bytes, current: int = 0):
+        """Initialize a Parser
+
+        *wire*, a ``bytes`` contains the data to be parsed, and possibly other data.
+        Typically it is the whole message or a slice of it.
+
+        *current*, an `int`, the offset within *wire* where parsing should begin.
+        """
         self.wire = wire
         self.current = 0
         self.end = len(self.wire)

diff --git a/doc/Makefile b/doc/Makefile
index acf8f99c97378681e6e7a6d7b92bb91a5f9954a3..aad553294c43eae13e22aa96833f80fb0aee8aaf 100644 (file)
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -17,4 +17,4 @@ help:
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-       @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+       @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) -n $(O)

diff --git a/doc/message-edns.rst b/doc/message-edns.rst
index 21d106db0210a88a7c06e45e6a6a5a0b9ae5ff16..8424fa13bcb7503365e9ad2082b5c5a467ddb4d7 100644 (file)
--- a/doc/message-edns.rst
+++ b/doc/message-edns.rst
@@ -9,6 +9,8 @@ treated much like Rdata.  For example, if dnspython encounters the EDNS
 ``ECS`` option code when parsing a DNS wire format message, it
 will create a ``dns.edns.ECSOption`` object to represent it.
 
+.. autoclass:: dns.edns.OptionType
+
 .. autodata:: dns.edns.NSID
 .. autodata:: dns.edns.DAU
 .. autodata:: dns.edns.DHU
@@ -29,6 +31,8 @@ will create a ``dns.edns.ECSOption`` object to represent it.
 .. autoclass:: dns.edns.ECSOption
    :members:
 
+.. autoclass:: dns.edns.EDECode
+
 .. autoclass:: dns.edns.EDEOption
    :members:
 

diff --git a/doc/utilities.rst b/doc/utilities.rst
index 88c1f72e4eb7964c6eb39f08a9cda71a2eae9a8f..85de5071df0c2413ba8558ed3978b570b932fd79 100644 (file)
--- a/doc/utilities.rst
+++ b/doc/utilities.rst
@@ -19,3 +19,6 @@ Miscellaneous Utilities
 
 .. automodule:: dns.version
    :members:
+
+.. automodule:: dns.wire
+   :members: