Perfect! Thanks for the quick response. I took a look at that code and was able to integrate it with my build system easily. It even generates docbk which we were already using for documentation so it was much easier than I was expecting.
The only issue I have is that adding the "--help" option to every command makes the output very verbose and hides the important options in the noise. I was looking at the source code, it looks like it would be trivial to add a flag to disable adding that option. https://svn.apache.org/repos/asf/karaf/trunk/tooling/karaf-maven-plugin/src/main/java/org/apache/karaf/tooling/cmdhelp/CmdHelpMojo.java If I were to provide a patch to add that option and generally get the docbk formatter up to par with the conf one would it likely be accepted?<https://svn.apache.org/repos/asf/karaf/trunk/tooling/karaf-maven-plugin/src/main/java/org/apache/karaf/tooling/cmdhelp/CmdHelpMojo.java> Sam Hendley On Wed, May 4, 2011 at 12:10 PM, Jamie G. <[email protected]> wrote: > Have a look through the Karaf manual folder for how the it's generated: > http://svn.apache.org/repos/asf/karaf/trunk/manual > > The project used to generate the manual is called Scalate. > You can find out more about that project here: > http://scalate.fusesource.org/ > > Cheers, > Jamie > > On Wed, May 4, 2011 at 1:34 PM, Sam Hendley > <[email protected]> wrote: > > I really like the documentation on the karaf commands at: > > http://karaf.apache.org/manual/2.1.99-SNAPSHOT/commands/commands.html > > I'm assuming these were auto generated, is that tool commonly available? > We > > have built an application that exposes alot of shell commands and would > like > > to expose the help documentation. I tried searching for documentation > tools > > for karaf and gogo commands but I didn't come across anything obvious. > Any > > pointers would be much appreciated. > > Thanks! > > Sam Hendley >
