Revise the way "port analysis" and "packet filter" documentation is generated.

They now appear at the bottom of generated docs.

Also, a "more info" link is added which can point to an arbitrary location
in any reST document processed by Sphinx.
This commit is contained in:
Jon Siwek 2011-03-29 14:19:33 -05:00
parent a9810d21a9
commit 94ac3f3c23

View file

@ -131,24 +131,23 @@ void BroDoc::WriteDocFile() const
if ( ! notices.empty() )
WriteBroDocObjList(notices, "Notices", '-');
WriteInterface("Public Interface", '-', '~', true);
WriteInterface("Private Interface", '-', '~', false);
if ( ! port_analysis.empty() )
{
WriteSectionHeading("Port Analysis", '-');
WriteToDoc(":ref:`More Information <common_port_analysis_doc>`\n\n");
WriteStringList("%s", port_analysis);
}
if ( ! packet_filter.empty() )
{
WriteSectionHeading("Packet Filter", '-');
WriteToDoc(".. note:: Filters are only relevant when dynamic protocol "
"detection (DPD) is explicitly turned off (Bro release 1.6 "
"enabled DPD by default).\n\n");
WriteToDoc(":ref:`More Information <common_packet_filter_doc>`\n\n");
WriteToDoc("Filters added::\n\n");
WriteToDoc("%s\n", packet_filter.c_str());
}
WriteInterface("Public Interface", '-', '~', true);
WriteInterface("Private Interface", '-', '~', false);
}
void BroDoc::WriteInterface(const char* heading, char underline,