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.

   ...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
>

Reply via email to