Dan, Thanks a lot for taking care of this :) It was long due. Any chance you have steps or a unix script that we could use to generate this during release process ?
On Thu, Jan 29, 2009 at 8:10 AM, Dan Becker <[email protected]> wrote: > ant elder wrote: >> >> Certainly an improvement over only having the 0.9 level doc, can see why >> no >> one has done it since then if it takes over 7 hours :) >> >> One thing is that doesn't include the spec defined API classes, i guess >> they >> were filtered out as they're org.osoa.sca not org.apache.tuscany.sca. > > I will add those. Good find. > >> >> ...ant >> >> On Wed, Jan 28, 2009 at 4:38 PM, Dan Becker <[email protected]> >> wrote: >> >>> I made some JavaDocs for Tuscany 1.4. If you would like to have a look, I >>> placed it on my Apache personal space here [1], and once I get a few >>> comments or change requests, I will check it in. >>> >>> Please let me know if you would like to change the style, add any titles >>> or >>> footers, or remove any packages. >>> >>> Here is the basic method I used to generate the docs: >>> 1) Get a directory list of all src directories under tuscany modules. >>> 2) Grep only for paths that end in src/main/java. >>> 3) Generate javadoc with >>> javadoc -d html -sourcepath $(SRCDIRS) -subpackages org.apache.tuscany >>> >>> (Note that SRCDIRS contains a list of 133 directories. It took my laptop >>> over 7 hours to generate all the files. Maybe next time I will copy all >>> the >>> src trees to one location to save time. The zip file of the docs is 5.8 >>> MB.) >>> >>> [1] >>> http://people.apache.org/~beckerdo/tuscany/<http://people.apache.org/%7Ebeckerdo/tuscany/> >>> >>> >>> Luciano Resende wrote: >>> >>>> When we last looked at this, there was an issue around grouping the >>>> java docs produced by multiple modules, and we had to do it manually. >>>> >>>> I was thinking about this for 2.x, and one idea would be to use the >>>> same technique we use to produce a "all jar", where we group multiple >>>> modules, and then produce the javadoc from that temporary grouped set >>>> of modules ? >>>> >>>> On Tue, Jan 27, 2009 at 8:26 AM, Dan Becker <[email protected]> >>>> wrote: >>>> >>>>> I noticed an older Tuscany Jira requesting an update on the Tuscany >>>>> JavaDocs >>>>> [1]. It appears the last public Tuscany JavaDoc we release is at the >>>>> 0.9 >>>>> level. I intend on resolving the Jira and making a 1.4 level JavaDoc >>>>> and >>>>> publishing at http://tuscany.apache.org/doc/javadoc/. Any words of >>>>> wisdom or >>>>> other helpful hints before I jump? >>>>> >>>>> [1] http://issues.apache.org/jira/browse/TUSCANY-2485 > > > > -- > Thanks, Dan Becker > -- Luciano Resende Apache Tuscany, Apache PhotArk http://people.apache.org/~lresende http://lresende.blogspot.com/
