Marc,
Is this okay?
https://jsr311.dev.java.net/issues/show_bug.cgi?id=60
PS: I know you're asking for a specific problem, but I believe that
shipping a public API with missing Javadoc is problematic. When I am
faced with methods without Javadoc it forces me to peek into the
source-code, which is neither productive nor safe from a specification
point of view. Any plans to rectify this? Most IDEs will issue warnings
on missing Javadoc. Simply turn this on and follow the trail :)
Gili
Marc Hadley wrote:
> On Dec 17, 2008, at 3:56 PM, Marc Hadley <Marc.Hadley_at_Sun.COM> wrote:
>
>> Yes please file a bug.
>>
> BTW, the more specific, the better.
>
> Thanks again
> Marc
>>
>> On Dec 17, 2008, at 3:50 PM, cowwoc <cowwoc_at_bbs.darktech.org> wrote:
>>
>>> Hi,
>>>
>>> Does anyone plan on documenting all JSR311 methods missing Javadoc?
>>> For example, it isn't clear what kind of EntityTag
>>> ResponseBuilder.tag(String) builds. Is it weak or strong? A lot of
>>> these things should be documented and the best way to do so is to
>>> fill in the missing Javadoc. Should I file a bug report against this?
>>>
>>> Gili
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: users-unsubscribe_at_jsr311.dev.java.net
>>> For additional commands, e-mail: users-help_at_jsr311.dev.java.net
>>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe_at_jsr311.dev.java.net
> For additional commands, e-mail: users-help_at_jsr311.dev.java.net