I updated [1] to point to the javadoc for all modules. I have run the javadoc for the whole codebase, but I'm not sure how useful that is, so I stuck with just the modules for now.
[1] https://cwiki.apache.org/confluence/display/TUSCANYWIKI/Tuscany+SPI+Investigations On Mon, May 17, 2010 at 3:32 PM, Simon Laws <[email protected]> wrote: > On Mon, May 17, 2010 at 3:29 PM, kelvin goodson <[email protected]> > wrote: >> I was just thinking about this again. I finished a pass through all >> the code, adding the spi javadoc tags where I thought appropriate, and >> I got the build so that I could create javadoc, aggregated for example >> for the set of module projects. I also began to separate out the >> javadoc of packages containing spiu from those that dont. There's >> work to do in validating the tagging and then potentially refactoring >> the code within packages, but this makes a start. The pom is updated >> in the reporting section, which I believe only affects the mvn:site >> command, so I hope it doesn't cause anyone any difficulty ther. If it >> does I'll have to work out how to do profiles for reporting sections. >> >> Kelvin. >> >> On Fri, Apr 16, 2010 at 11:15 AM, kelvin goodson >> <[email protected]> wrote: >>> It will certainly help me getter a better grasp of whats there and >>> how it is intended to be used. I guess I'd like to think that it would >>> prove sufficiently popular with new developers that we would want to >>> continue to maintain it, to make Tuscany a more open and accessible >>> community to come and join. >>> >>> Kelvin. >>> >>> On Fri, Apr 16, 2010 at 9:32 AM, ant elder <[email protected]> wrote: >>>> On Fri, Apr 16, 2010 at 8:39 AM, kelvin goodson <[email protected]> >>>> wrote: >>>>> My understanding is that there are two distinct sets of classes in the >>>>> SPIs, those that are designed for specialisation by the extension >>>>> provider and those that are designed to have their methods invoked by >>>>> extension provider code calls. I believe that these sets are truly >>>>> distinct, i.e. the intersect of these sets is the empty set. It >>>>> feels like a useful piece of information to give the extension >>>>> programmer. Do you think that there are hybrid classes that make the >>>>> intersect non-empty? >>>>> >>>>> Kelvin. >>>>> >>>> >>>> I'm not sure I see the need, I guess if its useful for what you're >>>> doing right now then it doesn't matter but if the intention is to make >>>> using these required then I'd want more justification first. >>>> >>>> ...ant >>>> >>> >> > > Great thanks Kelvin. I think it's best to get what we have out there, > even if it's in the wiki rather that the site. We can then review it > here and decide what course of action to take to tidy up the SPI Java > doc. > > Simon > > > -- > Apache Tuscany committer: tuscany.apache.org > Co-author of a book about Tuscany and SCA: tuscanyinaction.com >
