---------- Forwarded message ----------
From: Martin Buchholz <martinrb@google.com>
To: Andrew Haley <aph@redhat.com>
Cc: "core-libs-dev@openjdk.java.net" <core-libs-dev@openjdk.java.net>
Date: Wed, 11 Mar 2015 07:23:09 -0700
Subject: Re: Is a Javadoc API supposed to be imperative or not?
On Wed, Mar 11, 2015 at 7:19 AM, Andrew Haley <aph@redhat.com> wrote:
> Javadoc API seems to be descriptive:
>
> "Returns a string ...
> "Wakes up a single thread ...
> "Creates and returns ...
>
> But sometimes it's imperative: