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.. NOTE
47   If you would like to document a larger change, then you can add a
48   subsection about it right here. You can copy the following boilerplate
49   and un-indent it (the indentation causes it to be inside this comment).
50
51   Special New Feature
52   -------------------
53
54   Makes programs 10x faster by doing Special New Thing.
55
56* ...
57
58Changes to the LLVM IR
59----------------------
60
61Changes to building LLVM
62------------------------
63
64Changes to TableGen
65-------------------
66
67Changes to the AArch64 Backend
68------------------------------
69
70Changes to the AMDGPU Backend
71-----------------------------
72
73* ...
74
75Changes to the ARM Backend
76--------------------------
77
78* Added support for the Armv9-A, Armv9.1-A and Armv9.2-A architectures.
79* Added support for the Armv8.1-M PACBTI-M extension.
80* Added support for the Armv9-A, Armv9.1-A and Armv9.2-A architectures.
81* Added support for the Armv8.1-M PACBTI-M extension.
82* Removed the deprecation of ARMv8-A T32 Complex IT blocks. No deprecation
83  warnings will be generated and -mrestrict-it is now always off by default.
84  Previously it was on by default for Armv8 and off for all other architecture
85  versions.
86
87Changes to the AVR Backend
88--------------------------
89
90* ...
91
92Changes to the Hexagon Backend
93------------------------------
94
95* ...
96
97Changes to the MIPS Backend
98---------------------------
99
100* ...
101
102Changes to the PowerPC Backend
103------------------------------
104
105* ...
106
107Changes to the RISC-V Backend
108-----------------------------
109
110* ...
111
112Changes to the WebAssembly Backend
113----------------------------------
114
115* ...
116
117Changes to the X86 Backend
118--------------------------
119
120* ...
121
122Changes to the OCaml bindings
123-----------------------------
124
125
126Changes to the C API
127--------------------
128
129Changes to the Go bindings
130--------------------------
131
132
133Changes to the FastISel infrastructure
134--------------------------------------
135
136* ...
137
138Changes to the DAG infrastructure
139---------------------------------
140
141
142Changes to the Debug Info
143---------------------------------
144
145During this release ...
146
147Changes to the LLVM tools
148---------------------------------
149
150Changes to LLDB
151---------------------------------
152
153Changes to Sanitizers
154---------------------
155
156External Open Source Projects Using LLVM 15
157===========================================
158
159* A project...
160
161Additional Information
162======================
163
164A wide variety of additional information is available on the `LLVM web page
165<https://llvm.org/>`_, in particular in the `documentation
166<https://llvm.org/docs/>`_ section.  The web page also contains versions of the
167API documentation which is up-to-date with the Git version of the source
168code.  You can access versions of these documents specific to this release by
169going into the ``llvm/docs/`` directory in the LLVM tree.
170
171If you have any questions or comments about LLVM, please feel free to contact
172us via the `mailing lists <https://llvm.org/docs/#mailing-lists>`_.
173