[Bro-Dev] #435: topic/jsiwek/doc-framework

Bro Tracker bro at tracker.icir.org
Tue Apr 19 14:01:52 PDT 2011


#435: topic/jsiwek/doc-framework
---------------------+------------------------
  Reporter:  jsiwek  |      Owner:  jsiwek
      Type:  Task    |     Status:  assigned
  Priority:  Low     |  Milestone:  Bro1.6
 Component:  Bro     |    Version:  git/master
Resolution:          |   Keywords:
---------------------+------------------------

Comment (by jsiwek):

 Here's a question for you Seth:  with the way you're re-writing the policy
 scripts, are the dependencies going to be such that a given script can be
 loaded by itself as an argument to bro?

 i.e. I'm currently doing something like this over a defined list of
 scripts:

 {{{
 ./src/bro --doc-script ../policy/foo.bro
 }}}

 Then I only take the generated `foo.rst` as the input to Sphinx.  If we
 wanted to doc the scripts that were `@load`ed by `foo.bro`, those have to
 be run through bro individually.  I was doing it that way because
 otherwise `redef` interactions between scripts would possibly corrupt the
 documentation that's generated.

-- 
Ticket URL: <http://tracker.icir.org/bro/ticket/435#comment:13>
Bro Tracker <http://tracker.icir.org/bro>
Bro Issue Tracker



More information about the bro-dev mailing list