aboutsummaryrefslogtreecommitdiff
path: root/docs/build_test_doc.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/build_test_doc.md')
-rwxr-xr-xdocs/build_test_doc.md52
1 files changed, 13 insertions, 39 deletions
diff --git a/docs/build_test_doc.md b/docs/build_test_doc.md
index 6f3c597..332dc58 100755
--- a/docs/build_test_doc.md
+++ b/docs/build_test_doc.md
@@ -1,3 +1,9 @@
+<!-- Generated with Stardoc: http://skydoc.bazel.build -->
+
+A test verifying other targets build as part of a `bazel test`
+
+<a id="#build_test"></a>
+
## build_test
<pre>
@@ -10,9 +16,6 @@ This works not by an instance of this test failing, but instead by
the targets it depends on failing to build, and hence failing
the attempt to run this test.
-NOTE: At the moment, this won't work on Windows; but someone adding
-support would be welcomed.
-
Typical usage:
```
@@ -26,42 +29,13 @@ Typical usage:
```
-### Parameters
+**PARAMETERS**
+
-<table class="params-table">
- <colgroup>
- <col class="col-param" />
- <col class="col-description" />
- </colgroup>
- <tbody>
- <tr id="build_test-name">
- <td><code>name</code></td>
- <td>
- required.
- <p>
- The name of the test rule.
- </p>
- </td>
- </tr>
- <tr id="build_test-targets">
- <td><code>targets</code></td>
- <td>
- required.
- <p>
- A list of targets to ensure build.
- </p>
- </td>
- </tr>
- <tr id="build_test-kwargs">
- <td><code>kwargs</code></td>
- <td>
- optional.
- <p>
- The <a href="https://docs.bazel.build/versions/master/be/common-definitions.html#common-attributes-tests">common attributes for tests</a>.
- </p>
- </td>
- </tr>
- </tbody>
-</table>
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| <a id="build_test-name"></a>name | The name of the test rule. | none |
+| <a id="build_test-targets"></a>targets | A list of targets to ensure build. | none |
+| <a id="build_test-kwargs"></a>kwargs | The &lt;a href="https://docs.bazel.build/versions/main/be/common-definitions.html#common-attributes-tests"&gt;common attributes for tests&lt;/a&gt;. | none |