This is the mail archive of the systemtap@sourceware.org mailing list for the systemtap project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Using RoboDoc for tapset documentation



I've been experimenting with something called RoboDoc to generate documentation from tapset file comments. You can see an example that uses the sockets tapset at http://www.mwmnet.com/systemtap/robodoc/. The socket.stp file shows the robodoc markup I used in the tapset file. The other directories show the resulting output in various formats. It's not perfect, but it's pretty good, IMHO. Still needs fine tuning in some areas.


Please take a look and let me know what you think. Sure would be nice to standardize tapset documentation using something like this.

Question... RoboDoc is GPL'd, but doesn't appear to be shipped in any distros. Is that an issue? Could we just include RoboDoc in the SystemTap src tree?

Mike



Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]