From 2be2f8aa742aac8b87b0087d1f8983155debd4d3 Mon Sep 17 00:00:00 2001 From: Victor Campos Date: Wed, 25 Sep 2024 14:23:53 +0100 Subject: [PATCH 1/3] Revert "Replace latin contractions i.e. and e.g. (#331)" This partially reverts commit 42e7e86de3e82d4cc527dfeda2a5ed53f6d6cacf. Some documents were not changed if the latin contraction replacements had not taken place. Bumping their version numbers only for these textual replacements is not worth it. --- cmse/cmse.md | 6 +----- morello/morello.md | 6 +----- mve_intrinsics/mve.md | 6 +----- mve_intrinsics/mve.template.md | 6 +----- neon_intrinsics/advsimd.md | 1 - neon_intrinsics/advsimd.template.md | 1 - 6 files changed, 4 insertions(+), 22 deletions(-) diff --git a/cmse/cmse.md b/cmse/cmse.md index 096381ba..e62bd2be 100644 --- a/cmse/cmse.md +++ b/cmse/cmse.md @@ -83,7 +83,7 @@ exceptions. First, several changes were made related to the defined terms so as to reflect the fact that such defined terms need to align with the -terminology in CC-BY-SA-4.0 rather than Apache-2.0 (for example, changing +terminology in CC-BY-SA-4.0 rather than Apache-2.0 (e.g., changing “Work” to “Licensed Material”). Second, the defensive termination clause was changed such that the @@ -163,10 +163,6 @@ Copyright 2019, 2021-2023 Arm Limited and/or its affiliates Date: Wed, 25 Sep 2024 13:32:23 +0100 Subject: [PATCH 2/3] Fix issues in preparation for 2024Q3 release - Fix textual issues raised in reviews. - Remove pointless entry in changelog. --- main/acle.md | 37 ++++++++++++++++++------------------- 1 file changed, 18 insertions(+), 19 deletions(-) diff --git a/main/acle.md b/main/acle.md index 5f23e1b6..5886ab95 100644 --- a/main/acle.md +++ b/main/acle.md @@ -398,19 +398,17 @@ Armv8.4-A [[ARMARMv84]](#ARMARMv84). Support is added for the Dot Product intrin * Fixed incorrect system register dependencies in Function Multi Versioning. * Added a requirement for function version declaration in Function Multi Versioning. -* Fixed some rendering issues in the online Markdown documentation and fixed - a misplaced anchor. * Added `__FUNCTION_MULTI_VERSIONING_SUPPORT_LEVEL` to indicate the support level of the [Function Multi Versioning](#function-multi-versioning). -* Unified Function Multi Versioning features sha1, sha2. -* Unified Function Multi Versioning features ls64, ls64_v, ls64_accdata. +* Unified Function Multi Versioning features sha1 and sha2. +* Unified Function Multi Versioning features ls64, ls64_v, and ls64_accdata. * Added [**Alpha**](#current-status-and-anticipated-changes) support for SME2.1 (FEAT_SME2p1). * Removed requirement to add preprocessor guards for header files. * Added specifications for floating-point absolute minimum and maximum intrinsics (FEAT_FAMINMAX). * Added specifications for table lookup intrinsics (FEAT_LUT, FEAT_SME_LUTv2). -* Release support level of the [Custom Datapath Extension](#custom-datapath-extension). +* Added Release support level for the [Custom Datapath Extension](#custom-datapath-extension). * Added [**Alpha**](#current-status-and-anticipated-changes) support for modal 8-bit floating point intrinsics. @@ -1035,8 +1033,9 @@ Including `` also includes the following header files: `` defines intrinsics for moving data between Neon and SVE vector types; see [NEON-SVE Bridge](#neon-sve-bridge) -for details. The `__ARM_NEON_SVE_BRIDGE` macro should be tested -before including the header: +for details. Before including the header, you should test the +`__ARM_NEON_SVE_BRIDGE` macro. +: ``` c #ifdef __ARM_NEON_SVE_BRIDGE @@ -1099,12 +1098,12 @@ context in which the preprocessor macros are evaluated. For example: void foo() { #ifdef __ARM_FEATURE_SVE // The user should make no assumptions that the target attribute - // has enabled the __ARM_FEATURE_SVE macro. + // enables the __ARM_FEATURE_SVE macro. #endif } ``` -The compiler may add additional restrictions to the intrinsics beyond what is +The compiler might add additional restrictions to the intrinsics beyond what is captured by the ACLE macros depending on the context in which the intrinsics are used. For example: @@ -1118,7 +1117,7 @@ are used. For example: ``` If `__ARM_FEATURE_SME` evaluates to `true` the SME intrinsic `svst1_hor_za8` -is available, but `foo` may still fail to compile because the call does not +is available, but `foo` might still fail to compile because the call does not occur in a [streaming statement](#streaming-statement). ## Attributes @@ -5897,11 +5896,11 @@ float16 types are only available when the `__fp16` type is defined, that is, when supported by the hardware. bfloat types are only available when the `__bf16` type is defined, that is, -when supported by the hardware. The bfloat types are all opaque types. That is -to say they can only be used by intrinsics. +when supported by the hardware. The bfloat types are all opaque types. That is, +they can only be used by intrinsics. -The FP8 types are all opaque types. That is to say they can only be used -by intrinsics. +The FP8 types are all opaque types. That is, they can only be used by +intrinsics. ### Advanced SIMD Scalar data types @@ -6713,7 +6712,7 @@ single vectors: | **Signed integer** | **Unsigned integer** | **Floating-point** | | | -------------------- | -------------------- | -------------------- | -------------------- | -| `svint8_t` | `svuint8_t` | | `svmfloat8_t | +| `svint8_t` | `svuint8_t` | | `svmfloat8_t` | | `svint16_t` | `svuint16_t` | `svfloat16_t` | `svbfloat16_t` | | `svint32_t` | `svuint32_t` | `svfloat32_t` | | | `svint64_t` | `svuint64_t` | `svfloat64_t` | | @@ -12320,8 +12319,8 @@ element types. ### SME2.1 instruction intrinsics The specification for SME2.1 is in -[**Alpha** state](#current-status-and-anticipated-changes) and may change or be -extended in the future. +[**Alpha** state](#current-status-and-anticipated-changes) and might change or +be extended in the future. The intrinsics in this section are defined by the header file [``](#arm_sme.h) when `__ARM_FEATURE_SME2p1` is defined. @@ -13083,7 +13082,7 @@ intrinsics may have additional target feature requirements. #### BFCVTN, FCVTN -Half-precision and BFloat16 convert, narrow and interleave to 8-bit +Half-precision and BFloat16 convert, narrow, and interleave to 8-bit floating-point. ``` c // Variant is also available for: _bf16_x2 @@ -13092,7 +13091,7 @@ floating-point. #### FCVTNT, FCVTNB -Single-precision convert, narrow and interleave to 8-bit floating-point (top and bottom). +Single-precision convert, narrow, and interleave to 8-bit floating-point (top and bottom). ``` c svmfloat8_t svcvtnt_mf8[_f32_x2]_fpm(svmfloat8_t zd, svfloat32x2_t zn, fpm_t fpm); svmfloat8_t svcvtnb_mf8[_f32_x2]_fpm(svmfloat8_t zd, svfloat32x2_t zn, fpm_t fpm); From fc800b171c064002c9cc0d7afa2ebfdd702bb8c9 Mon Sep 17 00:00:00 2001 From: Victor Campos Date: Wed, 25 Sep 2024 14:13:24 +0100 Subject: [PATCH 3/3] Change draftversion and dates --- cmse/cmse.md | 2 +- main/acle.md | 9 +++++---- morello/morello.md | 2 +- mve_intrinsics/mve.md | 2 +- mve_intrinsics/mve.template.md | 2 +- neon_intrinsics/advsimd.md | 9 +++++---- neon_intrinsics/advsimd.template.md | 9 +++++---- 7 files changed, 19 insertions(+), 16 deletions(-) diff --git a/cmse/cmse.md b/cmse/cmse.md index e62bd2be..60fae9d0 100644 --- a/cmse/cmse.md +++ b/cmse/cmse.md @@ -5,7 +5,7 @@ date-of-issue: 21 June 2024 set-quote-highlight: true # LaTeX specific variables copyright-text: Copyright 2019, 2021-2024 Arm Limited and/or its affiliates . -draftversion: true +draftversion: false # Jekyll specific variables header_counter: true toc: true diff --git a/main/acle.md b/main/acle.md index 5886ab95..3bf028b3 100644 --- a/main/acle.md +++ b/main/acle.md @@ -1,10 +1,10 @@ --- title: Arm C Language Extensions -version: 2024Q2 -date-of-issue: 21 June 2024 +version: 2024Q3 +date-of-issue: 30 September 2024 # LaTeX specific variables copyright-text: "Copyright: see section \\texorpdfstring{\\nameref{copyright}}{Copyright}." -draftversion: true +draftversion: false # Jekyll specific variables header_counter: true toc: true @@ -178,6 +178,7 @@ unless a different support level is specified in the text. | 2023Q2 | 04 August 2023 | Arm | See [Changes between ACLE Q4 2022 and ACLE Q2 2023](#changes-between-acle-q4-2022-and-acle-q2-2023) | | 2024Q1 | 11 April 2024 | Arm | See [Changes between ACLE Q2 2023 and ACLE Q1 2024](#changes-between-acle-q2-2023-and-acle-q1-2024) | | 2024Q2 | 21 June 2024 | Arm | See [Changes between ACLE Q1 2024 and ACLE Q2 2024](#changes-between-acle-q1-2024-and-acle-q2-2024) | +| 2024Q3 | 30 September 2024 | Arm | See [Changes between ACLE Q2 2024 and ACLE Q3 2024](#changes-between-acle-q2-2024-and-acle-q3-2024) | #### Changes between ACLE Q2 2017 and ACLE Q2 2018 @@ -394,7 +395,7 @@ Armv8.4-A [[ARMARMv84]](#ARMARMv84). Support is added for the Dot Product intrin * Added [**Alpha**](#current-status-and-anticipated-changes) support for SVE2.1 (FEAT_SVE2p1). -#### Changes for next release +#### Changes between ACLE Q2 2024 and ACLE Q3 2024 * Fixed incorrect system register dependencies in Function Multi Versioning. * Added a requirement for function version declaration in Function Multi Versioning. diff --git a/morello/morello.md b/morello/morello.md index 352d196d..57cbd34f 100644 --- a/morello/morello.md +++ b/morello/morello.md @@ -4,7 +4,7 @@ version: 02alpha date-of-issue: 11 January 2022 # LaTeX specific variables copyright-text: Copyright 2020-2022 Arm Limited and/or its affiliates . -draftversion: true +draftversion: false # Jekyll specific variables header_counter: true toc: true diff --git a/mve_intrinsics/mve.md b/mve_intrinsics/mve.md index f653ebf3..afa93b10 100644 --- a/mve_intrinsics/mve.md +++ b/mve_intrinsics/mve.md @@ -5,7 +5,7 @@ date-of-issue: 11 January 2022 # LaTeX specific variables landscape: true copyright-text: Copyright 2019-2022 Arm Limited and/or its affiliates . -draftversion: true +draftversion: false # Jekyll specific variables header_counter: true toc: true diff --git a/mve_intrinsics/mve.template.md b/mve_intrinsics/mve.template.md index 92f4575e..590d2e19 100644 --- a/mve_intrinsics/mve.template.md +++ b/mve_intrinsics/mve.template.md @@ -5,7 +5,7 @@ date-of-issue: 11 January 2022 # LaTeX specific variables landscape: true copyright-text: Copyright 2019-2022 Arm Limited and/or its affiliates . -draftversion: true +draftversion: false # Jekyll specific variables header_counter: true toc: true diff --git a/neon_intrinsics/advsimd.md b/neon_intrinsics/advsimd.md index 298d4c8d..faeb625f 100644 --- a/neon_intrinsics/advsimd.md +++ b/neon_intrinsics/advsimd.md @@ -1,11 +1,11 @@ --- title: Arm Neon Intrinsics Reference -version: 2023Q2 -date-of-issue: 04 August 2023 +version: 2024Q3 +date-of-issue: 30 September 2024 # LaTeX specific variables landscape: true copyright-text: "Copyright: see section \\texorpdfstring{\\nameref{copyright}}{Copyright}." -draftversion: true +draftversion: false # Jekyll specific variables header_counter: true toc: true @@ -125,6 +125,7 @@ for more information about Arm’s trademarks. | I | 30 September 2021 | 2021Q3 | | J | 11 January 2022 | 2021Q4 | | K | 04 August 2023 | 2023Q2 | +| L | 30 September 2024 | 2024Q3 | ### Changes between 2021Q2 and 2021Q3 @@ -146,7 +147,7 @@ for more information about Arm’s trademarks. * Added support for FEAT_LRCPC3 LDAP1/STL1 intrinsics. -### Changes for next release +### Changes between 2023Q2 and 2024Q3 * Fixed the range of the ``lane`` immediate argument for ``vst2q_lane_f64``. diff --git a/neon_intrinsics/advsimd.template.md b/neon_intrinsics/advsimd.template.md index 5b747f32..0b722658 100644 --- a/neon_intrinsics/advsimd.template.md +++ b/neon_intrinsics/advsimd.template.md @@ -1,11 +1,11 @@ --- title: Arm Neon Intrinsics Reference -version: 2023Q2 -date-of-issue: 04 August 2023 +version: 2024Q3 +date-of-issue: 30 September 2024 # LaTeX specific variables landscape: true copyright-text: "Copyright: see section \\texorpdfstring{{\\nameref{{copyright}}}}{{Copyright}}." -draftversion: true +draftversion: false # Jekyll specific variables header_counter: true toc: true @@ -125,6 +125,7 @@ for more information about Arm’s trademarks. | I | 30 September 2021 | 2021Q3 | | J | 11 January 2022 | 2021Q4 | | K | 04 August 2023 | 2023Q2 | +| L | 30 September 2024 | 2024Q3 | ### Changes between 2021Q2 and 2021Q3 @@ -146,7 +147,7 @@ for more information about Arm’s trademarks. * Added support for FEAT_LRCPC3 LDAP1/STL1 intrinsics. -### Changes for next release +### Changes between 2023Q2 and 2024Q3 * Fixed the range of the ``lane`` immediate argument for ``vst2q_lane_f64``.