Comment cleanup

Author: rbuckton

src/compiler/commandLineParser.ts

@@ -584,9 +584,9 @@ namespace ts {
 
     /**
      * Tests for a path that ends in a recursive directory wildcard.
-     * Matches **, /**, /**\/, and /**\/, but not a**b.
+     * Matches **, \**, **\, and \**\, but not a**b.
      *
-     * NOTE: used \/ in place of / above to avoid ending the comment.
+     * NOTE: used \ in place of / above to avoid issues with multiline comments.
      *
      * Breakdown:
      *  (^|\/)      # matches either the beginning of the string or a directory separator.
@@ -597,9 +597,9 @@ namespace ts {
 
     /**
      * Tests for a path with multiple recursive directory wildcards.
-     * Matches **\/** and **\/a/**, but not **\/a**b.
+     * Matches **\** and **\a\**, but not **\a**b.
      *
-     * NOTE: used \/ in place of / above to avoid ending the comment.
+     * NOTE: used \ in place of / above to avoid issues with multiline comments.
      *
      * Breakdown:
      *  (^|\/)      # matches either the beginning of the string or a directory separator.
@@ -612,9 +612,9 @@ namespace ts {
 
     /**
      * Tests for a path containing a wildcard character in a directory component of the path.
-     * Matches /*\/, /?/, and /a*b/, but not /a/ or /a/*.
+     * Matches \*\, \?\, and \a*b\, but not \a\ or \a\*.
      *
-     * NOTE: used \/ in place of / above to avoid ending the comment.
+     * NOTE: used \ in place of / above to avoid issues with multiline comments.
      *
      * Breakdown:
      *  \/          # matches a directory separator.
@@ -627,7 +627,9 @@ namespace ts {
 
     /**
      * Matches the portion of a wildcard path that does not contain wildcards.
-     * Matches /a of /a/*, or /a/b/c of /a/b/c/?/d.
+     * Matches \a of \a\*, or \a\b\c of \a\b\c\?\d.
+     *
+     * NOTE: used \ in place of / above to avoid issues with multiline comments.
      *
      * Breakdown:
      *  ^                   # matches the beginning of the string