text/template/parse: nicer error when comment ends before final delimiter
By separating finding the end of the comment from the end of the action,
we can diagnose malformed comments better.
Also tweak the documentation to make the comment syntax clearer.

Fixes issue 6022.

R=golang-dev, dsymonds
CC=golang-dev
https://codereview.appspot.com/12570044