Rename Match.str to input.

Rename Match.str to input.

Cleanup of Match and RegExp documentation.

BUG= http://dartbug.com/8333
R=floitsch@google.com

Committed: https://code.google.com/p/dart/source/detail?r=26776

[floitsch, 2013-08-28 09:34:50]

LGTM with comments.

https://codereview.chromium.org/23566008/diff/1/sdk/lib/core/regexp.dart
File sdk/lib/core/regexp.dart (right):

https://codereview.chromium.org/23566008/diff/1/sdk/lib/core/regexp.dart#newc...
sdk/lib/core/regexp.dart:70: * `0` to [groupCount] (inclusive), in that order.
That sounds wrong.
This returns the groups requested by the argument. We should maybe rename
[groups] (the argument) to `requestedGroups`.

https://codereview.chromium.org/23566008/diff/1/sdk/lib/core/regexp.dart#newc...
sdk/lib/core/regexp.dart:91: * Will be removed soon.
If possible mark this an @deprecated so that users get editor feedback.

Agree on a date and put that date into the comment.

[Lasse Reichstein Nielsen, 2013-08-28 10:43:23]

https://codereview.chromium.org/23566008/diff/1/sdk/lib/core/regexp.dart
File sdk/lib/core/regexp.dart (right):

https://codereview.chromium.org/23566008/diff/1/sdk/lib/core/regexp.dart#newc...
sdk/lib/core/regexp.dart:70: * `0` to [groupCount] (inclusive), in that order.
Ack, I missed that there was an argument.
Why is there one to begin with? This seems like a highly speculative method.

https://codereview.chromium.org/23566008/diff/1/sdk/lib/core/regexp.dart#newc...
sdk/lib/core/regexp.dart:91: * Will be removed soon.
Do we STILL have that silly declaration in _collection_dev?
Shouldn't I just write "@0" instead, it is the same thing!!!
(No, I'll never let it go :)

[Lasse Reichstein Nielsen, 2013-08-28 10:47:06]

Committed patchset #2 manually as r26776 (presubmit successful).