Minor reorganization of broctl README to avoid redundancy

Reorganized a few sections of the document to avoid having the same
information in multiple locations.  Made the use of prefix more consistent
in the examples.  Corrected several typos.
Updating submodule(s).

 [nomail]
Remove unused Broxygen-style script comments.
Merge remote-tracking branch 'origin/topic/jsiwek/misc-fixes'

* origin/topic/jsiwek/misc-fixes:
  Remove unused Broxygen-style script comments.
Merge remote-tracking branch 'origin/master' into topic/dnthayer/doc-updates
Merge remote-tracking branch 'origin/topic/dnthayer/doc-updates'

* origin/topic/dnthayer/doc-updates:
  Minor reorganization of broctl README to avoid redundancy
Merge remote-tracking branch 'origin/master' into topic/dnthayer/test-improvements