Gitiles
Code Review Sign In
gerrit-public.fairphone.software / toolchain / llvm-project / 9e22b4c76d7214002e446d28b5fa31102b529e99 / . / clang / docs / ReleaseNotes.rst
blob: 7e798492bb0f6ff4eaa3001367efc53dc481a9c1 [file] [log] [blame]
Hans Wennborg60d06bf2016-07-18 18:05:19 +0000[diff] [blame]1=======================================
Hans Wennborg3d0d25d2018-08-01 14:01:27 +0000[diff] [blame]2Clang 8.0.0 (In-Progress) Release Notes
Hans Wennborg60d06bf2016-07-18 18:05:19 +0000[diff] [blame]3=======================================
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]4
5.. contents::
6 :local:
7 :depth: 2
8
Hans Wennborg0aa0d912018-09-10 08:51:25 +0000[diff] [blame]9Written by the `LLVM Team <https://llvm.org/>`_
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]10
11.. warning::
12
Hans Wennborg3d0d25d2018-08-01 14:01:27 +0000[diff] [blame]13 These are in-progress notes for the upcoming Clang 8 release.
Hans Wennborg189f1f32017-02-09 23:26:34 +0000[diff] [blame]14 Release notes for previous releases can be found on
Hans Wennborg0aa0d912018-09-10 08:51:25 +0000[diff] [blame]15 `the Download Page <https://releases.llvm.org/download.html>`_.
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]16
17Introduction
18============
19
20This document contains the release notes for the Clang C/C++/Objective-C
Hans Wennborg3d0d25d2018-08-01 14:01:27 +0000[diff] [blame]21frontend, part of the LLVM Compiler Infrastructure, release 8.0.0. Here we
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]22describe the status of Clang in some detail, including major
23improvements from the previous release and new feature work. For the
24general LLVM release notes, see `the LLVM
Hans Wennborg0aa0d912018-09-10 08:51:25 +0000[diff] [blame]25documentation <https://llvm.org/docs/ReleaseNotes.html>`_. All LLVM
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]26releases may be downloaded from the `LLVM releases web
Hans Wennborg0aa0d912018-09-10 08:51:25 +0000[diff] [blame]27site <https://llvm.org/releases/>`_.
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]28
Hans Wennborgd878ca82017-08-30 18:35:44 +0000[diff] [blame]29For more information about Clang or LLVM, including information about the
Hans Wennborg0aa0d912018-09-10 08:51:25 +0000[diff] [blame]30latest release, please see the `Clang Web Site <https://clang.llvm.org>`_ or the
31`LLVM Web Site <https://llvm.org>`_.
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]32
33Note that if you are reading this file from a Subversion checkout or the
34main Clang web page, this document applies to the *next* release, not
35the current one. To see the release notes for a specific release, please
Hans Wennborg0aa0d912018-09-10 08:51:25 +0000[diff] [blame]36see the `releases page <https://llvm.org/releases/>`_.
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]37
Hans Wennborg3d0d25d2018-08-01 14:01:27 +0000[diff] [blame]38What's New in Clang 8.0.0?
Hans Wennborg60d06bf2016-07-18 18:05:19 +0000[diff] [blame]39==========================
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]40
41Some of the major new features and improvements to Clang are listed
42here. Generic improvements to Clang as a whole or to its underlying
43infrastructure are described first, followed by language-specific
44sections with improvements to Clang's support for those languages.
45
46Major New Features
47------------------
48
Richard Smith8654ae52018-10-10 23:13:35 +0000[diff] [blame]49- Clang supports use of a profile remapping file, which permits
50 profile data captured for one version of a program to be applied
51 when building another version where symbols have changed (for
52 example, due to renaming a class or namespace).
53 See the :doc:`UsersManual` for details.
Rafael Espindola34970692013-12-12 16:07:11 +0000[diff] [blame]54
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]55Improvements to Clang's diagnostics
56^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
57
Roman Lebedev61061d62018-04-07 10:39:21 +0000[diff] [blame]58
Erich Keaneb0c78092017-07-26 18:04:45 +0000[diff] [blame]59Non-comprehensive list of changes in this release
60-------------------------------------------------
61
Hans Wennborg7b852ea2018-01-03 15:49:39 +0000[diff] [blame]62- ...
Alex Lorenzd8ec4312017-12-14 19:22:02 +0000[diff] [blame]63
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]64New Compiler Flags
65------------------
66
Hans Wennborg7b852ea2018-01-03 15:49:39 +0000[diff] [blame]67- ...
Aaron Ballman2b3bc4c2017-10-21 16:45:08 +0000[diff] [blame]68
Joerg Sonnenbergerc9199682017-07-01 21:36:21 +0000[diff] [blame]69Deprecated Compiler Flags
70-------------------------
71
72The following options are deprecated and ignored. They will be removed in
73future versions of Clang.
74
Hans Wennborgfbb21e02017-07-19 14:14:07 +0000[diff] [blame]75- ...
Joerg Sonnenbergerc9199682017-07-01 21:36:21 +0000[diff] [blame]76
Yuka Takahashiba900ab2018-03-07 11:34:02 +0000[diff] [blame]77Modified Compiler Flags
78-----------------------
79
Yuka Takahashiba900ab2018-03-07 11:34:02 +0000[diff] [blame]80
Tyler Nowickidb2668a2014-06-18 00:51:32 +0000[diff] [blame]81New Pragmas in Clang
Eugene Zelenkoad5684a2018-05-15 21:45:01 +0000[diff] [blame]82--------------------
Tyler Nowickidb2668a2014-06-18 00:51:32 +0000[diff] [blame]83
Rafael Espindolaaf742502014-08-22 21:59:11 +0000[diff] [blame]84Clang now supports the ...
Mark Heffernanbd26f5e2014-07-21 18:08:34 +0000[diff] [blame]85
Paul Robinsonf9ede1c2016-07-18 17:19:12 +0000[diff] [blame]86
87Attribute Changes in Clang
88--------------------------
89
Hans Wennborgfbb21e02017-07-19 14:14:07 +0000[diff] [blame]90- ...
Paul Robinsonf9ede1c2016-07-18 17:19:12 +0000[diff] [blame]91
Hans Wennborg02dc0002014-08-05 00:21:23 +0000[diff] [blame]92Windows Support
93---------------
94
Mike Rice58df1af2018-09-11 17:10:44 +0000[diff] [blame]95- clang-cl now supports the use of the precompiled header options /Yc and /Yu
96 without the filename argument. When these options are used without the
97 filename, a `#pragma hdrstop` inside the source marks the end of the
98 precompiled code.
99
Nico Weber1dbff9a2018-07-18 11:55:03 +0000[diff] [blame]100- ...
Hans Wennborg02dc0002014-08-05 00:21:23 +0000[diff] [blame]101
102
Renato Golinf2fcddb2013-12-13 09:27:34 +0000[diff] [blame]103C Language Changes in Clang
104---------------------------
105
Hans Wennborg60d06bf2016-07-18 18:05:19 +0000[diff] [blame]106- ...
Pirama Arumuga Nainarc85c8532016-06-21 16:09:30 +0000[diff] [blame]107
Renato Golinf2fcddb2013-12-13 09:27:34 +0000[diff] [blame]108...
109
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]110C11 Feature Support
111^^^^^^^^^^^^^^^^^^^
112
113...
114
115C++ Language Changes in Clang
116-----------------------------
117
Hans Wennborg7b852ea2018-01-03 15:49:39 +0000[diff] [blame]118- ...
Richard Smith8eb53c82016-05-05 18:40:37 +0000[diff] [blame]119
120C++1z Feature Support
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]121^^^^^^^^^^^^^^^^^^^^^
122
123...
124
125Objective-C Language Changes in Clang
126-------------------------------------
127
128...
129
Erik Schnetter489700d2013-11-11 06:36:33 +0000[diff] [blame]130OpenCL C Language Changes in Clang
131----------------------------------
132
Bill Wendling0a794a4b2013-11-20 10:13:37 +0000[diff] [blame]133...
Erik Schnetter489700d2013-11-11 06:36:33 +0000[diff] [blame]134
Alexey Bataev44b67502016-05-31 11:17:08 +0000[diff] [blame]135OpenMP Support in Clang
136----------------------------------
137
Alexey Bataev44b67502016-05-31 11:17:08 +0000[diff] [blame]138
Jonas Hahnfeld8da9c2a2018-04-20 13:04:54 +0000[diff] [blame]139CUDA Support in Clang
140---------------------
141
Jonas Hahnfeld8da9c2a2018-04-20 13:04:54 +0000[diff] [blame]142
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]143Internal API Changes
144--------------------
145
Hans Wennborg3d0d25d2018-08-01 14:01:27 +0000[diff] [blame]146These are major API changes that have happened since the 7.0.0 release of
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]147Clang. If upgrading an external codebase that uses Clang as a library,
148this section should help get you past the largest hurdles of upgrading.
149
Vedant Kumar5fb00e42016-07-27 23:01:55 +0000[diff] [blame]150- ...
Richard Smitha0334a92015-05-14 00:22:12 +0000[diff] [blame]151
Aaron Ballmancdc43af2015-09-17 13:47:22 +0000[diff] [blame]152AST Matchers
153------------
Aaron Ballmancdc43af2015-09-17 13:47:22 +0000[diff] [blame]154
Hans Wennborg7b852ea2018-01-03 15:49:39 +0000[diff] [blame]155- ...
Sylvestre Ledru72e3fa72017-03-14 09:43:55 +0000[diff] [blame]156
157clang-format
158------------
159
Krasimir Georgievf2ca41d2018-05-08 09:25:12 +0000[diff] [blame]160
Hans Wennborg7b852ea2018-01-03 15:49:39 +0000[diff] [blame]161- ...
Sylvestre Ledruc9410392017-12-05 09:23:47 +0000[diff] [blame]162
Ted Kremenek3a2291b2013-04-24 07:33:52 +0000[diff] [blame]163libclang
164--------
165
Bill Wendling61f44cc2013-06-04 06:17:46 +0000[diff] [blame]166...
Ted Kremenek3a2291b2013-04-24 07:33:52 +0000[diff] [blame]167
Sylvestre Ledruea49d3a2016-08-06 20:23:54 +0000[diff] [blame]168
Anna Zaksb6219a92013-04-25 23:14:38 +0000[diff] [blame]169Static Analyzer
Ted Kremenek004e8232013-04-26 00:01:34 +0000[diff] [blame]170---------------
Anna Zaksb6219a92013-04-25 23:14:38 +0000[diff] [blame]171
Hans Wennborg7b852ea2018-01-03 15:49:39 +0000[diff] [blame]172- ...
Roman Lebedev88b56ca2017-11-30 09:18:35 +0000[diff] [blame]173
Bill Wendling0a794a4b2013-11-20 10:13:37 +0000[diff] [blame]174...
Ted Kremenek004e8232013-04-26 00:01:34 +0000[diff] [blame]175
Roman Lebedevb69ba222018-07-30 18:58:30 +0000[diff] [blame]176.. _release-notes-ubsan:
177
Vedant Kumar840c2c72017-06-13 02:52:31 +0000[diff] [blame]178Undefined Behavior Sanitizer (UBSan)
179------------------------------------
180
Vedant Kumar840c2c72017-06-13 02:52:31 +0000[diff] [blame]181
Ted Kremenek004e8232013-04-26 00:01:34 +0000[diff] [blame]182Core Analysis Improvements
183==========================
184
Bill Wendling61f44cc2013-06-04 06:17:46 +0000[diff] [blame]185- ...
Ted Kremenek004e8232013-04-26 00:01:34 +0000[diff] [blame]186
187New Issues Found
188================
189
Bill Wendling61f44cc2013-06-04 06:17:46 +0000[diff] [blame]190- ...
Anna Zaksb6219a92013-04-25 23:14:38 +0000[diff] [blame]191
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]192Python Binding Changes
193----------------------
194
195The following methods have been added:
196
197- ...
198
199Significant Known Problems
200==========================
201
202Additional Information
203======================
204
205A wide variety of additional information is available on the `Clang web
Hans Wennborg0aa0d912018-09-10 08:51:25 +0000[diff] [blame]206page <https://clang.llvm.org/>`_. The web page contains versions of the
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]207API documentation which are up-to-date with the Subversion version of
208the source code. You can access versions of these documents specific to
209this release by going into the "``clang/docs/``" directory in the Clang
210tree.
211
212If you have any questions or comments about Clang, please feel free to
213contact us via the `mailing
Hans Wennborg0aa0d912018-09-10 08:51:25 +0000[diff] [blame]214list <https://lists.llvm.org/mailman/listinfo/cfe-dev>`_.