[vector] more editorial changes, plus API tweaks

[John Rose]

Hi Kishor. This looks good so please commit it.

One nit:
///
+ * is not a multiple of {@code SPECIES.length()} will have a mask with + * first {@code a.length % SPECIES.length()} lanes set.
///
s/first/the first/


> On Jul 15, 2019, at 5:55 PM, Kharbas, Kishor <kishor.kharbas at intel.com> wrote:
> 
> Hi John,
> 
> I have a webrev which adds example of masked loops to package javadoc. Additionally it has code changes adding a new method (indexFromrange()) and making memory read/write operations work with masks.
> 
> Link - http://cr.openjdk.java.net/~kkharbas/vector-api/webrev-vector_unstable.00
> 
> Please let me know if the changes look good and can be pushed.
> 
> Thanks,
> Kishor
> 
>> -----Original Message-----
>> From: panama-dev [mailto:panama-dev-bounces at openjdk.java.net] On
>> Behalf Of John Rose
>> Sent: Sunday, July 14, 2019 1:13 AM
>> To: panama-dev at openjdk.java.net
>> Subject: [vector] more editorial changes, plus API tweaks
>> 
>> As you might have noticed from my pushes to vector-unstable, I’ve been
>> polishing the Vector API draft, in preparation for our CSR.
>> 
>> Here is a fresh spin of the java doc:
>> 
>> http://cr.openjdk.java.net/~jrose/vectors/vector-unstable-doc
>> 
>> I think Kishor is working on a code example showing how to do masked loops
>> correctly.
>> 
>> What else do we need before CSR?
>> 
>> — John