Skip to content

Commit 2d4d5e1

Browse files
committed
[clang][Docs] Add release note for *-none-* triple normalization changes
That were implemented by llvm#89638.
1 parent cfca977 commit 2d4d5e1

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

clang/docs/ReleaseNotes.rst

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,25 @@ Clang Frontend Potentially Breaking Changes
8585
of ``-Wno-gnu-binary-literal`` will no longer silence this pedantic warning,
8686
which may break existing uses with ``-Werror``.
8787

88+
- The normalization of 3 element target triples where ``-none-`` is the middle
89+
element has changed. For example, ``armv7m-none-eabi`` previously normalized
90+
to ``armv7m-none-unknown-eabi``, with ``none`` for the vendor and ``unknown``
91+
for the operating system. It now normalizes to ``armv7m-unknown-none-eabi``,
92+
which has ``unknown`` vendor and ``none`` operating system.
93+
94+
The affected triples are primarily for bare metal Arm where it is intended
95+
that ``none`` means that there is no operating system. As opposed to an unknown
96+
type of operating system.
97+
98+
This change my cause clang to not find libraries, or libraries to be built at
99+
different file system locations. This can be fixed by changing your builds to
100+
use the new normalized triple. However, we recommend instead getting the
101+
normalized triple from clang itself, as this will make your builds more
102+
robust in case of future changes::
103+
104+
$ clang --target=<your target triple> -print-target-triple
105+
<the normalized target triple>
106+
88107
What's New in Clang |release|?
89108
==============================
90109
Some of the major new features and improvements to Clang are listed

0 commit comments

Comments
 (0)