diff options
author | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | 2022-06-24 19:27:53 +0000 |
---|---|---|
committer | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | 2022-06-24 19:27:53 +0000 |
commit | f106017751732e4baaf3e71170ef4f2bb337848d (patch) | |
tree | 3c15c050ced2749753c4d6f1cf9d3a9b9bd94085 /docs/versions_doc.md | |
parent | 76be740a2ab63f21bb42ee3590792fd39edc6a59 (diff) | |
parent | f1fb8167b4ed64feb494fd1ea6a8a619bbb549de (diff) | |
download | bazel-skylib-f106017751732e4baaf3e71170ef4f2bb337848d.tar.gz |
Snap for 8765624 from f1fb8167b4ed64feb494fd1ea6a8a619bbb549de to android13-gs-pixel-5.10-releaseandroid-u-beta-5_r0.7android-u-beta-5_r0.5android-u-beta-5_r0.4android-u-beta-5_r0.3android-u-beta-5_r0.2android-u-beta-5_r0.1android-u-beta-5.2_r0.7android-u-beta-5.2_r0.6android-u-beta-5.2_r0.5android-u-beta-5.2_r0.3android-u-beta-5.2_r0.1android-u-beta-3_r0.5android-u-beta-3_r0.4android-t-qpr2-beta-3.2_r0.4android-14.0.0_r0.24android-13.0.0_r0.94android-13.0.0_r0.65android-13.0.0_r0.63android-gs-tangorpro-5.10-u-beta5.2android-gs-tangorpro-5.10-u-beta5android-gs-raviole-5.10-u-beta5.2android-gs-raviole-5.10-u-beta5android-gs-raviole-5.10-t-qpr2-beta-3.2android-gs-pantah-5.10-u-beta5android-gs-pantah-5.10-u-beta3android-gs-lynx-5.10-u-beta5.2android-gs-lynx-5.10-u-beta5android-gs-lynx-5.10-u-beta3android-gs-felix-5.10-u-beta5.2android-gs-felix-5.10-u-beta5android-gs-bluejay-5.10-u-beta5.2android-gs-bluejay-5.10-u-beta5
Change-Id: Ia0ce9f969778c682312310ecbc9ab7eaa4ada766
Diffstat (limited to 'docs/versions_doc.md')
-rwxr-xr-x | docs/versions_doc.md | 164 |
1 files changed, 53 insertions, 111 deletions
diff --git a/docs/versions_doc.md b/docs/versions_doc.md index d94076c..83ee7a7 100755 --- a/docs/versions_doc.md +++ b/docs/versions_doc.md @@ -1,3 +1,9 @@ +<!-- Generated with Stardoc: http://skydoc.bazel.build --> + +Skylib module containing functions for checking Bazel versions. + +<a id="#versions.get"></a> + ## versions.get <pre> @@ -8,6 +14,8 @@ Returns the current Bazel version +<a id="#versions.parse"></a> + ## versions.parse <pre> @@ -19,26 +27,19 @@ Parses a version string into a 3-tuple of ints int tuples can be compared directly using binary operators (<, >). -### Parameters +**PARAMETERS** + -<table class="params-table"> - <colgroup> - <col class="col-param" /> - <col class="col-description" /> - </colgroup> - <tbody> - <tr id="versions.parse-bazel_version"> - <td><code>bazel_version</code></td> - <td> - required. - <p> - the Bazel version string - </p> - </td> - </tr> - </tbody> -</table> +| Name | Description | Default Value | +| :------------- | :------------- | :------------- | +| <a id="versions.parse-bazel_version"></a>bazel_version | the Bazel version string | none | +**RETURNS** + +An int 3-tuple of a (major, minor, patch) version. + + +<a id="#versions.check"></a> ## versions.check @@ -48,45 +49,18 @@ versions.check(<a href="#versions.check-minimum_bazel_version">minimum_bazel_ver Check that the version of Bazel is valid within the specified range. -### Parameters - -<table class="params-table"> - <colgroup> - <col class="col-param" /> - <col class="col-description" /> - </colgroup> - <tbody> - <tr id="versions.check-minimum_bazel_version"> - <td><code>minimum_bazel_version</code></td> - <td> - required. - <p> - minimum version of Bazel expected - </p> - </td> - </tr> - <tr id="versions.check-maximum_bazel_version"> - <td><code>maximum_bazel_version</code></td> - <td> - optional. default is <code>None</code> - <p> - maximum version of Bazel expected - </p> - </td> - </tr> - <tr id="versions.check-bazel_version"> - <td><code>bazel_version</code></td> - <td> - optional. default is <code>None</code> - <p> - the version of Bazel to check. Used for testing, defaults to native.bazel_version - </p> - </td> - </tr> - </tbody> -</table> +**PARAMETERS** + + +| Name | Description | Default Value | +| :------------- | :------------- | :------------- | +| <a id="versions.check-minimum_bazel_version"></a>minimum_bazel_version | minimum version of Bazel expected | none | +| <a id="versions.check-maximum_bazel_version"></a>maximum_bazel_version | maximum version of Bazel expected | <code>None</code> | +| <a id="versions.check-bazel_version"></a>bazel_version | the version of Bazel to check. Used for testing, defaults to native.bazel_version | <code>None</code> | +<a id="#versions.is_at_most"></a> + ## versions.is_at_most <pre> @@ -95,36 +69,21 @@ versions.is_at_most(<a href="#versions.is_at_most-threshold">threshold</a>, <a h Check that a version is lower or equals to a threshold. -### Parameters - -<table class="params-table"> - <colgroup> - <col class="col-param" /> - <col class="col-description" /> - </colgroup> - <tbody> - <tr id="versions.is_at_most-threshold"> - <td><code>threshold</code></td> - <td> - required. - <p> - the maximum version string - </p> - </td> - </tr> - <tr id="versions.is_at_most-version"> - <td><code>version</code></td> - <td> - required. - <p> - the version string to be compared to the threshold - </p> - </td> - </tr> - </tbody> -</table> +**PARAMETERS** + + +| Name | Description | Default Value | +| :------------- | :------------- | :------------- | +| <a id="versions.is_at_most-threshold"></a>threshold | the maximum version string | none | +| <a id="versions.is_at_most-version"></a>version | the version string to be compared to the threshold | none | + +**RETURNS** + +True if version <= threshold. +<a id="#versions.is_at_least"></a> + ## versions.is_at_least <pre> @@ -133,33 +92,16 @@ versions.is_at_least(<a href="#versions.is_at_least-threshold">threshold</a>, <a Check that a version is higher or equals to a threshold. -### Parameters - -<table class="params-table"> - <colgroup> - <col class="col-param" /> - <col class="col-description" /> - </colgroup> - <tbody> - <tr id="versions.is_at_least-threshold"> - <td><code>threshold</code></td> - <td> - required. - <p> - the minimum version string - </p> - </td> - </tr> - <tr id="versions.is_at_least-version"> - <td><code>version</code></td> - <td> - required. - <p> - the version string to be compared to the threshold - </p> - </td> - </tr> - </tbody> -</table> +**PARAMETERS** + + +| Name | Description | Default Value | +| :------------- | :------------- | :------------- | +| <a id="versions.is_at_least-threshold"></a>threshold | the minimum version string | none | +| <a id="versions.is_at_least-version"></a>version | the version string to be compared to the threshold | none | + +**RETURNS** + +True if version >= threshold. |