From 9b3f4546432ac58665577bd97c3dd412e274685e Mon Sep 17 00:00:00 2001 From: Rodolfo Wottrich Date: Sat, 18 Jul 2026 14:05:30 +0100 Subject: [PATCH 1/9] 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 2/9] 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 3/9] 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 4/9] 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 5/9] 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 6/9] 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 7/9] 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 8/9] 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 9/9] 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