Hi all, I resolved this query.
The includeInApiDoc option works fine, and in accordance with the documentation here: https://cwiki.apache.org/confluence/display/CLOUDSTACK/Annotations+use +in+the+API The problem I had was with using maven. I thought simplistically (like with 'make') if I modify a source file the change will be detected and a rebuild will happen. This does not happen - and I think it is basically the well-known 'incremental build' problem in maven (http://stackoverflow.com/questions/12369233/incremental-build-in-jenkins) So I understand you have to do 'mvn clean install' to pick up source code changes. There are a couple of ways to speed that up - by switching off testing [http://maven.40175.n5.nabble.com/mvn-Dtest-false-mvn-Dmaven-test-skip-false-td201409.html] and by using a parallel build, like this: mvn -Dmaven.test.skip=true -T 1.5C clean install and then mvn -P developer -pl :cloud-apidoc (The above clean install runs 3.5 minutes on my machine, compared with 6 to 7 minutes for standard install.) So far as I understand it isn't possible to avoid the full install although I only want the modules required for building the apidoc. - Phillip On Fri, 2014-03-07 at 17:50 +0100, sebgoa wrote: > In Philip, > > Can you post that question on the dev list ? > There will be more people who can help with that over there :) > > -sebastien > > On Mar 7, 2014, at 12:04 PM, Phillip Kent <phillip.k...@gmail.com> wrote: > > > Hi, I am new here so apologies if this is the wrong place for my > > question. > > > > I am trying to modify the output content of tools/apidoc by using the > > option includeInApiDoc=false in the API command Java source. (I'm using > > the source code for cloudstack 4.2.1). > > > > It doesn't have any effect, so I wondered if anyone here knows if this > > option does or does not work, and how to make it work? There is just one > > mention of the option in the user guide, and no examples of using it. > > > > Thanks, Phillip > > > > ++++++ > > phillip.k...@gmail.com mobile: 07950 952034 > > www.phillipkent.net > > +++++ > > >