RFR [9] 8040147: minor cleanup for docs

[alexander stepanov]

Hello,

Could you please review the fix
http://cr.openjdk.java.net/~avstepan/8040147/webrev.02/
for
https://bugs.openjdk.java.net/browse/JDK-8040147

Just a minor fix for docs (some tidy warnings + misprints).

Thanks,
Alexander