Documentation for preg_match and preg_match_all flag PREG_OFFSET_CAPTURE wrong

The documentation claims:

If this flag is passed, for every occurring match the appendant string offset (in bytes) will also be returned. Note that this changes the value of matches into an array of arrays where every element is an array consisting of the matched string at offset 0 and its string offset into subject at offset 1.

What really happens though is that "matches" becomes an array where the first element ( matches[0] ) is an array as described here. If capture groups are present, the second element ( matches[1] ) is a similar array, but with the captured groups and their offset instead of the entire match and its offset.

Search the PHP documentation for the preg_match and preg_match_all sections describing PREG_OFFSET_CAPTURE. Compare the wording with the reported matches[0] and capture-group behavior, then update the explanation so it accurately describes the returned array structure. Done means the documentation distinguishes the full match from captured groups and their offsets.