doc: update character class syntax - [[:alpha:]] not [:alpha:]

Fixes issue 116.

TBR=rsc
CC=re2-dev
https://codereview.appspot.com/150600043
doc: import clarifications from Go tree

TBR=rsc
CC=re2-dev
https://codereview.appspot.com/150610043