zeek/doc
Robin Sommer a40b00d4ab Merge branch 'topic/robin/intel-framework-merge'
* topic/robin/intel-framework-merge: (22 commits)
  Fixing tests after intel-framework merge.
  Extracting URLs from message bodies over SMTP and sending them to Intel framework.
  Small comment updates in the Intel framework CIF support.
  Intelligence framework documentation first draft.
  Only the manager tries to read files with the input framework now.
  Initial support for Bro's Intel framework with the Collective Intelligence Framework.
  Initial API for Intel framework is complete.
  Fixed an issue with cluster data distribution.
  Updating some intel framework test baselines.
  Reworked cluster intelligence data distribution mechanism and fixed tests.
  Lots more intelligence checking in SMTP traffic.
  Added intelligence check for "Received" path checking and a bit of reshuffling.
  Added sources to the intel log.
  Fixing a problem with intel distribution on clusters.
  Updated intel framework test to include matching.
  Restructuring the scripts that feed data into the intel framework slightly.
  One test for cluster transparency of the intel framework.
  Fixed a cluster support bug.
  Intelligence framework checkpoint
  Major updates to fix the Intel framework API.
  ...

Closes #914.
2012-11-05 16:00:38 -08:00
..
_static Tweaks. 2012-01-09 18:28:43 -08:00
_templates A set of script-reference polishing. 2012-01-09 18:04:34 -08:00
bin Changes to Broxygen master script package index 2011-12-02 13:59:33 -06:00
components Submodule README conformity changes 2011-11-29 12:18:42 -06:00
ext Remove deprecated attribute &disable_print_hook 2012-09-26 16:47:51 -05:00
images Adapt more www niceties to broxygen (stylesheets, pygments); add more docs 2011-11-15 15:39:31 -06:00
scripts Merge branch 'topic/robin/intel-framework-merge' 2012-11-05 16:00:38 -08:00
.gitignore A set of script-reference polishing. 2012-01-09 18:04:34 -08:00
CHANGES Fix documentation interlinkage and normalize console directive bodies. 2011-11-15 16:27:06 -06:00
cluster.rst Fix minor typos in documentation 2012-02-02 18:48:23 -06:00
CMakeLists.txt Add missing doc targets to top Makefile; remove old doc/Makefile. (fixes #705) 2011-12-01 09:16:38 -06:00
conf.py.in A set of script-reference polishing. 2012-01-09 18:04:34 -08:00
faq.rst Move upgrade instructions to INSTALL document 2012-10-23 13:51:43 -05:00
geoip.rst Adapt more www niceties to broxygen (stylesheets, pygments); add more docs 2011-11-15 15:39:31 -06:00
index.rst Add version-specific upgrade info 2012-10-24 18:25:27 -05:00
input.rst rename the update_finished event to end_of_data and make it fire in 2012-10-10 11:51:20 -07:00
INSTALL.rst Adapt more www niceties to broxygen (stylesheets, pygments); add more docs 2011-11-15 15:39:31 -06:00
intel.rst Merge remote-tracking branch 'origin/topic/seth/intel-framework' 2012-11-01 08:21:52 -07:00
logging-dataseries.rst Fix minor typos in dataseries documentation 2012-07-03 18:20:52 -05:00
logging-elasticsearch.rst More documentation updates. 2012-07-20 11:02:09 -04:00
logging.rst Linking ES docs into logging document. 2012-08-21 08:42:09 -07:00
notice.rst Fix minor typos in documentation 2012-02-02 18:48:23 -06:00
quickstart.rst Reorganize install documentation 2012-10-22 17:56:00 -05:00
README corrected some minor typos 2012-01-11 13:02:12 -06:00
reporting-problems.rst Fix minor typos in documentation 2012-02-02 18:48:23 -06:00
signatures.rst Add IPv6 support to signature header conditions. 2012-10-17 11:11:51 -05:00
upgrade.rst Add version-specific upgrade info 2012-10-24 18:25:27 -05:00

Documentation
=============

This directory contains Bro documentation in reStructuredText format
(see http://docutils.sourceforge.net/rst.html).

It is the root of a Sphinx source tree and can be modified to add more
common/general documentation, style sheets, JavaScript, etc.  The Sphinx
config file is produced from ``conf.py.in``, and can be edited to change
various Sphinx options.

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.  Other extensions can be added in
a similar fashion.

Either the ``make doc`` or ``make broxygen`` targets in the top-level
Makefile can be used to locally render the reST files into HTML.
Those targets depend on:

* Python interpreter >= 2.5
* `Sphinx <http://sphinx.pocoo.org/>`_ >= 1.0.1

After completion, HTML documentation is symlinked in ``build/html``.

There's also ``make docclean`` and ``make broxygenclean`` targets to
clean the resulting documentation.

Notes for Writing Documentation
-------------------------------

* If you want to refer to a document that's part of the
  distribution, it currently needs to be copied or otherwise symlinked
  somewhere in to this Sphinx source tree. Then, it can be referenced
  in a toc tree or with the :doc: role.  Use the :download: role to
  refer to static files that will not undergo sphinx rendering.

* If you want to refer to a page on the Bro web site, use an HTTP URL.

Guidelines
----------

TODO.