From 877011dd369e5398179478aa7f44e1691dda99e2 Mon Sep 17 00:00:00 2001 From: Nicole Mazzuca Date: Tue, 30 Mar 2021 13:05:55 -0700 Subject: [PATCH] [native supports-expr] docs changes --- docs/maintainers/control-files.md | 1 + docs/maintainers/manifest-files.md | 4 +++- docs/users/host-dependencies.md | 6 ++++++ 3 files changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/maintainers/control-files.md b/docs/maintainers/control-files.md index 4951a8888ba3a9..c98d35ce80a3a5 100644 --- a/docs/maintainers/control-files.md +++ b/docs/maintainers/control-files.md @@ -137,6 +137,7 @@ The grammar for the supports expression uses standard operators: - `(expr)` - grouping/precedence The predefined expressions are computed from standard triplet settings: +- `native` - `TARGET_TRIPLET` == `HOST_TRIPLET` - `x64` - `VCPKG_TARGET_ARCHITECTURE` == `"x64"` - `x86` - `VCPKG_TARGET_ARCHITECTURE` == `"x86"` - `arm` - `VCPKG_TARGET_ARCHITECTURE` == `"arm"` or `VCPKG_TARGET_ARCHITECTURE` == `"arm64"` diff --git a/docs/maintainers/manifest-files.md b/docs/maintainers/manifest-files.md index 3e79aa08a0ca2d..1ec593b72d32e2 100644 --- a/docs/maintainers/manifest-files.md +++ b/docs/maintainers/manifest-files.md @@ -361,7 +361,7 @@ platform-expression = | platform-expression-and | platform-expression-or ; -platform-expression-identifier = +platform-expression-identifier = | identifier-character, { identifier-character }, optional-whitespace ; platform-expression-simple = @@ -387,6 +387,8 @@ Ands and ors are a list of `&` or `|` separated identifiers, negated expressions One may not mix `&` and `|` without parentheses for grouping. These predefined identifier expressions are computed from standard triplet settings: +- `native` - `TARGET_TRIPLET` == `HOST_TRIPLET`; + useful for ports which depend on their own built binaries in their build. - `x64` - `VCPKG_TARGET_ARCHITECTURE` == `"x64"` - `x86` - `VCPKG_TARGET_ARCHITECTURE` == `"x86"` - `arm` - `VCPKG_TARGET_ARCHITECTURE` == `"arm"` or `VCPKG_TARGET_ARCHITECTURE` == `"arm64"` diff --git a/docs/users/host-dependencies.md b/docs/users/host-dependencies.md index 061e21804518be..6521d28dd961ba 100644 --- a/docs/users/host-dependencies.md +++ b/docs/users/host-dependencies.md @@ -57,3 +57,9 @@ else() # This is a cross build endif() ``` + +## Host-only ports + +Some ports are host-only: script ports and tool ports are common examples. +In this case, you can use the `"native"` supports expression to describe this. +This supports expression is true when `TARGET_TRIPLET == HOST_TRIPLET`.