From 9b3f4546432ac58665577bd97c3dd412e274685e Mon Sep 17 00:00:00 2001 From: Rodolfo Wottrich Date: Sat, 18 Jul 2026 14:05:30 +0100 Subject: [PATCH 01/22] Introduce phrasing informing of rolling releases --- .github/ISSUE_TEMPLATE/bug_report.md | 5 +-- CONTRIBUTING.md | 39 +++++++----------- README.md | 51 +++++++++++++++--------- main/acle.md | 59 ++++++++++++++-------------- neon_intrinsics/advsimd.md | 38 +++++++++--------- neon_intrinsics/advsimd.template.md | 38 +++++++++--------- 6 files changed, 120 insertions(+), 110 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index 0b199b66..f60b875d 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -21,8 +21,7 @@ useful for layout problems in the PDF or HTML pages. **Our commitment** -We will work to solve the bug report in time for the upcoming -release. However, we would like to encourage you to submit the fix -yourself, if possible. If you intend to do so and this is your first +We will work to solve the bug report timely. However, we encourage you to submit +the fix yourself, if possible. If you intend to do so and this is your first contribution, we recommend reading our [contribution guidelines](https://github.com/ARM-software/acle/blob/main/CONTRIBUTING.md). diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d42f1a1f..2fcc1e01 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -8,12 +8,11 @@ title: Contribution Guidelines # Thank you for considering contributing! -Contributions are always welcome. We accept [bug fixes](#bugs), -[proposals and new ideas](#proposals-for-new-content), or simply [editorial -improvements](#editorial-improvements). +Contributions are always welcome. We accept bug fixes, proposals and new ideas, +or simply editorial improvements. By submitting a pull request you are implicitly adhering to the -[contribution agreement](#contribution-agreement) +contribution agreement below. ## Bugs @@ -52,14 +51,9 @@ the specifications and stores them in the folder `pdfs`. # Continuous integration -The continuous integration bot executes the script: - -``` - ./build_with_docker.sh -``` - -PDFs are generated automatically in response to a pull request. You -can download the PDFs in the `Actions` tab of any pull request. +The continuous integration bot executes the script and generates PDFs +automatically in response to a pull request. You can download the PDFs in the +`Actions` tab of any pull request. An additional step uses [``markdown-link-check```](https://github.com/tcort/markdown-link-check) @@ -68,20 +62,17 @@ correctly. # Branches and pull requests. -The branch `latest-release` is the release branch, which contains the -code used to build the PDFs of the [latest official -release](https://github.com/ARM-software/acle/releases/latest). The -branch `latest-release` is also used to build the [website of the ACLE -project](https://arm-software.github.io/acle). +Development (bug-fixes, proposals, extensions, and so on) is conducted +exclusively on the `main` branch. Therefore, please submit your PR against +`main`. -New development (bug-fixes, proposals, extensions, and so on) is -committed on the `main` branch. Therefore, please submit your -PR against the branch `main`. +Branch `latest-release` was formerly used to generate releases. We have +moved from quarterly to rolling releases, so `latest-release` is now obsolete. +Do not use. -It is good practice to track changes. In the section `Changes for next -release`, please list any changes that you have made to the -document. For an example, see [this -PR](https://github.com/ARM-software/acle/pull/19). +It is good practice to track changes. In section `Changes since 2026Q1`, +please list any changes that you have made to the document. As an example, see +[this PR](https://github.com/ARM-software/acle/pull/443/changes). # Contribution agreement diff --git a/README.md b/README.md index 2029b04e..ced5692f 100644 --- a/README.md +++ b/README.md @@ -15,16 +15,32 @@ This repository contains the source material from which the specifications for the Arm C Language Extensions (ACLE) are derived. -The latest release of the specifications can be browsed online at +The latest version of the specifications can be browsed online at [arm-software.github.io/acle/](https://arm-software.github.io/acle/). -The PDF version of the documents can be retrieved from the [latest -release](https://github.com/ARM-software/acle/releases/latest) page. +## Versioning -The development version is stored on the branch `main` at -[github.com/ARM-software/acle/](https://github.com/ARM-software/acle/), -while the latest released version is tracked by the branch -`latest-release`. +We have transitioned from a quarterly release schedule to rolling versioning. +The specifications are now updated on every commit as changes are completed and +reviewed, providing more timely access to new features, clarifications, and +corrections. + +The PDF version of the documents can be retrieved from the +[releases](https://github.com/ARM-software/acle/releases) page. + +Branch `main` at +[github.com/ARM-software/acle/](https://github.com/ARM-software/acle/) is +ACLE's main development branch. Branch `latest-release` tracks the latest +quarterly release, and is now considered legacy. + +## Legacy releases + +Quarterly releases (now considered legacy) up to 2026Q1 are also present in the +[releases](https://github.com/ARM-software/acle/releases) page. + +Pre-GitHub versions of the documents were previously released on +[Arm Developer](https://developer.arm.com), and are also hosted in this +repository, in [Legacy releases](legacyreleases/README.md). ## Contributing @@ -43,19 +59,18 @@ an email to arm.acle@arm.com. ## List of documents -HTML version | PDF version ---- | --- -[Arm C Language Extensions](https://arm-software.github.io/acle/main/) | [download](https://github.com/ARM-software/acle/releases/latest) -[Morello Supplement to the Arm C Language Extensions](https://arm-software.github.io/acle/morello/) | [download](https://github.com/ARM-software/acle/releases/latest) -[Arm MVE Intrinsics](https://arm-software.github.io/acle/mve_intrinsics/) | [download](https://github.com/ARM-software/acle/releases/latest) -[Arm Neon Intrinsics Reference](https://arm-software.github.io/acle/neon_intrinsics/) | [download](https://github.com/ARM-software/acle/releases/latest) -[Arm®v8-M Security Extensions - Requirements on Development Tools](https://arm-software.github.io/acle/cmse/) | [download](https://github.com/ARM-software/acle/releases/latest) +[Arm C Language Extensions](https://arm-software.github.io/acle/main/) -## Legacy releases +[Morello Supplement to the Arm C Language Extensions](https://arm-software.github.io/acle/morello/) + +[Arm MVE Intrinsics](https://arm-software.github.io/acle/mve_intrinsics/) + +[Arm Neon Intrinsics Reference](https://arm-software.github.io/acle/neon_intrinsics/) + +[Arm®v8-M Security Extensions - Requirements on Development Tools](https://arm-software.github.io/acle/cmse/) -Legacy versions of the documents were released on [Arm Developer](https://developer.arm.com). -They are now also hosted in this repository and are to be found in [Legacy releases](legacyreleases/README.md). -They follow the same folder naming scheme as the main document folders. +The PDF versions can be found in the latest GitHub +[release](https://github.com/ARM-software/acle/releases/latest). # License diff --git a/main/acle.md b/main/acle.md index 470abd48..7d4ff448 100644 --- a/main/acle.md +++ b/main/acle.md @@ -121,7 +121,7 @@ about Arm’s trademarks. ### Change control -#### Current Status and Anticipated Changes +#### Current status and anticipated changes The following support level definitions are used by the ACLE specifications: @@ -155,34 +155,35 @@ unless a different support level is specified in the text. #### Change history -| **Issue** | **Date** | **By** | **Change** | -| ------------ | ----------------- | ------ | -------------------------------------------------------------------------------------------------------------------- | -| A | 11/11/11 | AG | First release | -| B | 13/11/13 | AG | Version 1.1. Editorial changes. Corrections and completions to intrinsics as detailed in 3.3. Updated for C11/C++11. | -| C | 09/05/14 | TB | Version 2.0. Updated for Armv8 AArch32 and AArch64. | -| D | 24/03/16 | TB | Version 2.1. Updated for Armv8.1 AArch32 and AArch64. | -| E | 02/06/17 | Arm | Version ACLE Q2 2017. Updated for Armv8.2-A and Armv8.3-A. | -| F | 30/04/18 | Arm | Version ACLE Q2 2018. Updated for Armv8.4-A. | -| G | 30/03/19 | Arm | Version ACLE Q1 2019. Updated for Armv8.5-A and MVE. Various bugfixes. | -| H | 30/06/19 | Arm | Version ACLE Q2 2019. Updated for TME and more Armv8.5-A intrinsics. Various bugfixes. | -| ACLE Q3 2019 | 30/09/19 | Arm | Version ACLE Q3 2019. | -| ACLE Q4 2019 | 31/12/19 | Arm | Version ACLE Q4 2019. | -| ACLE Q2 2020 | 31/05/20 | Arm | Version ACLE Q2 2020. | -| ACLE Q3 2020 | 31/10/20 | Arm | Version ACLE Q3 2020. | -| 2021Q2 | 02 July 2021 | Arm | Version ACLE Q2 2021. Open source version. NFCI. | -| 2021Q3 | 30 September 2021 | Arm | Minor re-wording. NFCI. | -| 2021Q4 | 11 January 2022 | Arm | See [Changes between ACLE Q3 2021 and ACLE Q4 2021](#changes-between-acle-q3-2021-and-acle-q4-2021) | -| 2022Q1 | 06 April 2022 | Arm | See [Changes between ACLE Q4 2021 and ACLE Q1 2022](#changes-between-acle-q4-2021-and-acle-q1-2022) | -| 2022Q2 | 01 Jul 2022 | Arm | See [Changes between ACLE Q1 2021 and ACLE Q2 2022](#changes-between-acle-q1-2022-and-acle-q2-2022) | -| 2022Q4 | 23 November 2022 | Arm | See [Changes between ACLE Q2 2022 and ACLE Q4 2022](#changes-between-acle-q2-2022-and-acle-q4-2022) | -| 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) | -| 2024Q4 | 21 February 2025 | Arm | See [Changes between ACLE Q3 2024 and ACLE Q4 2024](#changes-between-acle-q3-2024-and-acle-q4-2024) | -| 2025Q2 | 06 June 2025 | Arm | See [Changes between ACLE Q4 2024 and ACLE Q2 2025](#changes-between-acle-q4-2024-and-acle-q2-2025) | -| 2025Q3 | 14 November 2025 | Arm | See [Changes between ACLE Q2 2025 and ACLE Q3 2025](#changes-between-acle-q2-2025-and-acle-q3-2025) | -| 2026Q1 | 15 May 2026 | Arm | See [Changes between ACLE Q3 2025 and ACLE Q1 2026](#changes-between-acle-q3-2025-and-acle-q1-2026) | +| **Issue** | **Date** | **By** | **Change** | +| ---------------- | ----------------- | ------ | -------------------------------------------------------------------------------------------------------------------- | +| A | 11/11/11 | AG | First release | +| B | 13/11/13 | AG | Version 1.1. Editorial changes. Corrections and completions to intrinsics as detailed in 3.3. Updated for C11/C++11. | +| C | 09/05/14 | TB | Version 2.0. Updated for Armv8 AArch32 and AArch64. | +| D | 24/03/16 | TB | Version 2.1. Updated for Armv8.1 AArch32 and AArch64. | +| E | 02/06/17 | Arm | Version ACLE Q2 2017. Updated for Armv8.2-A and Armv8.3-A. | +| F | 30/04/18 | Arm | Version ACLE Q2 2018. Updated for Armv8.4-A. | +| G | 30/03/19 | Arm | Version ACLE Q1 2019. Updated for Armv8.5-A and MVE. Various bugfixes. | +| H | 30/06/19 | Arm | Version ACLE Q2 2019. Updated for TME and more Armv8.5-A intrinsics. Various bugfixes. | +| ACLE Q3 2019 | 30/09/19 | Arm | Version ACLE Q3 2019. | +| ACLE Q4 2019 | 31/12/19 | Arm | Version ACLE Q4 2019. | +| ACLE Q2 2020 | 31/05/20 | Arm | Version ACLE Q2 2020. | +| ACLE Q3 2020 | 31/10/20 | Arm | Version ACLE Q3 2020. | +| 2021Q2 | 02 July 2021 | Arm | Version ACLE Q2 2021. Open source version. NFCI. | +| 2021Q3 | 30 September 2021 | Arm | Minor re-wording. NFCI. | +| 2021Q4 | 11 January 2022 | Arm | See [Changes between ACLE Q3 2021 and ACLE Q4 2021](#changes-between-acle-q3-2021-and-acle-q4-2021) | +| 2022Q1 | 06 April 2022 | Arm | See [Changes between ACLE Q4 2021 and ACLE Q1 2022](#changes-between-acle-q4-2021-and-acle-q1-2022) | +| 2022Q2 | 01 Jul 2022 | Arm | See [Changes between ACLE Q1 2021 and ACLE Q2 2022](#changes-between-acle-q1-2022-and-acle-q2-2022) | +| 2022Q4 | 23 November 2022 | Arm | See [Changes between ACLE Q2 2022 and ACLE Q4 2022](#changes-between-acle-q2-2022-and-acle-q4-2022) | +| 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) | +| 2024Q4 | 21 February 2025 | Arm | See [Changes between ACLE Q3 2024 and ACLE Q4 2024](#changes-between-acle-q3-2024-and-acle-q4-2024) | +| 2025Q2 | 06 June 2025 | Arm | See [Changes between ACLE Q4 2024 and ACLE Q2 2025](#changes-between-acle-q4-2024-and-acle-q2-2025) | +| 2025Q3 | 14 November 2025 | Arm | See [Changes between ACLE Q2 2025 and ACLE Q3 2025](#changes-between-acle-q2-2025-and-acle-q3-2025) | +| 2026Q1 | 15 May 2026 | Arm | See [Changes between ACLE Q3 2025 and ACLE Q1 2026](#changes-between-acle-q3-2025-and-acle-q1-2026) | +| Rolling releases | Every commit | Arm | See [Changes after ACLE Q1 2026](#changes-after-acle-q1-2026) | #### Changes between ACLE Q2 2017 and ACLE Q2 2018 diff --git a/neon_intrinsics/advsimd.md b/neon_intrinsics/advsimd.md index e8ceab6d..561e3920 100644 --- a/neon_intrinsics/advsimd.md +++ b/neon_intrinsics/advsimd.md @@ -112,23 +112,25 @@ for more information about Arm’s trademarks. ## Document history -| Issue | Date | Change | -| ----- | ----------------- | -------------------- | -| A | 09 May 2014 | First release | -| B | 24 March 2016 | Updated for ARMv8.1 | -| C | 30 March 2019 | Version ACLE Q1 2019 | -| D | 30 June 2019 | Version ACLE Q2 2019 | -| E | 30 Sept 2019 | Version ACLE Q3 2019 | -| F | 30 May 2020 | Version ACLE Q2 2020 | -| G | 30 October 2020 | Version ACLE Q3 2020 | -| H | 02 July 2021 | 2021Q2 | -| I | 30 September 2021 | 2021Q3 | -| J | 11 January 2022 | 2021Q4 | -| K | 04 August 2023 | 2023Q2 | -| L | 30 September 2024 | 2024Q3 | -| M | 21 February 2025 | 2024Q4 | -| N | 06 June 2025 | 2025Q2 | -| O | 15 May 2026 | 2026Q1 | +| Issue | Date | Change | +| ---------------- | ----------------- | ------------------------------------------------- | +| A | 09 May 2014 | First release | +| B | 24 March 2016 | Updated for ARMv8.1 | +| C | 30 March 2019 | Version ACLE Q1 2019 | +| D | 30 June 2019 | Version ACLE Q2 2019 | +| E | 30 Sept 2019 | Version ACLE Q3 2019 | +| F | 30 May 2020 | Version ACLE Q2 2020 | +| G | 30 October 2020 | Version ACLE Q3 2020 | +| H | 02 July 2021 | 2021Q2 | +| I | 30 September 2021 | 2021Q3 | +| J | 11 January 2022 | 2021Q4 | +| K | 04 August 2023 | 2023Q2 | +| L | 30 September 2024 | 2024Q3 | +| M | 21 February 2025 | 2024Q4 | +| N | 06 June 2025 | 2025Q2 | +| O | 15 May 2026 | 2026Q1 | +| O | 15 May 2026 | 2026Q1 | +| Rolling releases | Every commit | See [Changes after 2026Q1](#changes-after-2026q1) | ### Changes between 2021Q2 and 2021Q3 @@ -170,7 +172,7 @@ for more information about Arm’s trademarks. floating point conversion intrinsics from "Half Precision to 32-bit" and "Half Precision to 64-bit". -### Changes since 2026Q1 +### Changes after 2026Q1 * Added support for FEAT_F16F32DOT * Added support for FEAT_F16F32MM and FEAT_F16MM diff --git a/neon_intrinsics/advsimd.template.md b/neon_intrinsics/advsimd.template.md index c87f2781..7fa67f13 100644 --- a/neon_intrinsics/advsimd.template.md +++ b/neon_intrinsics/advsimd.template.md @@ -112,23 +112,25 @@ for more information about Arm’s trademarks. ## Document history -| Issue | Date | Change | -| ----- | ----------------- | -------------------- | -| A | 09 May 2014 | First release | -| B | 24 March 2016 | Updated for ARMv8.1 | -| C | 30 March 2019 | Version ACLE Q1 2019 | -| D | 30 June 2019 | Version ACLE Q2 2019 | -| E | 30 Sept 2019 | Version ACLE Q3 2019 | -| F | 30 May 2020 | Version ACLE Q2 2020 | -| G | 30 October 2020 | Version ACLE Q3 2020 | -| H | 02 July 2021 | 2021Q2 | -| I | 30 September 2021 | 2021Q3 | -| J | 11 January 2022 | 2021Q4 | -| K | 04 August 2023 | 2023Q2 | -| L | 30 September 2024 | 2024Q3 | -| M | 21 February 2025 | 2024Q4 | -| N | 06 June 2025 | 2025Q2 | -| O | 15 May 2026 | 2026Q1 | +| Issue | Date | Change | +| ---------------- | ----------------- | ------------------------------------------------- | +| A | 09 May 2014 | First release | +| B | 24 March 2016 | Updated for ARMv8.1 | +| C | 30 March 2019 | Version ACLE Q1 2019 | +| D | 30 June 2019 | Version ACLE Q2 2019 | +| E | 30 Sept 2019 | Version ACLE Q3 2019 | +| F | 30 May 2020 | Version ACLE Q2 2020 | +| G | 30 October 2020 | Version ACLE Q3 2020 | +| H | 02 July 2021 | 2021Q2 | +| I | 30 September 2021 | 2021Q3 | +| J | 11 January 2022 | 2021Q4 | +| K | 04 August 2023 | 2023Q2 | +| L | 30 September 2024 | 2024Q3 | +| M | 21 February 2025 | 2024Q4 | +| N | 06 June 2025 | 2025Q2 | +| O | 15 May 2026 | 2026Q1 | +| O | 15 May 2026 | 2026Q1 | +| Rolling releases | Every commit | See [Changes after 2026Q1](#changes-after-2026q1) | ### Changes between 2021Q2 and 2021Q3 @@ -170,7 +172,7 @@ for more information about Arm’s trademarks. floating point conversion intrinsics from "Half Precision to 32-bit" and "Half Precision to 64-bit". -### Changes since 2026Q1 +### Changes after 2026Q1 * Added support for FEAT_F16F32DOT * Added support for FEAT_F16F32MM and FEAT_F16MM From d08d5fddfd7dd157298070821a7f39279b21c604 Mon Sep 17 00:00:00 2001 From: Rodolfo Wottrich Date: Sat, 18 Jul 2026 19:04:02 +0100 Subject: [PATCH 02/22] Fix document history tables for the remaining docs --- cmse/cmse.md | 15 ++++++++------- morello/morello.md | 11 ++++++----- mve_intrinsics/mve.md | 17 +++++++++-------- mve_intrinsics/mve.template.md | 17 +++++++++-------- 4 files changed, 32 insertions(+), 28 deletions(-) diff --git a/cmse/cmse.md b/cmse/cmse.md index e62bd2be..adc653d1 100644 --- a/cmse/cmse.md +++ b/cmse/cmse.md @@ -123,13 +123,14 @@ Copyright 2019, 2021-2023 Arm Limited and/or its affiliates Date: Sat, 18 Jul 2026 19:23:26 +0100 Subject: [PATCH 03/22] Remove "release date" info from acle and neon docs --- main/acle.md | 2 -- neon_intrinsics/advsimd.md | 2 -- neon_intrinsics/advsimd.template.md | 2 -- 3 files changed, 6 deletions(-) diff --git a/main/acle.md b/main/acle.md index 7d4ff448..7538b91e 100644 --- a/main/acle.md +++ b/main/acle.md @@ -1,7 +1,5 @@ --- title: Arm C Language Extensions -version: 2026Q1 -date-of-issue: 15 May 2026 # LaTeX specific variables copyright-text: "Copyright: see section \\texorpdfstring{\\nameref{copyright}}{Copyright}." draftversion: true diff --git a/neon_intrinsics/advsimd.md b/neon_intrinsics/advsimd.md index 561e3920..8ad2242e 100644 --- a/neon_intrinsics/advsimd.md +++ b/neon_intrinsics/advsimd.md @@ -1,7 +1,5 @@ --- title: Arm Neon Intrinsics Reference -version: 2026Q1 -date-of-issue: 15 May 2026 # LaTeX specific variables landscape: true copyright-text: "Copyright: see section \\texorpdfstring{\\nameref{copyright}}{Copyright}." diff --git a/neon_intrinsics/advsimd.template.md b/neon_intrinsics/advsimd.template.md index 7fa67f13..c0ec3b59 100644 --- a/neon_intrinsics/advsimd.template.md +++ b/neon_intrinsics/advsimd.template.md @@ -1,7 +1,5 @@ --- title: Arm Neon Intrinsics Reference -version: 2026Q1 -date-of-issue: 15 May 2026 # LaTeX specific variables landscape: true copyright-text: "Copyright: see section \\texorpdfstring{{\\nameref{{copyright}}}}{{Copyright}}." From 8bd474fc42e5f57f512dc59ead26dd669a099850 Mon Sep 17 00:00:00 2001 From: Rodolfo Wottrich Date: Tue, 21 Jul 2026 10:39:08 +0100 Subject: [PATCH 04/22] Fix duplicate entry in tables --- neon_intrinsics/advsimd.md | 1 - neon_intrinsics/advsimd.template.md | 1 - 2 files changed, 2 deletions(-) diff --git a/neon_intrinsics/advsimd.md b/neon_intrinsics/advsimd.md index 8ad2242e..06d1034d 100644 --- a/neon_intrinsics/advsimd.md +++ b/neon_intrinsics/advsimd.md @@ -127,7 +127,6 @@ for more information about Arm’s trademarks. | M | 21 February 2025 | 2024Q4 | | N | 06 June 2025 | 2025Q2 | | O | 15 May 2026 | 2026Q1 | -| O | 15 May 2026 | 2026Q1 | | Rolling releases | Every commit | See [Changes after 2026Q1](#changes-after-2026q1) | ### Changes between 2021Q2 and 2021Q3 diff --git a/neon_intrinsics/advsimd.template.md b/neon_intrinsics/advsimd.template.md index c0ec3b59..358ee596 100644 --- a/neon_intrinsics/advsimd.template.md +++ b/neon_intrinsics/advsimd.template.md @@ -127,7 +127,6 @@ for more information about Arm’s trademarks. | M | 21 February 2025 | 2024Q4 | | N | 06 June 2025 | 2025Q2 | | O | 15 May 2026 | 2026Q1 | -| O | 15 May 2026 | 2026Q1 | | Rolling releases | Every commit | See [Changes after 2026Q1](#changes-after-2026q1) | ### Changes between 2021Q2 and 2021Q3 From 87636055b90be6b373849184e77a879a049ca6b0 Mon Sep 17 00:00:00 2001 From: Rodolfo Wottrich Date: Wed, 22 Jul 2026 12:20:21 +0100 Subject: [PATCH 05/22] Fix PR template for new changelog section/phrasing --- .github/PULL_REQUEST_TEMPLATE.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index f7679e85..95b94173 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -50,9 +50,9 @@ Checklist: (mark with ``X`` those which apply) patch will be automatically checked in the Actions of the pull request. * [ ] I have added an item that describes the changes I have - introduced in this PR in the section **Changes for next - release** of the section **Change Control**/**Document history** - of the document. Create **Changes for next release** if it does + introduced in this PR in the section **Changes after ACLE Q1 2026** + of the section **Change Control**/**Document history** + of the document. Create **Changes after ACLE Q1 2026** if it does not exist. Notice that changes that are not modifying the content and rendering of the specifications (both HTML and PDF) do not need to be listed. From 677bff5568399161f28fdb1bb29450cd0152d123 Mon Sep 17 00:00:00 2001 From: Rodolfo Wottrich Date: Wed, 22 Jul 2026 12:23:47 +0100 Subject: [PATCH 06/22] Remove reference to branch latest-release (to be deleted) --- CONTRIBUTING.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2fcc1e01..82e7a0ae 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -66,11 +66,7 @@ Development (bug-fixes, proposals, extensions, and so on) is conducted exclusively on the `main` branch. Therefore, please submit your PR against `main`. -Branch `latest-release` was formerly used to generate releases. We have -moved from quarterly to rolling releases, so `latest-release` is now obsolete. -Do not use. - -It is good practice to track changes. In section `Changes since 2026Q1`, +It is good practice to track changes. In section `Changes after ACLE Q1 2026`, please list any changes that you have made to the document. As an example, see [this PR](https://github.com/ARM-software/acle/pull/443/changes). From 2ef60d540819f842272438c173355a2f0daea338 Mon Sep 17 00:00:00 2001 From: Rodolfo Wottrich Date: Fri, 24 Jul 2026 10:16:25 +0100 Subject: [PATCH 07/22] Update release wording --- .github/PULL_REQUEST_TEMPLATE.md | 4 ++-- README.md | 8 ++++---- cmse/cmse.md | 1 - main/acle.md | 10 ++++++++-- morello/morello.md | 1 - mve_intrinsics/mve.md | 1 - mve_intrinsics/mve.template.md | 1 - neon_intrinsics/advsimd.md | 10 ++++++++-- neon_intrinsics/advsimd.template.md | 10 ++++++++-- 9 files changed, 30 insertions(+), 16 deletions(-) diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 95b94173..50280eee 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -50,9 +50,9 @@ Checklist: (mark with ``X`` those which apply) patch will be automatically checked in the Actions of the pull request. * [ ] I have added an item that describes the changes I have - introduced in this PR in the section **Changes after ACLE Q1 2026** + introduced in this PR in the section **Changes for year 20xx** (this year) of the section **Change Control**/**Document history** - of the document. Create **Changes after ACLE Q1 2026** if it does + of the document. Create **Changes for year 20xx** if it does not exist. Notice that changes that are not modifying the content and rendering of the specifications (both HTML and PDF) do not need to be listed. diff --git a/README.md b/README.md index ced5692f..a64b7610 100644 --- a/README.md +++ b/README.md @@ -20,10 +20,10 @@ The latest version of the specifications can be browsed online at ## Versioning -We have transitioned from a quarterly release schedule to rolling versioning. -The specifications are now updated on every commit as changes are completed and -reviewed, providing more timely access to new features, clarifications, and -corrections. +We have transitioned from a quarterly release schedule to a continuously updated +specification. The specification is now updated on every commit as changes are +completed and reviewed, providing more timely access to new features, +clarifications, and corrections. The PDF version of the documents can be retrieved from the [releases](https://github.com/ARM-software/acle/releases) page. diff --git a/cmse/cmse.md b/cmse/cmse.md index adc653d1..32fc12f5 100644 --- a/cmse/cmse.md +++ b/cmse/cmse.md @@ -130,7 +130,6 @@ Copyright 2019, 2021-2023 Arm Limited and/or its affiliates Date: Fri, 24 Jul 2026 12:01:26 +0100 Subject: [PATCH 08/22] Rollback tables --- main/acle.md | 56 ++++++++++++++--------------- neon_intrinsics/advsimd.md | 34 +++++++++--------- neon_intrinsics/advsimd.template.md | 34 +++++++++--------- 3 files changed, 62 insertions(+), 62 deletions(-) diff --git a/main/acle.md b/main/acle.md index 068bb022..edb5844b 100644 --- a/main/acle.md +++ b/main/acle.md @@ -152,34 +152,34 @@ unless a different support level is specified in the text. #### Change history -| **Issue** | **Date** | **By** | **Change** | -| ---------------- | ----------------- | ------ | -------------------------------------------------------------------------------------------------------------------- | -| A | 11/11/11 | AG | First release | -| B | 13/11/13 | AG | Version 1.1. Editorial changes. Corrections and completions to intrinsics as detailed in 3.3. Updated for C11/C++11. | -| C | 09/05/14 | TB | Version 2.0. Updated for Armv8 AArch32 and AArch64. | -| D | 24/03/16 | TB | Version 2.1. Updated for Armv8.1 AArch32 and AArch64. | -| E | 02/06/17 | Arm | Version ACLE Q2 2017. Updated for Armv8.2-A and Armv8.3-A. | -| F | 30/04/18 | Arm | Version ACLE Q2 2018. Updated for Armv8.4-A. | -| G | 30/03/19 | Arm | Version ACLE Q1 2019. Updated for Armv8.5-A and MVE. Various bugfixes. | -| H | 30/06/19 | Arm | Version ACLE Q2 2019. Updated for TME and more Armv8.5-A intrinsics. Various bugfixes. | -| ACLE Q3 2019 | 30/09/19 | Arm | Version ACLE Q3 2019. | -| ACLE Q4 2019 | 31/12/19 | Arm | Version ACLE Q4 2019. | -| ACLE Q2 2020 | 31/05/20 | Arm | Version ACLE Q2 2020. | -| ACLE Q3 2020 | 31/10/20 | Arm | Version ACLE Q3 2020. | -| 2021Q2 | 02 July 2021 | Arm | Version ACLE Q2 2021. Open source version. NFCI. | -| 2021Q3 | 30 September 2021 | Arm | Minor re-wording. NFCI. | -| 2021Q4 | 11 January 2022 | Arm | See [Changes between ACLE Q3 2021 and ACLE Q4 2021](#changes-between-acle-q3-2021-and-acle-q4-2021) | -| 2022Q1 | 06 April 2022 | Arm | See [Changes between ACLE Q4 2021 and ACLE Q1 2022](#changes-between-acle-q4-2021-and-acle-q1-2022) | -| 2022Q2 | 01 Jul 2022 | Arm | See [Changes between ACLE Q1 2021 and ACLE Q2 2022](#changes-between-acle-q1-2022-and-acle-q2-2022) | -| 2022Q4 | 23 November 2022 | Arm | See [Changes between ACLE Q2 2022 and ACLE Q4 2022](#changes-between-acle-q2-2022-and-acle-q4-2022) | -| 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) | -| 2024Q4 | 21 February 2025 | Arm | See [Changes between ACLE Q3 2024 and ACLE Q4 2024](#changes-between-acle-q3-2024-and-acle-q4-2024) | -| 2025Q2 | 06 June 2025 | Arm | See [Changes between ACLE Q4 2024 and ACLE Q2 2025](#changes-between-acle-q4-2024-and-acle-q2-2025) | -| 2025Q3 | 14 November 2025 | Arm | See [Changes between ACLE Q2 2025 and ACLE Q3 2025](#changes-between-acle-q2-2025-and-acle-q3-2025) | -| 2026Q1 | 15 May 2026 | Arm | See [Changes between ACLE Q3 2025 and ACLE Q1 2026](#changes-between-acle-q3-2025-and-acle-q1-2026) | +| **Issue** | **Date** | **By** | **Change** | +| ------------ | ----------------- | ------ | -------------------------------------------------------------------------------------------------------------------- | +| A | 11/11/11 | AG | First release | +| B | 13/11/13 | AG | Version 1.1. Editorial changes. Corrections and completions to intrinsics as detailed in 3.3. Updated for C11/C++11. | +| C | 09/05/14 | TB | Version 2.0. Updated for Armv8 AArch32 and AArch64. | +| D | 24/03/16 | TB | Version 2.1. Updated for Armv8.1 AArch32 and AArch64. | +| E | 02/06/17 | Arm | Version ACLE Q2 2017. Updated for Armv8.2-A and Armv8.3-A. | +| F | 30/04/18 | Arm | Version ACLE Q2 2018. Updated for Armv8.4-A. | +| G | 30/03/19 | Arm | Version ACLE Q1 2019. Updated for Armv8.5-A and MVE. Various bugfixes. | +| H | 30/06/19 | Arm | Version ACLE Q2 2019. Updated for TME and more Armv8.5-A intrinsics. Various bugfixes. | +| ACLE Q3 2019 | 30/09/19 | Arm | Version ACLE Q3 2019. | +| ACLE Q4 2019 | 31/12/19 | Arm | Version ACLE Q4 2019. | +| ACLE Q2 2020 | 31/05/20 | Arm | Version ACLE Q2 2020. | +| ACLE Q3 2020 | 31/10/20 | Arm | Version ACLE Q3 2020. | +| 2021Q2 | 02 July 2021 | Arm | Version ACLE Q2 2021. Open source version. NFCI. | +| 2021Q3 | 30 September 2021 | Arm | Minor re-wording. NFCI. | +| 2021Q4 | 11 January 2022 | Arm | See [Changes between ACLE Q3 2021 and ACLE Q4 2021](#changes-between-acle-q3-2021-and-acle-q4-2021) | +| 2022Q1 | 06 April 2022 | Arm | See [Changes between ACLE Q4 2021 and ACLE Q1 2022](#changes-between-acle-q4-2021-and-acle-q1-2022) | +| 2022Q2 | 01 Jul 2022 | Arm | See [Changes between ACLE Q1 2021 and ACLE Q2 2022](#changes-between-acle-q1-2022-and-acle-q2-2022) | +| 2022Q4 | 23 November 2022 | Arm | See [Changes between ACLE Q2 2022 and ACLE Q4 2022](#changes-between-acle-q2-2022-and-acle-q4-2022) | +| 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) | +| 2024Q4 | 21 February 2025 | Arm | See [Changes between ACLE Q3 2024 and ACLE Q4 2024](#changes-between-acle-q3-2024-and-acle-q4-2024) | +| 2025Q2 | 06 June 2025 | Arm | See [Changes between ACLE Q4 2024 and ACLE Q2 2025](#changes-between-acle-q4-2024-and-acle-q2-2025) | +| 2025Q3 | 14 November 2025 | Arm | See [Changes between ACLE Q2 2025 and ACLE Q3 2025](#changes-between-acle-q2-2025-and-acle-q3-2025) | +| 2026Q1 | 15 May 2026 | Arm | See [Changes between ACLE Q3 2025 and ACLE Q1 2026](#changes-between-acle-q3-2025-and-acle-q1-2026) | #### Continuously updated specification diff --git a/neon_intrinsics/advsimd.md b/neon_intrinsics/advsimd.md index 075604d9..572a466d 100644 --- a/neon_intrinsics/advsimd.md +++ b/neon_intrinsics/advsimd.md @@ -109,23 +109,23 @@ for more information about Arm’s trademarks. ## Document history -| Issue | Date | Change | -| ---------------- | ----------------- | ------------------------------------------------- | -| A | 09 May 2014 | First release | -| B | 24 March 2016 | Updated for ARMv8.1 | -| C | 30 March 2019 | Version ACLE Q1 2019 | -| D | 30 June 2019 | Version ACLE Q2 2019 | -| E | 30 Sept 2019 | Version ACLE Q3 2019 | -| F | 30 May 2020 | Version ACLE Q2 2020 | -| G | 30 October 2020 | Version ACLE Q3 2020 | -| H | 02 July 2021 | 2021Q2 | -| I | 30 September 2021 | 2021Q3 | -| J | 11 January 2022 | 2021Q4 | -| K | 04 August 2023 | 2023Q2 | -| L | 30 September 2024 | 2024Q3 | -| M | 21 February 2025 | 2024Q4 | -| N | 06 June 2025 | 2025Q2 | -| O | 15 May 2026 | 2026Q1 | +| Issue | Date | Change | +| ----- | ----------------- | -------------------- | +| A | 09 May 2014 | First release | +| B | 24 March 2016 | Updated for ARMv8.1 | +| C | 30 March 2019 | Version ACLE Q1 2019 | +| D | 30 June 2019 | Version ACLE Q2 2019 | +| E | 30 Sept 2019 | Version ACLE Q3 2019 | +| F | 30 May 2020 | Version ACLE Q2 2020 | +| G | 30 October 2020 | Version ACLE Q3 2020 | +| H | 02 July 2021 | 2021Q2 | +| I | 30 September 2021 | 2021Q3 | +| J | 11 January 2022 | 2021Q4 | +| K | 04 August 2023 | 2023Q2 | +| L | 30 September 2024 | 2024Q3 | +| M | 21 February 2025 | 2024Q4 | +| N | 06 June 2025 | 2025Q2 | +| O | 15 May 2026 | 2026Q1 | ### Continuously updated specification diff --git a/neon_intrinsics/advsimd.template.md b/neon_intrinsics/advsimd.template.md index 4a29cf78..2c153664 100644 --- a/neon_intrinsics/advsimd.template.md +++ b/neon_intrinsics/advsimd.template.md @@ -109,23 +109,23 @@ for more information about Arm’s trademarks. ## Document history -| Issue | Date | Change | -| ---------------- | ----------------- | ------------------------------------------------- | -| A | 09 May 2014 | First release | -| B | 24 March 2016 | Updated for ARMv8.1 | -| C | 30 March 2019 | Version ACLE Q1 2019 | -| D | 30 June 2019 | Version ACLE Q2 2019 | -| E | 30 Sept 2019 | Version ACLE Q3 2019 | -| F | 30 May 2020 | Version ACLE Q2 2020 | -| G | 30 October 2020 | Version ACLE Q3 2020 | -| H | 02 July 2021 | 2021Q2 | -| I | 30 September 2021 | 2021Q3 | -| J | 11 January 2022 | 2021Q4 | -| K | 04 August 2023 | 2023Q2 | -| L | 30 September 2024 | 2024Q3 | -| M | 21 February 2025 | 2024Q4 | -| N | 06 June 2025 | 2025Q2 | -| O | 15 May 2026 | 2026Q1 | +| Issue | Date | Change | +| ----- | ----------------- | -------------------- | +| A | 09 May 2014 | First release | +| B | 24 March 2016 | Updated for ARMv8.1 | +| C | 30 March 2019 | Version ACLE Q1 2019 | +| D | 30 June 2019 | Version ACLE Q2 2019 | +| E | 30 Sept 2019 | Version ACLE Q3 2019 | +| F | 30 May 2020 | Version ACLE Q2 2020 | +| G | 30 October 2020 | Version ACLE Q3 2020 | +| H | 02 July 2021 | 2021Q2 | +| I | 30 September 2021 | 2021Q3 | +| J | 11 January 2022 | 2021Q4 | +| K | 04 August 2023 | 2023Q2 | +| L | 30 September 2024 | 2024Q3 | +| M | 21 February 2025 | 2024Q4 | +| N | 06 June 2025 | 2025Q2 | +| O | 15 May 2026 | 2026Q1 | #### Continuously updated specification From 565efbbc01cd756af4e8051d866e66aedfc8e6a5 Mon Sep 17 00:00:00 2001 From: Rodolfo Wottrich Date: Fri, 24 Jul 2026 12:03:32 +0100 Subject: [PATCH 09/22] Rollback more tables --- cmse/cmse.md | 14 +++++++------- morello/morello.md | 10 +++++----- mve_intrinsics/mve.md | 16 ++++++++-------- mve_intrinsics/mve.template.md | 16 ++++++++-------- 4 files changed, 28 insertions(+), 28 deletions(-) diff --git a/cmse/cmse.md b/cmse/cmse.md index 96a672f5..4fa97d99 100644 --- a/cmse/cmse.md +++ b/cmse/cmse.md @@ -121,13 +121,13 @@ Copyright 2019, 2021-2023 Arm Limited and/or its affiliates Date: Thu, 6 Aug 2026 14:37:34 +0100 Subject: [PATCH 10/22] Reorg changelogs; eliminate references to latest-release --- README.md | 3 +- main/acle.md | 66 +++++++++++------------ neon_intrinsics/advsimd.md | 40 +++++++------- neon_intrinsics/advsimd.template.md | 34 ++++++------ tools/howto-build-github-pages-locally.md | 6 --- 5 files changed, 70 insertions(+), 79 deletions(-) diff --git a/README.md b/README.md index da575d70..b30c3dd7 100644 --- a/README.md +++ b/README.md @@ -30,8 +30,7 @@ The PDF version of the documents can be retrieved from the Branch `main` at [github.com/ARM-software/acle/](https://github.com/ARM-software/acle/) is -ACLE's main development branch. Branch `latest-release` tracks the latest -quarterly release, and is now considered legacy. +ACLE's main development branch. ## Legacy releases diff --git a/main/acle.md b/main/acle.md index edb5844b..319f341b 100644 --- a/main/acle.md +++ b/main/acle.md @@ -116,9 +116,7 @@ about Arm’s trademarks. ## About this document -### Change control - -#### Current status and anticipated changes +### Support levels The following support level definitions are used by the ACLE specifications: @@ -150,7 +148,36 @@ specifications: All content in this document is at the **Release** quality level, unless a different support level is specified in the text. -#### Change history +### Changelog for year 2026 + +After leagcy release 2026Q1, this specification is published continuously from +the main branch. Each published version is identified by its Git commit hash. + +* Added [**Alpha**](#current-status-and-anticipated-changes) + support for SVE2.3 (FEAT_SVE2p3), SME2.3 (FEAT_SME2p3), FEAT_F16F32DOT + dot product intrinsics. +* Added [**Alpha**](#current-status-and-anticipated-changes) + support for FEAT_F16F32MM, FEAT_F16MM and FEAT_SVE_B16MM mmla intrinsics. +* Added [**Alpha**](#current-status-and-anticipated-changes) + support for SVE2.3 (FEAT_SVE2p3) and SME2.3 lookup table intrinsics. +* Added [**Alpha**](#current-status-and-anticipated-changes) + support for SVE2.3 (FEAT_SVE2p3) and SME2.3 pairwise operation intrinsics. +* Added [**Alpha**](#current-status-and-anticipated-changes) + support for SVE2.3 (FEAT_SVE2p3) and SME2.3 conversion intrinsics. +* Added [**Alpha**](#current-status-and-anticipated-changes) + support for SVE2.3 (FEAT_SVE2p3) and SME2.3 absolute difference accumulation + intrinsics. +* Added [**Alpha**](#current-status-and-anticipated-changes) + support for SVE2.3 (FEAT_SVE2p3) and SME2.3 shift right narrow intrinsics. +* Bumped armv9.6 intrinsics implementation to [**Beta**](#current-status-and-anticipated-changes) +* Added support for producer-consumer data placement hints. +* Clarified interaction between SME keyword attributes and a common compiler + extension whereby type attributes can be inherited between subsequent + duplicate decls. + +### Legacy changelog + +The changes between legacy releases were as follows: | **Issue** | **Date** | **By** | **Change** | | ------------ | ----------------- | ------ | -------------------------------------------------------------------------------------------------------------------- | @@ -181,13 +208,6 @@ unless a different support level is specified in the text. | 2025Q3 | 14 November 2025 | Arm | See [Changes between ACLE Q2 2025 and ACLE Q3 2025](#changes-between-acle-q2-2025-and-acle-q3-2025) | | 2026Q1 | 15 May 2026 | Arm | See [Changes between ACLE Q3 2025 and ACLE Q1 2026](#changes-between-acle-q3-2025-and-acle-q1-2026) | -#### Continuously updated specification - -After 2026Q1, this specification is published continuously from the -main branch. Each published version is identified by its Git commit hash. - -See [Changes for year 2026](#changes-for-year-2026). - #### Changes between ACLE Q2 2017 and ACLE Q2 2018 Most changes in ACLE Q2 2018 are updates to support features introduced in @@ -494,30 +514,6 @@ Armv8.4-A [[ARMARMv84]](#ARMARMv84). Support is added for the Dot Product intrin for Brain 16-bit floating-point vector multiplication intrinsics. * Redesigned atomic store with hints intrinsics. -#### Changes for year 2026 - -* Added [**Alpha**](#current-status-and-anticipated-changes) - support for SVE2.3 (FEAT_SVE2p3), SME2.3 (FEAT_SME2p3), FEAT_F16F32DOT - dot product intrinsics. -* Added [**Alpha**](#current-status-and-anticipated-changes) - support for FEAT_F16F32MM, FEAT_F16MM and FEAT_SVE_B16MM mmla intrinsics. -* Added [**Alpha**](#current-status-and-anticipated-changes) - support for SVE2.3 (FEAT_SVE2p3) and SME2.3 lookup table intrinsics. -* Added [**Alpha**](#current-status-and-anticipated-changes) - support for SVE2.3 (FEAT_SVE2p3) and SME2.3 pairwise operation intrinsics. -* Added [**Alpha**](#current-status-and-anticipated-changes) - support for SVE2.3 (FEAT_SVE2p3) and SME2.3 conversion intrinsics. -* Added [**Alpha**](#current-status-and-anticipated-changes) - support for SVE2.3 (FEAT_SVE2p3) and SME2.3 absolute difference accumulation - intrinsics. -* Added [**Alpha**](#current-status-and-anticipated-changes) - support for SVE2.3 (FEAT_SVE2p3) and SME2.3 shift right narrow intrinsics. -* Bumped armv9.6 intrinsics implementation to [**Beta**](#current-status-and-anticipated-changes) -* Added support for producer-consumer data placement hints. -* Clarified interaction between SME keyword attributes and a common compiler - extension whereby type attributes can be inherited between subsequent - duplicate decls. - ### References This document refers to the following documents. diff --git a/neon_intrinsics/advsimd.md b/neon_intrinsics/advsimd.md index 572a466d..850d25f9 100644 --- a/neon_intrinsics/advsimd.md +++ b/neon_intrinsics/advsimd.md @@ -107,7 +107,18 @@ for more information about Arm’s trademarks. * Copyright 2014-2026 Arm Limited and/or its affiliates * Copyright 2021 Matt P. Dziubinski -## Document history +## About this document + +### Changelog for year 2026 + +After leagcy release 2026Q1, this specification is published continuously from +the main branch. Each published version is identified by its Git commit hash. + +* Added support for FEAT_F16F32DOT +* Added support for FEAT_F16F32MM and FEAT_F16MM +* Renamed vmmlaq_f16_f16 to vmmlaq_f16 + +### Legacy changelog | Issue | Date | Change | | ----- | ----------------- | -------------------- | @@ -127,19 +138,12 @@ for more information about Arm’s trademarks. | N | 06 June 2025 | 2025Q2 | | O | 15 May 2026 | 2026Q1 | -### Continuously updated specification - -After 2026Q1, this specification is published continuously from the -main branch. Each published version is identified by its Git commit hash. - -See [Changes for year 2026](#changes-for-year-2026). - -### Changes between 2021Q2 and 2021Q3 +#### Changes between 2021Q2 and 2021Q3 * Fixed the guard macro for the base intrinsics. * Corrected ``sdot``, ``udot`` and ``usdot`` specification on AArch32. -### Changes between 2021Q3 and 2021Q4. +#### Changes between 2021Q3 and 2021Q4. * Fixed typo in signature of ``vaddq_s16``. * Updated copyright statement in section [Copyright](#copyright). @@ -150,36 +154,30 @@ See [Changes for year 2026](#changes-for-year-2026). * Added missing item for release 2021Q3 in the table with the list of versions in section [Document history](#document-history). -### Changes between 2021Q4 and 2023Q2 +#### Changes between 2021Q4 and 2023Q2 * Added support for FEAT_LRCPC3 LDAP1/STL1 intrinsics. -### Changes between 2023Q2 and 2024Q3 +#### Changes between 2023Q2 and 2024Q3 * Fixed the range of the ``lane`` immediate argument for ``vst2q_lane_f64``. -### Changes between 2024Q3 and 2024Q4 +#### Changes between 2024Q3 and 2024Q4 * Added `mf8` forms of the `vbsl`, `vluti2` and `vluti4` families of intrinsics. -### Changes between 2024Q4 and 2025Q2 +#### Changes between 2024Q4 and 2025Q2 * Added `fp8` version of the `vget_lane` intrinsic. -### Changes between 2025Q2 and 2026Q1 +#### Changes between 2025Q2 and 2026Q1 * Added support for FEAT_FPRCVT intrinsics. * Fixed typos in the "AArch64 Instruction" and "Result" fields of floating point conversion intrinsics from "Half Precision to 32-bit" and "Half Precision to 64-bit". -### Changes for year 2026 - -* Added support for FEAT_F16F32DOT -* Added support for FEAT_F16F32MM and FEAT_F16MM -* Renamed vmmlaq_f16_f16 to vmmlaq_f16 -