Skip to content

Commit

Permalink
Merge branch 'main' into fmv-mte
Browse files Browse the repository at this point in the history
  • Loading branch information
labrinea authored Oct 3, 2024
2 parents d79338a + 677e365 commit c7adb8a
Show file tree
Hide file tree
Showing 7 changed files with 34 additions and 50 deletions.
6 changes: 1 addition & 5 deletions cmse/cmse.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ exceptions.

First, several changes were made related to the defined terms so as to
reflect the fact that such defined terms need to align with the
terminology in CC-BY-SA-4.0 rather than Apache-2.0 (for example, changing
terminology in CC-BY-SA-4.0 rather than Apache-2.0 (e.g., changing
“Work” to “Licensed Material”).

Second, the defensive termination clause was changed such that the
Expand Down Expand Up @@ -163,10 +163,6 @@ Copyright 2019, 2021-2023 Arm Limited and/or its affiliates <open-source-office@
* Added [Requirement #58](#requirement-58) to address a security issue in the
handling of return values from CMSE Non-secure calls.

#### Changes for next release

* Textual improvements (non-functional changes).

## References

This document refers to the following documents.
Expand Down
44 changes: 22 additions & 22 deletions main/acle.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Arm C Language Extensions
version: 2024Q2
date-of-issue: 21 June 2024
version: 2024Q3
date-of-issue: 30 September 2024
# LaTeX specific variables
copyright-text: "Copyright: see section \\texorpdfstring{\\nameref{copyright}}{Copyright}."
draftversion: true
Expand Down Expand Up @@ -178,6 +178,7 @@ unless a different support level is specified in the text.
| 2023Q2 | 04 August 2023 | Arm | See [Changes between ACLE Q4 2022 and ACLE Q2 2023](#changes-between-acle-q4-2022-and-acle-q2-2023) |
| 2024Q1 | 11 April 2024 | Arm | See [Changes between ACLE Q2 2023 and ACLE Q1 2024](#changes-between-acle-q2-2023-and-acle-q1-2024) |
| 2024Q2 | 21 June 2024 | Arm | See [Changes between ACLE Q1 2024 and ACLE Q2 2024](#changes-between-acle-q1-2024-and-acle-q2-2024) |
| 2024Q3 | 30 September 2024 | Arm | See [Changes between ACLE Q2 2024 and ACLE Q3 2024](#changes-between-acle-q2-2024-and-acle-q3-2024) |

#### Changes between ACLE Q2 2017 and ACLE Q2 2018

Expand Down Expand Up @@ -394,24 +395,22 @@ Armv8.4-A [[ARMARMv84]](#ARMARMv84). Support is added for the Dot Product intrin
* Added [**Alpha**](#current-status-and-anticipated-changes)
support for SVE2.1 (FEAT_SVE2p1).

#### Changes for next release
#### Changes between ACLE Q2 2024 and ACLE Q3 2024

* Fixed incorrect system register dependencies in Function Multi Versioning.
* Added a requirement for function version declaration in Function Multi Versioning.
* Fixed some rendering issues in the online Markdown documentation and fixed
a misplaced anchor.
* Added `__FUNCTION_MULTI_VERSIONING_SUPPORT_LEVEL` to indicate the support
level of the [Function Multi Versioning](#function-multi-versioning).
* Unified Function Multi Versioning features sha1, sha2.
* Unified Function Multi Versioning features ls64, ls64_v, ls64_accdata.
* Unified Function Multi Versioning features sha1 and sha2.
* Unified Function Multi Versioning features ls64, ls64_v, and ls64_accdata.
* Unified Function Multi Versioning features memtag and memtag2.
* Added [**Alpha**](#current-status-and-anticipated-changes)
support for SME2.1 (FEAT_SME2p1).
* Removed requirement to add preprocessor guards for header files.
* Added specifications for floating-point absolute minimum
and maximum intrinsics (FEAT_FAMINMAX).
* Added specifications for table lookup intrinsics (FEAT_LUT, FEAT_SME_LUTv2).
* Release support level of the [Custom Datapath Extension](#custom-datapath-extension).
* Added Release support level for the [Custom Datapath Extension](#custom-datapath-extension).
* Added [**Alpha**](#current-status-and-anticipated-changes)
support for modal 8-bit floating point intrinsics.

Expand Down Expand Up @@ -1036,8 +1035,9 @@ Including `<arm_sve.h>` also includes the following header files:

`<arm_neon_sve_bridge.h>` defines intrinsics for moving data between
Neon and SVE vector types; see [NEON-SVE Bridge](#neon-sve-bridge)
for details. The `__ARM_NEON_SVE_BRIDGE` macro should be tested
before including the header:
for details. Before including the header, you should test the
`__ARM_NEON_SVE_BRIDGE` macro.
:

``` c
#ifdef __ARM_NEON_SVE_BRIDGE
Expand Down Expand Up @@ -1100,12 +1100,12 @@ context in which the preprocessor macros are evaluated. For example:
void foo() {
#ifdef __ARM_FEATURE_SVE
// The user should make no assumptions that the target attribute
// has enabled the __ARM_FEATURE_SVE macro.
// enables the __ARM_FEATURE_SVE macro.
#endif
}
```

The compiler may add additional restrictions to the intrinsics beyond what is
The compiler might add additional restrictions to the intrinsics beyond what is
captured by the ACLE macros depending on the context in which the intrinsics
are used. For example:

Expand All @@ -1119,7 +1119,7 @@ are used. For example:
```

If `__ARM_FEATURE_SME` evaluates to `true` the SME intrinsic `svst1_hor_za8`
is available, but `foo` may still fail to compile because the call does not
is available, but `foo` might still fail to compile because the call does not
occur in a [streaming statement](#streaming-statement).

## Attributes
Expand Down Expand Up @@ -5897,11 +5897,11 @@ float16 types are only available when the `__fp16` type is defined, that is,
when supported by the hardware.

bfloat types are only available when the `__bf16` type is defined, that is,
when supported by the hardware. The bfloat types are all opaque types. That is
to say they can only be used by intrinsics.
when supported by the hardware. The bfloat types are all opaque types. That is,
they can only be used by intrinsics.

The FP8 types are all opaque types. That is to say they can only be used
by intrinsics.
The FP8 types are all opaque types. That is, they can only be used by
intrinsics.

### Advanced SIMD Scalar data types

Expand Down Expand Up @@ -6713,7 +6713,7 @@ single vectors:

| **Signed integer** | **Unsigned integer** | **Floating-point** | |
| -------------------- | -------------------- | -------------------- | -------------------- |
| `svint8_t` | `svuint8_t` | | `svmfloat8_t |
| `svint8_t` | `svuint8_t` | | `svmfloat8_t` |
| `svint16_t` | `svuint16_t` | `svfloat16_t` | `svbfloat16_t` |
| `svint32_t` | `svuint32_t` | `svfloat32_t` | |
| `svint64_t` | `svuint64_t` | `svfloat64_t` | |
Expand Down Expand Up @@ -12320,8 +12320,8 @@ element types.
### SME2.1 instruction intrinsics

The specification for SME2.1 is in
[**Alpha** state](#current-status-and-anticipated-changes) and may change or be
extended in the future.
[**Alpha** state](#current-status-and-anticipated-changes) and might change or
be extended in the future.

The intrinsics in this section are defined by the header file
[`<arm_sme.h>`](#arm_sme.h) when `__ARM_FEATURE_SME2p1` is defined.
Expand Down Expand Up @@ -13083,7 +13083,7 @@ intrinsics may have additional target feature requirements.

#### BFCVTN, FCVTN

Half-precision and BFloat16 convert, narrow and interleave to 8-bit
Half-precision and BFloat16 convert, narrow, and interleave to 8-bit
floating-point.
``` c
// Variant is also available for: _bf16_x2
Expand All @@ -13092,7 +13092,7 @@ floating-point.

#### FCVTNT, FCVTNB

Single-precision convert, narrow and interleave to 8-bit floating-point (top and bottom).
Single-precision convert, narrow, and interleave to 8-bit floating-point (top and bottom).
``` c
svmfloat8_t svcvtnt_mf8[_f32_x2]_fpm(svmfloat8_t zd, svfloat32x2_t zn, fpm_t fpm);
svmfloat8_t svcvtnb_mf8[_f32_x2]_fpm(svmfloat8_t zd, svfloat32x2_t zn, fpm_t fpm);
Expand Down
6 changes: 1 addition & 5 deletions morello/morello.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@ exceptions.

First, several changes were made related to the defined terms so as to
reflect the fact that such defined terms need to align with the
terminology in CC-BY-SA-4.0 rather than Apache-2.0 (for example, changing
terminology in CC-BY-SA-4.0 rather than Apache-2.0 (e.g., changing
"Work" to "Licensed Material").

Second, the defensive termination clause was changed such that the scope
Expand Down Expand Up @@ -168,10 +168,6 @@ All content in this document is at the **Alpha** quality level.
used to render the PDF of the specs. The PDF is rendered using the
standard layout used in Arm specifications.

### Changes for next release

* Textual improvements (non-functional changes).

## References

This document refers to, or is referred to by, the following documents.
Expand Down
6 changes: 1 addition & 5 deletions mve_intrinsics/mve.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ exceptions.

First, several changes were made related to the defined terms so as to
reflect the fact that such defined terms need to align with the
terminology in CC-BY-SA-4.0 rather than Apache-2.0 (for example, changing
terminology in CC-BY-SA-4.0 rather than Apache-2.0 (e.g., changing
"Work" to "Licensed Material").

Second, the defensive termination clause was changed such that the scope
Expand Down Expand Up @@ -127,10 +127,6 @@ Copyright 2019-2022 Arm Limited and/or its affiliates <[email protected]
used to render the PDF of the specs. The PDF is rendered using the
standard layout used in Arm specifications.

### Changes for next release

* Textual improvements (non-functional changes).

<!---
**** Do not remove! ****
The line following this comment is necessary to generate custom geometry settings
Expand Down
6 changes: 1 addition & 5 deletions mve_intrinsics/mve.template.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ exceptions.

First, several changes were made related to the defined terms so as to
reflect the fact that such defined terms need to align with the
terminology in CC-BY-SA-4.0 rather than Apache-2.0 (for example, changing
terminology in CC-BY-SA-4.0 rather than Apache-2.0 (e.g., changing
"Work" to "Licensed Material").

Second, the defensive termination clause was changed such that the scope
Expand Down Expand Up @@ -127,10 +127,6 @@ Copyright 2019-2022 Arm Limited and/or its affiliates <[email protected]
used to render the PDF of the specs. The PDF is rendered using the
standard layout used in Arm specifications.

### Changes for next release

* Textual improvements (non-functional changes).

<!---
**** Do not remove! ****
The line following this comment is necessary to generate custom geometry settings
Expand Down
8 changes: 4 additions & 4 deletions neon_intrinsics/advsimd.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Arm Neon Intrinsics Reference
version: 2023Q2
date-of-issue: 04 August 2023
version: 2024Q3
date-of-issue: 30 September 2024
# LaTeX specific variables
landscape: true
copyright-text: "Copyright: see section \\texorpdfstring{\\nameref{copyright}}{Copyright}."
Expand Down Expand Up @@ -125,6 +125,7 @@ for more information about Arm’s trademarks.
| I | 30 September 2021 | 2021Q3 |
| J | 11 January 2022 | 2021Q4 |
| K | 04 August 2023 | 2023Q2 |
| L | 30 September 2024 | 2024Q3 |

### Changes between 2021Q2 and 2021Q3

Expand All @@ -146,9 +147,8 @@ for more information about Arm’s trademarks.

* Added support for FEAT_LRCPC3 LDAP1/STL1 intrinsics.

### Changes for next release
### Changes between 2023Q2 and 2024Q3

* Textual improvements (non-functional changes).
* Fixed the range of the ``lane`` immediate argument for ``vst2q_lane_f64``.

<!---
Expand Down
8 changes: 4 additions & 4 deletions neon_intrinsics/advsimd.template.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Arm Neon Intrinsics Reference
version: 2023Q2
date-of-issue: 04 August 2023
version: 2024Q3
date-of-issue: 30 September 2024
# LaTeX specific variables
landscape: true
copyright-text: "Copyright: see section \\texorpdfstring{{\\nameref{{copyright}}}}{{Copyright}}."
Expand Down Expand Up @@ -125,6 +125,7 @@ for more information about Arm’s trademarks.
| I | 30 September 2021 | 2021Q3 |
| J | 11 January 2022 | 2021Q4 |
| K | 04 August 2023 | 2023Q2 |
| L | 30 September 2024 | 2024Q3 |

### Changes between 2021Q2 and 2021Q3

Expand All @@ -146,9 +147,8 @@ for more information about Arm’s trademarks.

* Added support for FEAT_LRCPC3 LDAP1/STL1 intrinsics.

### Changes for next release
### Changes between 2023Q2 and 2024Q3

* Textual improvements (non-functional changes).
* Fixed the range of the ``lane`` immediate argument for ``vst2q_lane_f64``.

<!---
Expand Down

0 comments on commit c7adb8a

Please sign in to comment.