Document the syntax and semantics of Dart regular expressions (the same as JS regexps).

Document the syntax and semantics of Dart regular expressions (the same as JS regexps).

R=lrn@google.com
BUG=dartbug.com/89

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

[Lasse Reichstein Nielsen, 2012-09-17 11:03:14]

LGTM

https://chromiumcodereview.appspot.com/10909266/diff/1/lib/core/regexp.dart
File lib/core/regexp.dart (right):

https://chromiumcodereview.appspot.com/10909266/diff/1/lib/core/regexp.dart#n...
lib/core/regexp.dart:73: * JavaScript regular expressions. See
<http://es5.github.com/#x15.10>
JavaScript -> ECMAScript.
The es5.github.com page isn't normative, so we should reference 
 http://ecma-international.org/ecma-262/5.1/#sec-15.10
instead.

One problem is that no browser implements the specification without extensions,
so dart2js will definitly accept more than the spec, and if the VM uses irregexp
unmodified, it will too :(
We should probably not say anything about that now.

[Mads Ager (google), 2012-09-17 11:42:22]

https://chromiumcodereview.appspot.com/10909266/diff/1/lib/core/regexp.dart
File lib/core/regexp.dart (right):

https://chromiumcodereview.appspot.com/10909266/diff/1/lib/core/regexp.dart#n...
lib/core/regexp.dart:73: * JavaScript regular expressions. See
<http://es5.github.com/#x15.10>
On 2012/09/17 11:03:14, Lasse Reichstein Nielsen wrote:
> JavaScript -> ECMAScript.
> The http://es5.github.com page isn't normative, so we should reference 
>  http://ecma-international.org/ecma-262/5.1/#sec-15.10
> instead.

Thanks! Updated.

> One problem is that no browser implements the specification without
extensions,
> so dart2js will definitly accept more than the spec, and if the VM uses
irregexp
> unmodified, it will too :(
> We should probably not say anything about that now.

I agree. Going into those extensions is going to be too much detail for this doc
comment. :)