Skip to content
Merged
Show file tree
Hide file tree
Changes from 10 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
51 changes: 33 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 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. 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

Expand All @@ -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

Expand Down
12 changes: 9 additions & 3 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 @@ -119,7 +118,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:
Expand Down Expand Up @@ -182,6 +181,13 @@ 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
Comment thread
rgwott marked this conversation as resolved.
Outdated

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
Expand Down Expand Up @@ -488,7 +494,7 @@ 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
#### Changes for year 2026

* Added [**Alpha**](#current-status-and-anticipated-changes)
support for SVE2.3 (FEAT_SVE2p3), SME2.3 (FEAT_SME2p3), FEAT_F16F32DOT
Expand Down
10 changes: 8 additions & 2 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 @@ -128,6 +127,13 @@ for more information about Arm’s trademarks.
| N | 06 June 2025 | 2025Q2 |
| O | 15 May 2026 | 2026Q1 |

### Continuously updated specification
Comment thread
rockdreamer marked this conversation as resolved.
Outdated

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

* Fixed the guard macro for the base intrinsics.
Expand Down Expand Up @@ -168,7 +174,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 for year 2026

* Added support for FEAT_F16F32DOT
* Added support for FEAT_F16F32MM and FEAT_F16MM
Expand Down
10 changes: 8 additions & 2 deletions neon_intrinsics/advsimd.template.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 @@ -128,6 +127,13 @@ 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

* Fixed the guard macro for the base intrinsics.
Expand Down Expand Up @@ -168,7 +174,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 for year 2026

* Added support for FEAT_F16F32DOT
* Added support for FEAT_F16F32MM and FEAT_F16MM
Expand Down
Loading