> > -----Original Message----- > From: Darren Shepherd [mailto:dar...@godaddy.com] > Sent: Thursday, August 16, 2012 6:15 PM > To: cloudstack-dev@incubator.apache.org > Cc: cloudstack-dev@incubator.apache.org > Subject: Re: Javadocs > > That's honestly how javadoc just is. It takes a lot of diligence to > maintain a clean javadoc run. As long as javadoc doesn't fail the output > is always useful. > > Darren > > Sent from my iPhone > > On Aug 16, 2012, at 6:00 PM, Alex Huang <alex.hu...@citrix.com> wrote: > > > > > > > > >> -----Original Message----- > >> From: Ewan Mellor [mailto:ewan.mel...@eu.citrix.com] > >> Sent: Thursday, August 16, 2012 5:29 PM > >> To: cloudstack-dev@incubator.apache.org > >> Subject: Javadocs > >> > >> Is anyone expecting ant build-docs to work? For me, it completes > >> successfully, but only after printing dozens of exceptions and > >> hundreds of warnings. I find it hard to believe that the output is > useful. > >> > >> We should fix it, or delete it. > > > > Fix it. > > > > --Alex > >> > >> Ewan. > > >
I'm expecting it to work. We have some new APIs added for new features in this release, and we need updated API reference pages. We also need a better place to publish them, btw. Right now they're at a url that starts with "downloads.cloud.com". Under the /doc directory of our project website would be a great place for static HTML like this. Jessica T. CloudStack Tech Pubs
