On 4/1/09 4:56 PM, Kedar Mhaswade wrote:
>
>
> Jane Young wrote:
>> Hi,
>>
>> I've been trying to post javadocs to
>> https://glassfish.dev.java.net/nonav/javaee6 since early this
>> morning. It's taking forever (> 7hrs) since it's uploading around
>> 20,000 files. I don't know what else to do other than wait. Just
>> want to inform everyone that I haven't forgotten about this.
Jane: thanks for letting us know.
>
> We are uploading "implementation javadocs"?
Not sure Jane mentioned impl docs...
As you might know EE 5 compressed javadoc is already 7.1Mb compressed,
and 51.7Mb exploded as 2149 files. Biggest ones are index-all.html,
constant-values, and overview tree.
>
> Don't get me wrong, but sincerely, does anyone ever read
> Javadoc for non-API implementation Java code?
No, (or maybe yes for people developing GF itself?) but for Java EE 6
docs, I am still waiting (dying?) to see them online and ready to bundle
them in Eclipse and NetBeans IDE for developers to start looking at
them. So thanks again Jane for working on that:-)
Not sure why the JCP process does not force specifications to also
deliver JavaDocs for reviews...
>
> I suggest you upload Javadoc for API modules (platform, product)
> and maybe common (v3/common) classes.
Why? v3/common are public APIs? Definitely not all of them, at least not
the internal* modules...
We need javax* and stable GF apis.
Given the incompatible changes in amx apis, javax.* is a good and safe
start.
Ludo
>
> -Kedar
>
>>
>> Thanks,
>> Jane
>>
>>
>>
>> Bill Shannon wrote:
>>> Marina Vatkina wrote:
>>>> Bill,
>>>>
>>>> You missed the bottom part - it has many more warnings, and e.g. in
>>>> transaction or persistence, it's probably more than an hour :).
>>>
>>> Great, give me an hour and tell me what you didn't get done.
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe_at_glassfish.dev.java.net
>>> For additional commands, e-mail: dev-help_at_glassfish.dev.java.net
>>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe_at_glassfish.dev.java.net
>> For additional commands, e-mail: dev-help_at_glassfish.dev.java.net
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe_at_glassfish.dev.java.net
> For additional commands, e-mail: dev-help_at_glassfish.dev.java.net
>