Index: doc/package_config.md |
diff --git a/doc/package_config.md b/doc/package_config.md |
index 07c4eca04ac43d56d69dd49734d2da6b4112eff7..77b075f9e140dd3a00e41e5bded203346e7e5cd0 100644 |
--- a/doc/package_config.md |
+++ b/doc/package_config.md |
@@ -33,6 +33,8 @@ tags: |
* [Runner Configuration](#runner-configuration) |
* [`paths`](#paths) |
* [`filename`](#filename) |
+ * [`names`](#names) |
+ * [`plain_names`](#plain_names) |
* [`platforms`](#platforms) |
* [`concurrency`](#concurrency) |
* [`pub_serve`](#pub_serve) |
@@ -181,6 +183,44 @@ filename: "test_*.dart" |
[glob syntax]: https://github.com/dart-lang/glob#syntax |
+### `names` |
+ |
+This field restricts the tests run by the runner to those whose names match the |
+given regular expressions. A test's name must match *all* regular expressions in |
+`names`, as well as containing all strings in [`plain_names`](#plain_names), in |
+order to be run. |
+ |
+This is usually used in a [preset](#configuration-presets) to make it possible |
+to quickly select a given set of tests. |
+ |
+```yaml |
+presets: |
+ # Pass "-P chrome" to run only Chrome tests. |
+ chrome: |
+ names: |
+ - "^browser:" |
+ - "[Cc]hrome" |
+``` |
+ |
+### `plain_names` |
+ |
+This field restricts the tests run by the runner to those whose names contain |
+the given strings. A test's name must contain *all* strings in `plain_names`, as |
+well as matching all regular expressions in [`names`](#names), in order to be |
+run. |
+ |
+This is usually used in a [preset](#configuration-presets) to make it possible |
+to quickly select a given set of tests. |
+ |
+```yaml |
+presets: |
+ # Pass "-P ie" to run only Internet Explorer tests. |
+ ie: |
+ plain_names: |
+ - "IE" |
+ - "Internet Explorer" |
+``` |
+ |
### `platforms` |
This field indicates which platforms tests should run on by default. It allows |