regexp/syntax: add package and Parse commentary
regexp/syntax: add package and Parse commentary

Fixes issue 2954.

R=golang-dev, bradfitz, rsc, r
CC=golang-dev
http://codereview.appspot.com/5645077

tav/go,tav/go,tav/go,tav/go,tav/go,tav/go,tav/go