Start of Systemtap Tapset Reference manual

[William Cohen]

Randy Dunlap wrote:

> Not currently, but I don't see why it couldn't be done.  Then the question
> becomes:  is it the same scripts/kernel-doc file or is it scripts/stap-doc
> (e.g. -- or some other name)?

This weekend I played around this some more and created some patches to use 
kernel-doc as method of encoding the documentation in the tapset files.

kernel-doc1.patch  removes the old documentation method
kernel-doc2.patch  adds the kernel-doc
kernel-doc3.patch  revises the tapsets files to generate instumentation.

To make the instrumentation need to go in the the build directory 
doc/SystemTap_Tapset_Reference and do a "make" in there. It dodn't currently 
install the resulting documtation any where.

Comments on this series of patches would be appreciated.

-Will


-------------- next part --------------
A non-text attachment was scrubbed...
Name: kernel-doc1.patch
Type: text/x-patch
Size: 150009 bytes
Desc: not available
URL: <http://sourceware.org/pipermail/systemtap/attachments/20081124/a94c15a0/attachment.bin>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: kernel-doc2.patch
Type: text/x-patch
Size: 103986 bytes
Desc: not available
URL: <http://sourceware.org/pipermail/systemtap/attachments/20081124/a94c15a0/attachment-0001.bin>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: kernel-doc3.patch
Type: text/x-patch
Size: 35505 bytes
Desc: not available
URL: <http://sourceware.org/pipermail/systemtap/attachments/20081124/a94c15a0/attachment-0002.bin>