> @Path("/messages")
> MessageStream stream(@HeaderParam("Client-ID") UUID clientId,
> - StreamOptions... options);
> + StreamMessagesOptions... options);
> +
> + /**
> + * List specific messages. Unlike the stream method, a client's own
> messages are always returned in this operation.
I was comparing to "Streams" in the description above, and also thinking about
the [Javadoc style
guide](http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html):
```
Use 3rd person (descriptive) not 2nd person (prescriptive).
The description is in 3rd person declarative rather than 2nd person imperative.
Gets the label. (preferred)
Get the label. (avoid)
```
---
Reply to this email directly or view it on GitHub:
https://github.com/jclouds/jclouds-labs-openstack/pull/57/files#r7882056
