modules/policy: deduplicate doc

diff --git a/modules/policy/README.rst b/modules/policy/README.rst
index 3260b27f8ef78402fc558c0fdfa5ce78b09dad89..1d87b48878f4e83f19976bf9e36f4aeccc419b47 100644 (file)
--- a/modules/policy/README.rst
+++ b/modules/policy/README.rst
@@ -28,16 +28,6 @@ A *filter* selects which queries will be affected by specified Actions_. There a
 
    Always applies the action.
 
-.. function:: domains(action, domain_table)
-
-   Applies the action if query name matches one the domains in the table.
-
-.. note:: For speed this filter requires domain names in the DNS wire format, not textual representation, so each label in the name must be prefixed with its length. Always use convenience function :func:`policy.todnames` for automatic conversion from a string! For example:
-
-   .. code-block:: lua
-
-      policy.add(policy.domains(policy.DENY, policy.todnames({'example.com', 'example.net'})))
-
 .. function:: pattern(action, pattern)
 
    Applies the action if query name matches a `Lua regular expression <http://lua-users.org/wiki/PatternsTutorial>`_.
@@ -52,6 +42,10 @@ A *filter* selects which queries will be affected by specified Actions_. There a
 
       policy.add(policy.suffix(policy.DENY, policy.todnames({'example.com', 'example.net'})))
 
+.. function:: domains(action, domain_table)
+
+   Like :func:`policy.suffix` match, but the queried name must match exactly, not just its suffix.
+   
 .. function:: suffix_common(action, suffix_table[, common_suffix])
 
   :param action: action if the pattern matches query name