1============================
2LLVM |release| Release Notes
3============================
4
5.. contents::
6    :local:
7
8.. only:: PreRelease
9
10  .. warning::
11     These are in-progress notes for the upcoming LLVM |version| release.
12     Release notes for previous releases can be found on
13     `the Download Page <https://releases.llvm.org/download.html>`_.
14
15
16Introduction
17============
18
19This document contains the release notes for the LLVM Compiler Infrastructure,
20release |release|.  Here we describe the status of LLVM, including major improvements
21from the previous release, improvements in various subprojects of LLVM, and
22some of the current users of the code.  All LLVM releases may be downloaded
23from the `LLVM releases web site <https://llvm.org/releases/>`_.
24
25For more information about LLVM, including information about the latest
26release, please check out the `main LLVM web site <https://llvm.org/>`_.  If you
27have questions or comments, the `LLVM Developer's Mailing List
28<https://lists.llvm.org/mailman/listinfo/llvm-dev>`_ is a good place to send
29them.
30
31Note that if you are reading this file from a Git checkout or the main
32LLVM web page, this document applies to the *next* release, not the current
33one.  To see the release notes for a specific release, please see the `releases
34page <https://llvm.org/releases/>`_.
35
36Non-comprehensive list of changes in this release
37=================================================
38.. NOTE
39   For small 1-3 sentence descriptions, just add an entry at the end of
40   this list. If your description won't fit comfortably in one bullet
41   point (e.g. maybe you would like to give an example of the
42   functionality, or simply have a lot to talk about), see the `NOTE` below
43   for adding a new subsection.
44
45* ...
46
47Update on required toolchains to build LLVM
48-------------------------------------------
49
50With LLVM 15.x we will raise the version requirements of the toolchain used
51to build LLVM. The new requirements are as follows:
52
53* GCC >= 7.1
54* Clang >= 5.0
55* Apple Clang >= 9.3
56* Visual Studio 2019 >= 16.7
57
58In LLVM 15.x these requirements will be "soft" requirements and the version
59check can be skipped by passing -DLLVM_TEMPORARILY_ALLOW_OLD_TOOLCHAIN=ON
60to CMake.
61
62With the release of LLVM 16.x these requirements will be hard and LLVM developers
63can start using C++17 features, making it impossible to build with older
64versions of these toolchains.
65
66Changes to the LLVM IR
67----------------------
68
69Changes to building LLVM
70------------------------
71
72Changes to TableGen
73-------------------
74
75Changes to the AArch64 Backend
76------------------------------
77
78Changes to the AMDGPU Backend
79-----------------------------
80
81* ...
82
83Changes to the ARM Backend
84--------------------------
85
86* Added support for the Armv9-A, Armv9.1-A and Armv9.2-A architectures.
87* Added support for the Armv8.1-M PACBTI-M extension.
88* Added support for the Armv9-A, Armv9.1-A and Armv9.2-A architectures.
89* Added support for the Armv8.1-M PACBTI-M extension.
90* Removed the deprecation of ARMv8-A T32 Complex IT blocks. No deprecation
91  warnings will be generated and -mrestrict-it is now always off by default.
92  Previously it was on by default for Armv8 and off for all other architecture
93  versions.
94
95Changes to the AVR Backend
96--------------------------
97
98* ...
99
100Changes to the Hexagon Backend
101------------------------------
102
103* ...
104
105Changes to the MIPS Backend
106---------------------------
107
108* ...
109
110Changes to the PowerPC Backend
111------------------------------
112
113* ...
114
115Changes to the RISC-V Backend
116-----------------------------
117
118* The Zvfh extension was added.
119
120Changes to the WebAssembly Backend
121----------------------------------
122
123* ...
124
125Changes to the X86 Backend
126--------------------------
127
128* ...
129
130Changes to the OCaml bindings
131-----------------------------
132
133
134Changes to the C API
135--------------------
136
137Changes to the Go bindings
138--------------------------
139
140
141Changes to the FastISel infrastructure
142--------------------------------------
143
144* ...
145
146Changes to the DAG infrastructure
147---------------------------------
148
149
150Changes to the Debug Info
151---------------------------------
152
153During this release ...
154
155Changes to the LLVM tools
156---------------------------------
157
158Changes to LLDB
159---------------------------------
160
161Changes to Sanitizers
162---------------------
163
164
165Other Changes
166-------------
167* The code for the `LLVM Visual Studio integration
168  <https://marketplace.visualstudio.com/items?itemName=LLVMExtensions.llvm-toolchain>`_
169  has been removed. This had been obsolete and abandoned since Visual Studio
170  started including an integration by default in 2019.
171
172External Open Source Projects Using LLVM 15
173===========================================
174
175* A project...
176
177Additional Information
178======================
179
180A wide variety of additional information is available on the `LLVM web page
181<https://llvm.org/>`_, in particular in the `documentation
182<https://llvm.org/docs/>`_ section.  The web page also contains versions of the
183API documentation which is up-to-date with the Git version of the source
184code.  You can access versions of these documents specific to this release by
185going into the ``llvm/docs/`` directory in the LLVM tree.
186
187If you have any questions or comments about LLVM, please feel free to contact
188us via the `mailing lists <https://llvm.org/docs/#mailing-lists>`_.
189