BIND 10 #2305: Document bindctl in the BIND 10 guide

[BIND 10 Development]

#2305: Document bindctl in the BIND 10 guide
-------------------------------------+-------------------------------------
                   Reporter:  jreed  |                 Owner:  UnAssigned
                       Type:         |                Status:  reviewing
  defect                             |             Milestone:
                   Priority:         |  Sprint-20121120
  medium                             |            Resolution:
                  Component:  bind-  |             Sensitive:  0
  ctl                                |           Sub-Project:  Core
                   Keywords:         |  Estimated Difficulty:  7
            Defect Severity:  N/A    |           Total Hours:  0
Feature Depending on Ticket:         |
        Add Hours to Ticket:  0      |
                  Internal?:  0      |
-------------------------------------+-------------------------------------

Comment (by jinmei):

 I've only gone through the text, performing sanity checks.  I didn't
 confirm whether each and every example actually works as documented by
 hand, for example.

 Specific comments:

 - I guess this change may be worth a changelog entry.  But I'd leave
   it to you.
 - I suggest the documentation issue of #2449 is addressed within
   ticket, either in the new section 7 or as part of installation.
 - some concepts seem to be used before the definition, such as "named
 set".
 - 7.6 Configuration commands: "but similar to modules" should be
   "but similar to commands"?
 - 7.6.1. List of configuration commands: "must be (in JSON format)"
   why in parentheses?  and it doesn't seem to parse well.  Maybe
   "must be specified (in JSON format)"
 - 7.6.2. Configuration data types: the use of ';' and ',' is not
   consistent.
 - maps: it doesn't explain how to remove stuff from a map.
 - the example at the last of "named set" doesn't seem to make much
   sense.
 - 7.7.2. Notes on execute scripts: "However; as module" should be
   "However, as module"?
 - 7.7.2. Notes on execute scripts: I was not sure how the second
   paragraph relates to execute scripts.
 - there's a redundant space at the end of line:
 {{{#!diff
 +Module  Boss   Master process
 }}}
   I'm not sure if this is an issue of XML or in the output of bindctl.
   In either case, the XML doc should be fixed.  If it's also a bindctl
   issue it should also be fixed.

-- 
Ticket URL: <http://bind10.isc.org/ticket/2305#comment:5>
BIND 10 Development <http://bind10.isc.org>
BIND 10 Development