diff options
author | SiCong Li <sicong.li@arm.com> | 2022-05-19 18:58:31 +0100 |
---|---|---|
committer | SiCong Li <sicong.li@arm.com> | 2022-06-06 15:39:43 +0000 |
commit | fe1b1f6d94c196f086122613277ff95062a7e834 (patch) | |
tree | 9d23ad42324a03c50469923d79003e83e81a6633 /docs/user_guide | |
parent | a774d63e99c474e2242dd0429f61d127850b4cfb (diff) | |
download | ComputeLibrary-fe1b1f6d94c196f086122613277ff95062a7e834.tar.gz |
Allow clearer suppression of toolchain and compiler prefixes
Currently it is counterintuitive to disable toolchain prefixes: we need
to pass an empty space to it; passing an empty string would not disable
prefixes but instead instruct the build script to use a set of default
prefixes.
With this patch we restore the intuitive approach of passing an empty
string "" to disable the prefix.
Resolves COMPMID-5353, COMPMID-5380
Signed-off-by: SiCong Li <sicong.li@arm.com>
Change-Id: I2fe84689df9093cf6baf507dde44ca5ebf61023b
Reviewed-on: https://review.mlplatform.org/c/ml/ComputeLibrary/+/7686
Tested-by: Arm Jenkins <bsgcomp@arm.com>
Reviewed-by: Gian Marco Iodice <gianmarco.iodice@arm.com>
Comments-Addressed: Arm Jenkins <bsgcomp@arm.com>
Diffstat (limited to 'docs/user_guide')
-rw-r--r-- | docs/user_guide/how_to_build_and_run_examples.dox | 14 | ||||
-rw-r--r-- | docs/user_guide/release_version_and_change_log.dox | 7 |
2 files changed, 20 insertions, 1 deletions
diff --git a/docs/user_guide/how_to_build_and_run_examples.dox b/docs/user_guide/how_to_build_and_run_examples.dox index ea71f6345e..ed4c6a4029 100644 --- a/docs/user_guide/how_to_build_and_run_examples.dox +++ b/docs/user_guide/how_to_build_and_run_examples.dox @@ -391,9 +391,21 @@ For NDK r18 or older, here is a guide to <a href="https://developer.android.com/ $NDK/build/tools/make_standalone_toolchain.py --arch arm --install-dir $MY_TOOLCHAINS/arm-linux-android-ndk-r18b --stl libc++ --api 21 For NDK r19 or newer, you can directly <a href="https://developer.android.com/ndk/downloads">Download</a> the NDK package for your development platform, without the need to launch the make_standalone_toolchain.py script. You can find all the prebuilt binaries inside $NDK/toolchains/llvm/prebuilt/$OS_ARCH/bin/. -@attention the building script will look for a binary named "aarch64-linux-android-clang++", while the prebuilt binaries will have their API version as a suffix to their filename (e.g. "aarch64-linux-android21-clang++"). You should copy/rename the binary removing this suffix, or - alternatively - create an alias for it. +@parblock +@attention The building script will look for a binary named "aarch64-linux-android-clang++", while the prebuilt binaries will have their API version as a suffix to their filename (e.g. "aarch64-linux-android21-clang++"). You can instruct scons to use the correct version by using a combination of the toolchain_prefix and the "CC" "CXX" environment variables. +@attention For this particular example, you can specify: + CC=clang CXX=clang++ scons toolchain_prefix=aarch64-linux-android21- + +@attention or: + + CC=aarch64-linux-android21-clang CXX=aarch64-linux-android21-clang++ scons toolchain_prefix="" + +@endparblock + +@parblock @attention We used to use gnustl but as of NDK r17 it is deprecated so we switched to libc++ +@endparblock @note Make sure to add the toolchains to your PATH: diff --git a/docs/user_guide/release_version_and_change_log.dox b/docs/user_guide/release_version_and_change_log.dox index 3632b27680..ac6577bae7 100644 --- a/docs/user_guide/release_version_and_change_log.dox +++ b/docs/user_guide/release_version_and_change_log.dox @@ -41,6 +41,13 @@ If there is more than one release in a month then an extra sequential number is @section S2_2_changelog Changelog +v22.08 Public major release + - Build flag change: toolchain_prefix, compiler_prefix: + - Use empty string "" to suppress any prefixes + - Use "auto" to use default (auto) prefixes chosen by the build script. This is the default behavior when unspecified + - Any other string will be used as custom prefixes to the compiler and the rest of toolchain tools + - The default behaviour when prefix is unspecified does not change, but its signifier has been changed from empty string "" to "auto" + v22.05 Public major release - Various bug fixes. - Various optimizations. |