Add note to stub files used for grouping script docs.

doc/scripts/CMakeLists.txt

@@ -129,6 +129,7 @@ endmacro(REST_TARGET)
 # Schedule Bro scripts for which to generate documentation.
 # Note: the script may be located in a subdirectory off of one of the main
 # directories in BROPATH.  In that case, just list the script as 'foo/bar.bro'
+rest_target(${CMAKE_CURRENT_SOURCE_DIR} example.bro            internal)
 rest_target(${POLICY_SRC_DIR} conn.bro                         user)
 rest_target(${POLICY_SRC_DIR} site.bro                         user)
 rest_target(${POLICY_SRC_DIR} dns.bro                          policy/dns-index)
@@ -137,7 +138,6 @@ rest_target(${POLICY_SRC_DIR} dns/base.bro                     policy/dns-index)
 rest_target(${POLICY_SRC_DIR} dns/consts.bro                   policy/dns-index)
 rest_target(${POLICY_SRC_DIR} dns/detect.bro                   policy/dns-index)
 rest_target(${POLICY_SRC_DIR} dns/passive-replication.bro      policy/dns-index)
-rest_target(${CMAKE_CURRENT_SOURCE_DIR} example.bro            internal)
 
 # Finding out what scripts bro will generate documentation for by default
 # can be done like: `bro --doc-scripts --exec ""`

doc/scripts/source/bifs.rst

@@ -1,4 +1,5 @@
+.. This is a stub doc to which the build process can append.
+
 Built-In Functions (BIFs)
 =========================
 
-Here's a list of all documentation for BIFs that Bro provides:

doc/scripts/source/internal.rst

@@ -1,3 +1,5 @@
+.. This is a stub doc to which the build process can append.
+
 Internal Policy Scripts
 =======================
 

doc/scripts/source/policy/dns-index.rst

@@ -1,3 +1,5 @@
+.. This is a stub doc to which the build process can append.
+
 DNS Policy Scripts
 ==================
 

doc/scripts/source/user.rst

@@ -1,3 +1,5 @@
+.. This is a stub doc to which the build process can append.
+
 Other User-Facing Policy Scripts
 ================================