zeek/doc
Robin Sommer c0e0481af2 Merge branch 'topic/robin/input-threads-merge'
* topic/robin/input-threads-merge: (130 commits)
  And now it even compiles after my earlier changes.
  A set of input framework refactoring, cleanup, and polishing.
  another small memory leak in ascii reader:
  and another small memory leak when using streaming reads.
  fix another memory lead (when updating tables).
  Input framework merge in progress.
  filters have been called streams for eternity. And I always was too lazy to change it everywhere...
  reactivate network_time check in threading manager. previously this line made all input framework tests fail - it works now. Some of the other recent changes of the threading manager must have fixed that problem.
  fix up the executeraw test - now it works for the first time and does not always fail
  baselines for the autostart removal.
  remove last remnants of autostart, which has been removed for quite a while.
  make input framework source (hopefully) adhere to the usual indentation style. No functional changes.
  fix two memory leaks which occured when one used filters.
  update description to current interface.
  rename a couple of structures and make the names in manager fit the api more.
  fix memory leak in tables and vectors that are read into tables
  fix missing get call for heart beat in benchmark reader.
  fix heart_beat_interval -- initialization in constructor does not work anymore (probably due to change in init ordering?)
  fix memory leak for tables... nearly completely.
  fix a couple more leaks. But - still leaking quite a lot with tables.
  ...
2012-05-30 19:12:18 -07: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 A set of script-reference polishing. 2012-01-09 18:04:34 -08: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/input-threads-merge' 2012-05-30 19:12:18 -07: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 Fix minor typos in documentation 2012-02-02 18:48:23 -06:00
geoip.rst Adapt more www niceties to broxygen (stylesheets, pygments); add more docs 2011-11-15 15:39:31 -06:00
index.rst Merge remote-tracking branch 'origin/master' into topic/bernhard/input 2012-01-12 11:07:12 -08:00
input.rst update description to current interface. 2012-04-16 14:49:24 -07:00
INSTALL.rst Adapt more www niceties to broxygen (stylesheets, pygments); add more docs 2011-11-15 15:39:31 -06:00
logging-dataseries.rst Some tweaks to the DS doc. 2012-05-25 08:31:06 -07:00
logging.rst Linking in the DS docs. 2012-05-17 12:47:30 -07:00
notice.rst Fix minor typos in documentation 2012-02-02 18:48:23 -06:00
quickstart.rst GeoIP installation documentation update. 2012-02-21 16:13:08 -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 Fix minor typos in documentation 2012-02-02 18:48:23 -06:00
upgrade.rst Fix minor typos in documentation 2012-02-02 18:48:23 -06: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.