zeek/doc
Robin Sommer b096168318 Merge branch 'topic/robin/tunnels-merge'
* topic/robin/tunnels-merge: (51 commits)
  Updating baselines and NEWS.
  Remove &synchronized from Tunnel::active table.
  Refactor of interal tunnel analysis code.
  Add state management of NetSessions's IP tunnel map.
  Add "encap_hdr_size" option back in.
  Script-layer tunnel interface cleanup.
  Fix performance problem checking packet encapsulation. (addresses #830)
  Adding a SOCKS test case.
  Updating DataSeries baselines.
  Moving my todos over to the tracker ticket.
  Extend weird names that occur in core packet processing during decapsulation.
  Add Teredo analysis option to reduce false positive decapsulation.
  Just some cleanup/documentation of new tunnel-handling code.
  Memory leak fixes
  Add a config.h definition for IPPROTO_IPV4.
  Add AYIYA tunnel decapsulation unit test.
  Add Teredo-specific events.
  Refactor some of the NetSessions routines that recurse on IP packets.
  Add independent options to toggle the different decapsulation methods
  Add more sanity checks before recursing on encapsulated IP packets.
  ...

Conflicts:
	src/event.bif
2012-06-19 13:21:31 -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 'master' into topic/tunnels 2012-05-31 16:13:14 -05: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 Merge remote-tracking branch 'origin/topic/bernhard/input-threads-merge' 2012-06-15 15:39:58 -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 Add @load-sigs directive for loading signature files (addresses #551). 2012-06-01 14:10:23 -05: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.