Skip to content
Merged
Show file tree
Hide file tree
Changes from 11 commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
9b3f454
Introduce phrasing informing of rolling releases
rgwott Jul 18, 2026
d08d5fd
Fix document history tables for the remaining docs
rgwott Jul 18, 2026
9907dba
Remove "release date" info from acle and neon docs
rgwott Jul 18, 2026
8bd474f
Fix duplicate entry in tables
rgwott Jul 21, 2026
8763605
Fix PR template for new changelog section/phrasing
rgwott Jul 22, 2026
677bff5
Remove reference to branch latest-release (to be deleted)
rgwott Jul 22, 2026
2ef60d5
Update release wording
rgwott Jul 24, 2026
778ef84
Merge branch 'main' into deprecate_releases
rgwott Jul 24, 2026
c87246d
Rollback tables
rgwott Jul 24, 2026
565efbb
Rollback more tables
rgwott Jul 24, 2026
ab3fc46
Reorg changelogs; eliminate references to latest-release
rgwott Aug 6, 2026
ebf69c7
Typo fix and stylistic suggestions by AI
rgwott Aug 6, 2026
4fd0b3b
More stylistic revisions
rgwott Aug 6, 2026
8c947a5
Introduce phrasing informing of rolling releases
rgwott Jul 18, 2026
c542348
Fix document history tables for the remaining docs
rgwott Jul 18, 2026
1e15d38
Remove "release date" info from acle and neon docs
rgwott Jul 18, 2026
f691db8
Fix duplicate entry in tables
rgwott Jul 21, 2026
0480e84
Fix PR template for new changelog section/phrasing
rgwott Jul 22, 2026
a168487
Remove reference to branch latest-release (to be deleted)
rgwott Jul 22, 2026
acc491d
Update release wording
rgwott Jul 24, 2026
1293efd
Rollback tables
rgwott Jul 24, 2026
2539ee4
Rollback more tables
rgwott Jul 24, 2026
386778a
Merge branch 'main' into deprecate_releases
rgwott Aug 6, 2026
1d78625
Fix merge conflict
rgwott Aug 6, 2026
7511170
Fix changes -> changelog; reorder changelog sections
rgwott Aug 10, 2026
0821a21
Current Status and Anticipated Changes -> #support-levels
rgwott Aug 11, 2026
d083e5d
Fix broken hyperrefs
rgwott Aug 12, 2026
54eb44a
Fix discrepancy between neon md and its template
rgwott Aug 14, 2026
049737b
Remove "issue date" line from headers without date-of-issue
rgwott Aug 14, 2026
7332914
Fix missing hyperrefs
rgwott Aug 18, 2026
f20613e
Rephrase a changelog line
rgwott Aug 18, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 2 additions & 3 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).
6 changes: 3 additions & 3 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 for year 20xx** (this year)
of the section **Change Control**/**Document history**
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.
Expand Down
37 changes: 12 additions & 25 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Comment thread
rgwott marked this conversation as resolved.

## Bugs

Expand Down Expand Up @@ -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
Comment thread
rgwott marked this conversation as resolved.
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)
Expand All @@ -68,20 +62,13 @@ 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).

New development (bug-fixes, proposals, extensions, and so on) is
committed on the `main` branch. Therefore, please submit your
PR against the branch `main`.
Development (bug-fixes, proposals, extensions, and so on) is conducted
exclusively on the `main` branch. Therefore, please submit your PR against
`main`.

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 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).

# Contribution agreement

Expand Down
50 changes: 32 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,16 +15,31 @@
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 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

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

does this refer to the current specification or the legacy releases? I thought that the pdf's for the current version will be accessible from https://arm-software.github.io/acle/ as it its today.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Both. legacy releases will continue to exist in github's releases page, and every new commit will generate one entry there as well.
Also the pages will continue linking to the latest versions.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is the rationale behind keeping the rolling pdfs also on https://github.com/ARM-software/acle/releases ?
I was thinking that https://arm-software.github.io/acle/ would be enough am I missing something?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's just my understanding from the requirements and discussions. Keeping the artifacts in the releases page gets you quick access to any version, and the webpage also points to it.

[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.

## 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

Expand All @@ -43,19 +58,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

Expand Down
60 changes: 31 additions & 29 deletions main/acle.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
title: Arm C Language Extensions
date-of-issue: 15 May 2026
# LaTeX specific variables
copyright-text: "Copyright: see section \\texorpdfstring{\\nameref{copyright}}{Copyright}."
# Jekyll specific variables
Expand Down Expand Up @@ -117,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:
Expand Down Expand Up @@ -151,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
Comment thread
rgwott marked this conversation as resolved.
Outdated

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** |
| ------------ | ----------------- | ------ | -------------------------------------------------------------------------------------------------------------------- |
Expand Down Expand Up @@ -488,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 after ACLE Q1 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.
Expand Down
34 changes: 19 additions & 15 deletions neon_intrinsics/advsimd.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
title: Arm Neon Intrinsics Reference
date-of-issue: 15 May 2026
# LaTeX specific variables
landscape: true
copyright-text: "Copyright: see section \\texorpdfstring{\\nameref{copyright}}{Copyright}."
Expand Down Expand Up @@ -108,7 +107,18 @@ for more information about Arm’s trademarks.
* Copyright 2014-2026 Arm Limited and/or its affiliates <open-source-office@arm.com>
* Copyright 2021 Matt P. Dziubinski <matdzb@gmail.com>

## Document history
## About this document

### Changelog for year 2026

After leagcy release 2026Q1, this specification is published continuously from
Comment thread
rgwott marked this conversation as resolved.
Outdated
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 |
| ----- | ----------------- | -------------------- |
Expand All @@ -128,12 +138,12 @@ for more information about Arm’s trademarks.
| N | 06 June 2025 | 2025Q2 |
| O | 15 May 2026 | 2026Q1 |

### 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).
Expand All @@ -144,36 +154,30 @@ for more information about Arm’s trademarks.
* 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 since 2026Q1

* Added support for FEAT_F16F32DOT
* Added support for FEAT_F16F32MM and FEAT_F16MM
* Renamed vmmlaq_f16_f16 to vmmlaq_f16

<!---
**** Do not remove! ****
The line following this comment is necessary to generate custom geometry settings
Expand Down
Loading