Comment 1:

Please note that bug summaries should have the form 'package/path: foo'.
I am not sure what you are asking for.
Quoting from the docs:
The syntax of the regular expressions accepted is the same general syntax used by Perl,
Python, and other languages. More precisely, it is the syntax accepted by RE2 and
described at http://code.google.com/p/re2/wiki/Syntax, except for \C.
...
If 'Submatch' is present, the return value is a slice identifying the successive
submatches of the expression. Submatches are matches of parenthesized subexpressions
within the regular expression, numbered from left to right in order of opening
parenthesis. Submatch 0 is the match of the entire expression, submatch 1 the match of
the first parenthesized subexpression, and so on.

Comment 2:

There's two points in this bug:
1- Move the documentation of the regexp syntax to the go.doc package so it appears in
the same page. Removing the non implemented fields, maybe?
2(and most important)- I had a hard time finding that what it's called 'numbered groups'
in one doc is referred as 'submatches' in the other. Maybe just adding 'numbered groups'
somewhere indicating that it's an equivalent term may help.
For the second point I must say that when I'm programming I tend to use the search
feature of my browser a lot ... if I don't find 'group' or 'numbered' in the spec I
assume it's not here. Is this wrong? Maybe, but I'm not the only one doing this ...

Comment 3:

I would be happy for you to address #2.  I am very reluctant to make a copy of #1, which
I think would overwhelm the rest of the docs.

Status changed to Accepted.

Comment 4:

Labels changed: added priority-later, removed priority-triage.

Comment 5:

Labels changed: added go1.1.

Comment 6:

Regarding #1 above, I agree that including the syntax in the package godoc page would
overwhelm the rest, but I think it would still be useful if the syntax was included as
part of the Go distribution. Wouldn't it be possible to include it as a separate page
and add a link to it? The distribution already includes ancillary pages for several
other packages. (See Documents / Go Articles / Packages, http://golang.org/doc/#articles
)

Comment 7:

I agree. I think we can add that as an article so that people
can reference even when they don't have access to re2 wiki.

Comment 8:

rsc: I understand your reluctance to do #1, but I think it's better that our docs be
self-contained. Trimming the unsupported features from the list would make it shorter,
in any case.

Comment 9:

(FWIW I've had a couple of conversations with Go programmers lately and they complained
about this.)

Comment 10:

'godoc regexp/syntax' shows syntax now. All that remains is #1.

Labels changed: added go1.1maybe, removed go1.1.

Comment 11:

Labels changed: added size-s.

Comment 12:

Labels changed: added suggested.

Comment 13:

This issue was closed by revision 1b3c969.

Status changed to Fixed.