Fix formatting in the protocol BiFs docs
Fix typos and formatting in init-bare.bro and init-default.bro
Correct more typos in init-bare.bro
Fix typos and formatting in the policy/frameworks docs

Also updated some tests related to these changes.
Fix typos and formatting in the policy/protocols docs

Also updated a test related to these changes, and adjusted line numbers.
Fix typos and formatting in the other policy docs
Fix typos and formatting in the events docs
Fix typos and formatting in the notice framework docs
Fix typos and formatting in the signature framework docs
Make RFC links in the docs more consistent
Do not include documentation of commented-out items

Some documentation of commented-out items was being output to HTML,
which was causing that documentation to be merged with the
documentation of the next item.  Fixed by changing "##" to "#" so
that the doc comments are not included in the HTML.
Fix doc comment so the text gets included in the HTML
Add more script package README files

The text from these README files appears on the "Bro Script Packages"
page after building the documentation.
Document which Bro script vars are set by BroControl
Fix minor formatting problem in NEWS.
Add NEWS about incompatible local.bro changes, addresses BIT-1047.
Fix record coercion tolerance of optional fields.

There were cases where coercing a record value with an uninitialized
field could cause a null pointer dereference even though the field
can validly be unset since it has &optional.
Merge remote-tracking branch 'origin/topic/dnthayer/doc-changes-for-2.2'

* origin/topic/dnthayer/doc-changes-for-2.2:
  Document which Bro script vars are set by BroControl
  Add more script package README files
  Fix doc comment so the text gets included in the HTML
  Do not include documentation of commented-out items
  Make RFC links in the docs more consistent
  Fix typos and formatting in the signature framework docs
  Fix typos and formatting in the notice framework docs
  Fix typos and formatting in the events docs
  Fix typos and formatting in the other policy docs
  Fix typos and formatting in the policy/protocols docs
  Fix typos and formatting in the policy/frameworks docs
  Correct more typos in init-bare.bro
  Fix typos and formatting in init-bare.bro and init-default.bro
  Fix formatting in the protocol BiFs docs
Merge remote-tracking branch 'origin/fastpath'

* origin/fastpath:
  Fix record coercion tolerance of optional fields.
  Add NEWS about incompatible local.bro changes, addresses BIT-1047.
  Fix minor formatting problem in NEWS.
Add NEWS about new features of broctl and upgrade info