start documenting rdata

diff --git a/doc/manual.rst b/doc/manual.rst
index 5bf893a4711200cf817ad0aaec22f5f555ea7c41..50b1afb33c26675b18670a23dfd29b76f972d966 100644 (file)
--- a/doc/manual.rst
+++ b/doc/manual.rst
@@ -7,4 +7,4 @@ Dnspython Manual
 
    py2vs3
    name
-
+   rdata

diff --git a/doc/rdata-types.rst b/doc/rdata-types.rst
new file mode 100644 (file)
index 0000000..ba8ae41
--- /dev/null
+++ b/doc/rdata-types.rst
@@ -0,0 +1,22 @@
+.. _rdata-types:
+
+Rdata classes and types
+-----------------------
+
+Sets of typed data can be associated with a given name.  A single typed
+datum is called an *rdata*.  The type of an rdata is specified by its
+*rdataclass* and *rdatatype*.  The class is almost always `IN`, the Internet
+class, and may often be omitted in the dnspython APIs.
+
+The ``dns.rdataclass`` module provides constants for each defined
+rdata class, as well as some helpful functions.  The ``dns.rdatatype``
+module does the same for rdata types.  Examples of the constants are::
+
+  dns.rdataclass.IN
+  dns.rdatatype.AAAA
+
+.. automodule:: dns.rdataclass
+   :members:
+  
+.. automodule:: dns.rdatatype
+   :members:

diff --git a/doc/rdata.rst b/doc/rdata.rst
new file mode 100644 (file)
index 0000000..367e9e6
--- /dev/null
+++ b/doc/rdata.rst
@@ -0,0 +1,8 @@
+.. _rdata:
+
+DNS Rdata
+=========
+
+.. toctree::
+
+   rdata-types