You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
suricata/doc/userguide
Juliana Fajardini 67af1504b3 devguide: drop use of mscgen script in builds/make
Currently, it seems easier to upload the diagram images to git than to
try to make the image generation script work with out of the tree builds
and other corner cases.

This means, however, that one must activelly remember to update msc
diagram files, run the script and re-add new png files, if those ever
need to be updated. To raise awareness to that, a watermark was added
to the diagram images.

Also removed configuration steps that added mscgen as dependency
(locally and for workflow builds and readthedocs).
3 years ago
..
3rd-party-integration doc/userguide: new 3rd party section, add bluecoat 7 years ago
_static doc: Add suricata.css to allow for some custom styling 8 years ago
capture-hardware napatech: Added comment indicating that hba will be deprecated 5 years ago
configuration Doc: Fix typo in documentation of suricata.yaml. 4 years ago
devguide devguide: drop use of mscgen script in builds/make 3 years ago
file-extraction http2: allow filestore to work with HTTP2 5 years ago
licenses doc: convert fancy quotes to straight quotes 6 years ago
lua userguide: rename pg Lua Scripting->Lua Detection 4 years ago
manpages userguide: update references to Suricata website 4 years ago
output pgsql: add initial support 4 years ago
partials ikev1: rename ikev2 to common ike 5 years ago
performance doc/userguide: minor rewording and reformatting for runmodes 4 years ago
reputation userguide: remove old reference to rule-reload option 6 years ago
rule-management doc: Improve grammar, spelling and clarifications 5 years ago
rules doc: add usage of flowbits OR op 4 years ago
setting-up-ipsinline-for-linux doc: rename from "sphinx" to "userguide" 9 years ago
upgrade doc: document removal of unified2 5 years ago
.gitignore doc: hook sphinx into build 9 years ago
Makefile.am devguide: drop use of mscgen script in builds/make 3 years ago
Makefile.sphinx doc: hook sphinx into build 9 years ago
README.md devguide: move into userguide as last chapter 3 years ago
acknowledgements.rst doc: Add my own name to the acknowledgements 8 years ago
command-line-options.rst doc: Improve grammar, spelling and clarifications 5 years ago
conf.py devguide: drop use of mscgen script in builds/make 3 years ago
convert.py doc: rename from "sphinx" to "userguide" 9 years ago
index.rst devguide: move into userguide as last chapter 3 years ago
initscripts.rst doc: Improve grammar, spelling and clarifications 5 years ago
install.rst pcre2: remove PCRE1 as dependency 4 years ago
make-sense-alerts.rst doc: Improve grammar, spelling and clarifications 5 years ago
public-data-sets.rst userguide: update wiresharkwiki in public datasets 4 years ago
quickstart.rst doc/quickstart: use new test url that works 5 years ago
setting-up-ipsinline-for-linux.rst doc: Improve grammar, spelling and clarifications 5 years ago
setting-up-ipsinline-for-windows.rst doc: Improve grammar, spelling and clarifications 5 years ago
unix-socket.rst doc: fix URL for unix-socket python example 5 years ago
upgrade.rst http: move xff logging to alert object 3 years ago
what-is-suricata.rst doc: Improve grammar, spelling and clarifications 5 years ago

README.md

Suricata User Guide

This directory contains the Suricata Guide. The Suricata Developer's guide is included as a chapter of the Guide. The Sphinx Document Generator is used to build the documentation. For a primer os reStructuredText see the reStructuredText Primer.

Verifying Changes

There are a number of output formats to choose from when making the source documentation locally (e.g. html, pdf, man).

The documentation source can be built with make -f Makefile.sphinx html. Substitute the 'html' word for desired output format.

There are different application dependencies based on the output desired.