Adapt more www niceties to broxygen (stylesheets, pygments); add more docs

doc/scripts/CMakeLists.txt

@@ -121,6 +121,7 @@ macro(REST_TARGET srcDir broInput)
         ARGS -rf .state *.log *.rst
         DEPENDS bro
         DEPENDS ${absSrcPath}
+        WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
         COMMENT "[Bro] Generating reST docs for ${broInput}"
     )
 

doc/scripts/README

@@ -15,29 +15,10 @@ by CMake:
     ``build/`` directory inside ``reST`` (a symlink to
     ``doc/scripts/rest_output``).
 
-``doc``
-
-    This target depends on a Python interpreter (>=2.5) and
-    `Sphinx <http://sphinx.pocoo.org/>`_ being installed.  Sphinx can be
-    installed like::
-
-        > sudo easy_install sphinx
-
-    This target will first build ``restdoc`` target and then copy the
-    resulting reST files as an input directory to Sphinx.
-
-    After completion, HTML documentation can be located in the CMake
-    ``build/`` directory inside ``html`` (a symlink to
-    ``doc/scripts/out/html``)
-
 ``restclean``
 
     This target removes any reST documentation that has been generated so far.
 
-``docclean``
-
-    This target removes Sphinx inputs and outputs from the CMake ``build/`` dir.
-
 The ``genDocSourcesList.sh`` script can be run to automatically generate
 ``DocSourcesList.cmake``, which is the file CMake uses to define the list
 of documentation targets.  This script should be run after adding new
@@ -54,18 +35,10 @@ script's name to the blacklist, then append a ``rest_target()`` to the
 ``statictext`` variable where the first argument is the source directory
 containing the policy script to document, the second argument is the file
 name of the policy script, and the third argument is the path/name of a
-pre-created reST document in the ``source/`` directory to which the
+pre-created reST document in the ``../`` source directory to which the
 ``make doc`` process can append script documentation references.  This
 pre-created reST document should also then be linked to from the TOC tree
-in ``source/index.rst``.
-
-The Sphinx source tree template in ``source/`` can be modified to add more
-common/general documentation, style sheets, JavaScript, etc.  The Sphinx
-config file is produced from ``conf.py.in``, so that can be edited to change
-various Sphinx options, like setting the default HTML rendering theme.
-There is also a custom Sphinx domain implemented in ``source/ext/bro.py``
-which adds some reST directives and roles that aid in generating useful
-index entries and cross-references.
+in ``../index.rst``.
 
 See ``example.bro`` for an example of how to document a Bro script such that
 ``make doc`` will be able to produce reST/HTML documentation for it.