Update lua2.rst: dns_get_all_domains() args and notes update

1. It requires `DNSName, domaininfo` pair instead of `string, domaininfo`
2. The function is definitely not optimal if one uses lua2 backend to serve a zone, since without it pdns will ignore the zone and requets will never reach this backend. Figuring this out __was__ painful.

Signed-off-by: Peter Gervai <grin@grin.hu>

diff --git a/docs/backends/lua2.rst b/docs/backends/lua2.rst
index 76f8174fd8dd7faa9b12174170065b5e62f85b72..d6d835ed53470d7b8ec927f33bd89c824a20b567 100644 (file)
--- a/docs/backends/lua2.rst
+++ b/docs/backends/lua2.rst
@@ -119,13 +119,16 @@ NOTES:
 Get domain information for all domains.
 
 OUTPUT:
- Return false if not supported or found; otherwise, return a table of string,
- domaininfo. See :ref:`dns_get_domaininfo() <backends_lua2_dns_get_domaininfo>`.
+ Return false if not supported or found; otherwise, return a table of 
+`{ [DNSName] = domaininfo, … }`. See :ref:`dns_get_domaininfo() <backends_lua2_dns_get_domaininfo>`.
 
 NOTES:
  This function is **optional**, except if you need primary functionality. It
  is required if you want to be able to enable the zone cache or to search
  records.
+ It is also required if you want to serve a zone **without a SOA in _another_ backend**: if you
+ don't list your zone here pdns server will reject it (as unknown zone) and the requests will
+ never reach lua2 backend.
 
 ``dns_get_domain_metadata(domain, kind)``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~