7 commits

Author	SHA1	Message	Date
Jon Siwek	9967aea52c	Integrate new Broxygen functionality into Sphinx. ... Add a "broxygen" domain Sphinx extension w/ directives to allow on-the-fly documentation to be generated w/ Bro and included in files. This means all autogenerated reST docs are now done by Bro. The odd CMake/Python glue scipts which used to generate some portions are now gone. Bro and the Sphinx extension handle checking for outdated docs themselves. Parallel builds of `make doc` target should now work (mostly because I don't think there's any tasks that can be done in parallel anymore). Overall, this seems to simplify things and make the Broxygen-generated portions of the documentation visible/traceable from the main Sphinx source tree. The one odd thing still is that per-script documentation is rsync'd in to a shadow copy of the Sphinx source tree within the build dir. This is less elegant than using the new broxygen extension to make per-script docs, but rsync is faster and simpler. Simpler as in less code because it seems like, in the best case, I'd need to write a custom Sphinx Builder to be able to get that to even work.	2013-11-21 14:34:32 -06:00
Jon Siwek	e56a17102e	Teach broxygen to generate protocol analyzer plugin reference.	2013-06-07 13:21:18 -05:00
Jon Siwek	23177aa081	Enable warnings for malformed Broxygen xref roles.	2011-12-16 14:36:15 -06:00
Jon Siwek	305621672f	Teach Broxygen the .. bro:see:: directive	2011-11-19 07:19:57 -06:00
Jon Siwek	8d8f5dd006	Teach Broxygen to generate an index of Bro notices	2011-11-18 13:58:23 -06:00
Jon Siwek	5227eb73c8	Teach Broxygen :bro:see: role for referencing any identifier in Bro domain.	2011-11-17 16:55:51 -06:00
Jon Siwek	fdf01a1ba6	Finished dissolving the sphinx source directory into doc/ and doc/scripts/	2011-11-15 11:52:52 -06:00

Renamed from doc/source/ext/bro.py (Browse further)