zeek/doc
Jon Siwek 0d685efbf5 Add Broker::peer_counts_as_iosource option
Disabling this option allows one to read pcaps, but still initiate
Broker peerings and automatically exit when done processing the pcap
file.  The default behavior would normally cause Broker::peer() to
prevent shutting the process down even after done reading the pcap.
2019-01-16 19:03:35 -06:00
..
_templates Use Sphinx RTD theme for user manual 2018-12-19 16:32:03 -06:00
cluster Merge remote-tracking branch 'origin/rtd-test' 2019-01-10 14:08:40 -06:00
components Replace some bro.org usages with zeek.org 2019-01-04 17:51:25 -06:00
configuration Remove "contents" Sphinx directive usages 2018-12-19 17:28:17 -06:00
devel Remove some Bro usages in main TOC entries 2018-12-19 17:38:19 -06:00
examples Reorganize documentation index 2019-01-10 15:46:58 -06:00
ext Use sourcecode Sphinx directive more widely 2018-12-19 17:04:26 -06:00
frameworks Remove "contents" Sphinx directive usages 2018-12-19 17:28:17 -06:00
images Adapt more www niceties to broxygen (stylesheets, pygments); add more docs 2011-11-15 15:39:31 -06:00
install Merge remote-tracking branch 'origin/rtd-test' 2019-01-10 14:08:40 -06:00
intro Remove "contents" Sphinx directive usages 2018-12-19 17:28:17 -06:00
quickstart Merge remote-tracking branch 'origin/rtd-test' 2019-01-10 14:08:40 -06:00
script-reference GH-213: change type of vector for-loop index to a count 2019-01-14 18:04:30 -06:00
scripts Add Broker::peer_counts_as_iosource option 2019-01-16 19:03:35 -06:00
.gitignore A set of script-reference polishing. 2012-01-09 18:04:34 -08:00
CMakeLists.txt Add RTD pdf format 2019-01-10 13:11:57 -06:00
conf.py Add RTD yaml config file 2019-01-10 12:55:35 -06:00
index.rst Reorganize documentation index 2019-01-10 15:46:58 -06:00
LICENSE Update documentation license 2016-10-06 11:35:31 -07:00
README Add a make livehtml target 2018-12-19 17:25:59 -06:00

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

This directory contains 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
documentation, style sheets, JavaScript, etc.  The Sphinx config file
is ``conf.py``.

There is also a custom Sphinx domain implemented in ``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.

The ``make doc`` target in the top-level Makefile can be used to locally
render the reST files into HTML.  That target depends on:

* Python interpreter >= 2.7
* `Sphinx <http://sphinx-doc.org/>`_
* `Read the Docs Sphinx Theme <https://github.com/rtfd/sphinx_rtd_theme>`_

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

There's also a ``make livehtml`` target in the top-level Makefile that
is useful for editing the reST files and seeing changes rendered out live
to a separate HTML browser.