+1 Our *Cmd.java files are basically a DSL written in Java. As such anything required to generate the doc should reside with Cmd.java files.
--Alex > -----Original Message----- > From: Chip Childers [mailto:chip.child...@sungard.com] > Sent: Friday, July 26, 2013 6:01 AM > To: dev@cloudstack.apache.org > Subject: Re: Build failure on master...anyone know what this is? > > On Fri, Jul 26, 2013 at 10:05:04AM +0530, Prasanna Santhanam wrote: > > Fixed this fd62a22. This _always_ breaks when we add a new API :) > > Indeed... if not _always_, at least very close to _always_. > > I wonder if it wouldn't be worth adding some logic that figures out the > categories at build time? > > > > > On Thu, Jul 25, 2013 at 08:28:40PM -0700, Sheng Yang wrote: > > > Don't know about deleteCacheStore.xml, but seems you need something > > > like > > > this: > > > > > > diff --git a/tools/apidoc/gen_toc.py b/tools/apidoc/gen_toc.py index > > > 6c08d17..33a7e75 100644 > > > --- a/tools/apidoc/gen_toc.py > > > +++ b/tools/apidoc/gen_toc.py > > > @@ -152,7 +152,9 @@ known_categories = { > > > 'PortableIp': 'Portable IP', > > > 'dedicateHost': 'Dedicate Resources', > > > 'releaseDedicatedHost': 'Dedicate Resources', > > > 'Baremetal' : 'Baremetal', > > > - 'Ucs' : 'UCS' > > > + 'Ucs' : 'UCS', > > > + 'CacheStore' : 'Cache Store' > > > } > > > > > > Edison knows more about it. > > > > > > --Sheng > > > > > > > > > On Thu, Jul 25, 2013 at 7:54 PM, Alex Huang <alex.hu...@citrix.com> > wrote: > > > > > > > [INFO] --- exec-maven-plugin:1.2.1:exec (compile) @ cloud-apidoc > > > > --- Check, is this api part of another build profile? Null value for > > > > key: > > > > configureSimulator preProcessedCommand=1 Traceback (most recent > > > > call last): > > > > File "/cyg/d/src/acs/master/tools/apidoc/gen_toc.py", line 189, > > > > in <module> > > > > category = choose_category(fn) > > > > File "/cyg/d/src/acs/master/tools/apidoc/gen_toc.py", line 169, > > > > in choose_category > > > > (fn, __file__)) > > > > Exception: Need to add a category for deleteCacheStore.xml to > > > > /cyg/d/src/acs/master/tools/apidoc/gen_toc.py:known_categories > > > > > > > > > > > > Thanks. > > > > --Alex > > > > > > > > -- > > Prasanna., > > > > ------------------------ > > Powered by BigRock.com > > > >
