On Wed, Jun 05, 2013 at 21:36 +0000, you wrote: > 1) Replace the "Built-In Functions (BIFs)" bullet under "Script Reference" > with a "Plugin Reference" bullet. (better name to use here?)
We could just call it "Analyzer Reference" for now because there aren't any other plugins. I'm not quite sure how it should look longer term once we have different component types, in particular because a single plugin can provide different ones (like a reader and writer). We probably want to group them by component type eventually, plus a separate plugin index listing all of a plugin's components. > 2) The Plugin Reference page will have a section for each plugin. Ack. > 3) Each plugin section lists its components (e.g. protocol analyzer w/ tag > declaration) and BIF-items. Ack. (For later: we should add support for a README.rst coming with a plugin that would go to the top of its section; and probably also additional README.rst for each component it provides). > 4) For the BIF-items, the reST markup would just use some directive to > duplicate the content from where they're originally declared (the > per-file documentation). Alternatively it could just be a link to > that declaration; I'll probably try that first since it's easier, but > I feel like it won't be enough. It would be nice to have the content in there directly; duplicating is fine for now if it doesn't mess up indexing/linking etc? So, yes, I think this a good short-term compromise. I certainly want avoid doing something now that we'd just be throwing away soon, and I see that doing the full Broxygen overhaul will take more time. Robin -- Robin Sommer * Phone +1 (510) 722-6541 * [email protected] ICSI/LBNL * Fax +1 (510) 666-2956 * www.icir.org/robin _______________________________________________ bro-dev mailing list [email protected] http://mailman.icsi.berkeley.edu/mailman/listinfo/bro-dev
