commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Gary Gregory <garydgreg...@gmail.com>
Subject Re: [LANG] Feedback from ApacheCON Europe
Date Sat, 19 Nov 2016 16:20:39 GMT
Custom annotations seems like the clearest way.

Gary

On Nov 19, 2016 3:52 AM, "Benedikt Ritter" <britter@apache.org> wrote:

> Hi,
>
> after my presentation about Apache Commons, there where some comments about
> [lang]. One person said, that it is hard to find out whether our classes
> are threadsafe or not. He would like to see that better documented.
>
> I know that sebb has done some work in that direction, but as far as I know
> the information about thread safety is currently only in Java comments.
>
> How can we improve our docs with regards to thread safety? I see several
> ways:
> - Custom annotations like @Immutable, @ThreadSafe, @NotThreadSafe
> - Custom JavaDoc doclets
> - Put the information right into the JavaDoc
>
> Anything else?
>
> Benedikt
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message