From 83b659e71af755aeff634d0fa9dc5445fa21fa6c Mon Sep 17 00:00:00 2001 From: Bob Halley Date: Sun, 1 Jan 2017 09:27:58 -0800 Subject: [PATCH] start documenting rdata --- doc/manual.rst | 2 +- doc/rdata-types.rst | 22 ++++++++++++++++++++++ doc/rdata.rst | 8 ++++++++ 3 files changed, 31 insertions(+), 1 deletion(-) create mode 100644 doc/rdata-types.rst create mode 100644 doc/rdata.rst diff --git a/doc/manual.rst b/doc/manual.rst index 5bf893a4..50b1afb3 100644 --- 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 index 00000000..ba8ae414 --- /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 index 00000000..367e9e60 --- /dev/null +++ b/doc/rdata.rst @@ -0,0 +1,8 @@ +.. _rdata: + +DNS Rdata +========= + +.. toctree:: + + rdata-types -- 2.47.3