[bind10-dev] guide comments

[JINMEI Tatuya / 神明達哉]

At Wed, 14 Nov 2012 10:22:59 -0600 (CST),
"Jeremy C. Reed" <jreed at isc.org> wrote:

> 1) The guide documents Auth/datasources.  Is this for xfr* use only? I 
> think it needs some note about the status in the guide. Please suggest 
> (or commit) something.

On looking into it closer, I guess we can now ignore it (and can
remove from the guide).  As far as I can see, xfrin has code that
refers to the Auth/datasources config, but that code isn't used at
all.

> 2) Two incomplete sentences: "bindctl. To reload a zone, you the same 
> command as above."  What was this supposed to say?

This looks like (at least partially) an editorial error introduced in
a5813028 (try git show a5813028 bind10-guide.xml).  I believe
we can just remove the "<command>bindctl.</command>".  I'm not sure
about "To reload a zone, you the same command as above."  This
sentence is broken, and seems to have been always broken.  Ask Michal,
who first wrote this (would-be) sentence according to the history.

> 3) Auth loadzone is documented twice. One says it has:
> 
>    datasrc optionally defines the type of datasource (it defaults to
>    "memory"). 
> 
> I think that no longer exists, but is it planned?

It seems to be obsolete.  I guess it would be nice (or even necessary)
for loadzone to be able to specify a specific data source (or a view
if/when we support it), but there's no specific plan for it AFAIK.
And in any case that's a separate issue.

---
JINMEI, Tatuya