Skip to content

Commit fc50eb1

Browse files
Remove request for preprocessor guards from header files.
1 parent 255e9fb commit fc50eb1

File tree

1 file changed

+6
-40
lines changed

1 file changed

+6
-40
lines changed

main/acle.md

Lines changed: 6 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -904,7 +904,6 @@ correctly:
904904

905905
``` c
906906
#include <stdint.h>
907-
// UINT64_C not defined here since we did not set __STDC_FORMAT_MACROS
908907
...
909908
#include <arm_neon.h>
910909
```
@@ -914,9 +913,7 @@ and:
914913
``` c
915914
#include <arm_neon.h>
916915
...
917-
#define __STDC_FORMAT_MACROS
918916
#include <stdint.h>
919-
// ... UINT64_C is now defined
920917
```
921918

922919
### `<arm_acle.h>`
@@ -925,41 +922,32 @@ and:
925922
to the more specific header files below. These intrinsics are in the
926923
C implementation namespace and begin with double underscores. It is
927924
unspecified whether they are available without the header being
928-
included. The `__ARM_ACLE` macro should be tested before including the
929-
header:
925+
included.
930926

931927
``` c
932-
#ifdef __ARM_ACLE
933928
#include <arm_acle.h>
934-
#endif /* __ARM_ACLE */
935929
```
936930

937931
### `<arm_fp16.h>`
938932

939933
`<arm_fp16.h>` is provided to define the scalar 16-bit floating point
940934
arithmetic intrinsics. As these intrinsics are in the user namespace,
941935
an implementation would not normally define them until the header is
942-
included. The `__ARM_FEATURE_FP16_SCALAR_ARITHMETIC` feature macro
943-
should be tested before including the header:
936+
included.
944937

945938
``` c
946-
#ifdef __ARM_FEATURE_FP16_SCALAR_ARITHMETIC
947939
#include <arm_fp16.h>
948-
#endif /* __ARM_FEATURE_FP16_SCALAR_ARITHMETIC */
949940
```
950941

951942
### `<arm_bf16.h>`
952943

953944
`<arm_bf16.h>` is provided to define the 16-bit brain floating point
954945
arithmetic intrinsics. As these intrinsics are in the user namespace,
955946
an implementation would not normally define them until the header is
956-
included. The `__ARM_FEATURE_BF16` feature macro
957-
should be tested before including the header:
947+
included.
958948

959949
``` c
960-
#ifdef __ARM_FEATURE_BF16
961950
#include <arm_bf16.h>
962-
#endif /* __ARM_FEATURE_BF16 */
963951
```
964952

965953
When `__ARM_BF16_FORMAT_ALTERNATIVE` is defined to `1` the only scalar
@@ -975,13 +963,10 @@ instructions available are conversion intrinsics between `bfloat16_t` and
975963
intrinsics](#advanced-simd-neon-intrinsics) and associated
976964
[data types](#vector-data-types). As these intrinsics and data types are
977965
in the user namespace, an implementation would not normally define them
978-
until the header is included. The `__ARM_NEON` macro should be tested
979-
before including the header:
966+
until the header is included.
980967

981968
``` c
982-
#ifdef __ARM_NEON
983969
#include <arm_neon.h>
984-
#endif /* __ARM_NEON */
985970
```
986971

987972
Including `<arm_neon.h>` will also cause the following header files
@@ -999,13 +984,9 @@ following it. --><span id="arm_sve.h"></span>
999984
`<arm_sve.h>` defines data types and intrinsics for SVE and its
1000985
extensions; see [SVE language extensions and
1001986
intrinsics](#sve-language-extensions-and-intrinsics) for details.
1002-
You should test the `__ARM_FEATURE_SVE` macro before including the
1003-
header:
1004987

1005988
``` c
1006-
#ifdef __ARM_FEATURE_SVE
1007989
#include <arm_sve.h>
1008-
#endif /* __ARM_FEATURE_SVE */
1009990
```
1010991

1011992
Including `<arm_sve.h>` also includes the following header files:
@@ -1019,13 +1000,10 @@ Including `<arm_sve.h>` also includes the following header files:
10191000

10201001
`<arm_neon_sve_bridge.h>` defines intrinsics for moving data between
10211002
Neon and SVE vector types; see [NEON-SVE Bridge](#neon-sve-bridge)
1022-
for details. The `__ARM_NEON_SVE_BRIDGE` macro should be tested
1023-
before including the header:
1003+
for details.
10241004

10251005
``` c
1026-
#ifdef __ARM_NEON_SVE_BRIDGE
10271006
#include <arm_neon_sve_bridge.h>
1028-
#endif /* __ARM_NEON_SVE_BRIDGE */
10291007
```
10301008

10311009
Including `<arm_neon_sve_bridge.h>` will also include
@@ -1040,17 +1018,8 @@ intrinsics occupy both the user namespace and the `__arm_` namespace;
10401018
defining `__ARM_MVE_PRESERVE_USER_NAMESPACE` will hide the definition of
10411019
the user namespace variants.
10421020

1043-
The `__ARM_FEATURE_MVE` macro should be tested before including the
1044-
header:
1045-
10461021
``` c
1047-
#if (__ARM_FEATURE_MVE & 3) == 3
1048-
#include <arm_mve.h>
1049-
/* MVE integer and floating point intrinsics are now available to use. */
1050-
#elif __ARM_FEATURE_MVE & 1
10511022
#include <arm_mve.h>
1052-
/* MVE integer intrinsics are now available to use. */
1053-
#endif
10541023
```
10551024

10561025
### `<arm_sme.h>`
@@ -1061,13 +1030,10 @@ change or be extended in the future.
10611030

10621031
`<arm_sme.h>` declares functions and defines intrinsics for SME
10631032
and its extensions; see [SME language extensions and intrinsics](#sme-language-extensions-and-intrinsics)
1064-
for details. The `__ARM_FEATURE_SME` macro should be tested before
1065-
including the header:
1033+
for details.
10661034

10671035
``` c
1068-
#ifdef __ARM_FEATURE_SME
10691036
#include <arm_sme.h>
1070-
#endif
10711037
```
10721038

10731039
Including `<arm_sme.h>` also includes [`<arm_sve.h>`](#arm_sve.h).

0 commit comments

Comments
 (0)