On Wed, Mar 11, 2015 at 7:19 AM, Andrew Haley <a...@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: > > "Block current thread, returning when... > "Report the scale... > "Define a class... > > Which is right? > > The former! (Switch to imperative voice for implementation comments.)
