Revert "Revert "Fix dartdoc block code comments in Dart API that are broken and use [: :] delimiter…

corelib/src/regexp.dart

 // Copyright (c) 2011, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 /**
  * [Match] contains methods to manipulate a regular expression match.
  *
  * Iterables of [Match] objects are returned from [RegExp] matching methods.
  *
  * The following example finds all matches of a [RegExp] in a [String]
  * and iterates through the returned iterable of [Match] objects.
  *
- * [:
- *    RegExp exp = const RegExp(@"(\w+)");
- *    String str = "Parse my string";
- *    Iterable<Match> matches = exp.allMatches(str);
- *    for (Match m in matches) {
- *      String match = m.group(0);
- *      print(match);
- *    };
- * :]
+ *     RegExp exp = const RegExp(@"(\w+)");
+ *     String str = "Parse my string";
+ *     Iterable<Match> matches = exp.allMatches(str);
+ *     for (Match m in matches) {
+ *       String match = m.group(0);
+ *       print(match);
+ *     };
  *
  * The output of the example is:
  *
- * [:
- *    Parse
- *    my
- *    string
- * :]
+ *     Parse
+ *     my
+ *     string
  */
 interface Match {
   /**
    * Returns the index in the string where the match starts.
    */
   int start();
 
   /**
    * Returns the index in the string after the last character of the
    * match.
@@ skipping 36 matching lines @@
  * [firstMatch] is the main implementation method that applies a regular
  * expression to a string and returns the first [Match]. All
  * other methods in [RegExp] can build on it.
  *
  * Use [allMatches] to look for all matches of a regular expression in
  * a string.
  *
  * The following example finds all matches of a regular expression in
  * a string.
  *
- * [:
- *    RegExp exp = const RegExp(@"(\w+)");
- *    String str = "Parse my string";
- *    Iterable<Match> matches = exp.allMatches(str);
- * :]
+ *     RegExp exp = const RegExp(@"(\w+)");
+ *     String str = "Parse my string";
+ *     Iterable<Match> matches = exp.allMatches(str);
  */
 interface RegExp extends Pattern default JSSyntaxRegExp {
 
   /**
    * Constructs a regular expression. The default implementation of a
    * [RegExp] sets [multiLine] and [ignoreCase] to false.
    */
   const RegExp(String pattern, [bool multiLine, bool ignoreCase]);
 
   /**
    * Searches for the first match of the regular expression
-   * in the string [str]. Returns [:null:] if there is no match.
+   * in the string [str]. Returns `null` if there is no match.
    */
   Match firstMatch(String str);
 
   /**
    * Returns an iterable on the  matches of the regular
    * expression in [str].
    */
   Iterable<Match> allMatches(String str);
 
   /**
@@ skipping 15 matching lines @@
   /**
    * Whether this regular expression matches multiple lines.
    */
   final bool multiLine;
 
   /**
    * Whether this regular expression is case insensitive.
    */
   final bool ignoreCase;
 }