Gitiles
Code Review Sign In
gerrit-public.fairphone.software / toolchain / llvm-project / 7c890242cb2e5bf8b55529b1609bb1a26fb102ec / . / clang / docs / ReleaseNotes.rst
blob: b215995e7d3242f8a7d5923b741f62f684c839bc [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
9Written by the `LLVM Team <http://llvm.org/>`_
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
15 `the Download Page <http://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
25documentation <http://llvm.org/docs/ReleaseNotes.html>`_. All LLVM
26releases may be downloaded from the `LLVM releases web
27site <http://llvm.org/releases/>`_.
28
Hans Wennborgd878ca82017-08-30 18:35:44 +0000[diff] [blame]29For more information about Clang or LLVM, including information about the
30latest release, please see the `Clang Web Site <http://clang.llvm.org>`_ or the
31`LLVM Web Site <http://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
36see the `releases page <http://llvm.org/releases/>`_.
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
Rafael Espindola34970692013-12-12 16:07:11 +0000[diff] [blame]49
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]50Improvements to Clang's diagnostics
51^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
52
Roman Lebedev61061d62018-04-07 10:39:21 +0000[diff] [blame]53
Erich Keaneb0c78092017-07-26 18:04:45 +0000[diff] [blame]54Non-comprehensive list of changes in this release
55-------------------------------------------------
56
Hans Wennborg7b852ea2018-01-03 15:49:39 +0000[diff] [blame]57- ...
Alex Lorenzd8ec4312017-12-14 19:22:02 +0000[diff] [blame]58
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]59New Compiler Flags
60------------------
61
Hans Wennborg7b852ea2018-01-03 15:49:39 +0000[diff] [blame]62- ...
Aaron Ballman2b3bc4c2017-10-21 16:45:08 +0000[diff] [blame]63
Joerg Sonnenbergerc9199682017-07-01 21:36:21 +0000[diff] [blame]64Deprecated Compiler Flags
65-------------------------
66
67The following options are deprecated and ignored. They will be removed in
68future versions of Clang.
69
Hans Wennborgfbb21e02017-07-19 14:14:07 +0000[diff] [blame]70- ...
Joerg Sonnenbergerc9199682017-07-01 21:36:21 +0000[diff] [blame]71
Yuka Takahashiba900ab2018-03-07 11:34:02 +0000[diff] [blame]72Modified Compiler Flags
73-----------------------
74
Yuka Takahashiba900ab2018-03-07 11:34:02 +0000[diff] [blame]75
Tyler Nowickidb2668a2014-06-18 00:51:32 +0000[diff] [blame]76New Pragmas in Clang
Eugene Zelenkoad5684a2018-05-15 21:45:01 +0000[diff] [blame]77--------------------
Tyler Nowickidb2668a2014-06-18 00:51:32 +0000[diff] [blame]78
Rafael Espindolaaf742502014-08-22 21:59:11 +0000[diff] [blame]79Clang now supports the ...
Mark Heffernanbd26f5e2014-07-21 18:08:34 +0000[diff] [blame]80
Paul Robinsonf9ede1c2016-07-18 17:19:12 +0000[diff] [blame]81
82Attribute Changes in Clang
83--------------------------
84
Hans Wennborgfbb21e02017-07-19 14:14:07 +0000[diff] [blame]85- ...
Paul Robinsonf9ede1c2016-07-18 17:19:12 +0000[diff] [blame]86
Hans Wennborg02dc0002014-08-05 00:21:23 +0000[diff] [blame]87Windows Support
88---------------
89
Nico Weber1dbff9a2018-07-18 11:55:03 +0000[diff] [blame]90- ...
Hans Wennborg02dc0002014-08-05 00:21:23 +0000[diff] [blame]91
92
Renato Golinf2fcddb2013-12-13 09:27:34 +0000[diff] [blame]93C Language Changes in Clang
94---------------------------
95
Hans Wennborg60d06bf2016-07-18 18:05:19 +0000[diff] [blame]96- ...
Pirama Arumuga Nainarc85c8532016-06-21 16:09:30 +0000[diff] [blame]97
Renato Golinf2fcddb2013-12-13 09:27:34 +0000[diff] [blame]98...
99
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]100C11 Feature Support
101^^^^^^^^^^^^^^^^^^^
102
103...
104
105C++ Language Changes in Clang
106-----------------------------
107
Hans Wennborg7b852ea2018-01-03 15:49:39 +0000[diff] [blame]108- ...
Richard Smith8eb53c82016-05-05 18:40:37 +0000[diff] [blame]109
110C++1z Feature Support
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]111^^^^^^^^^^^^^^^^^^^^^
112
113...
114
115Objective-C Language Changes in Clang
116-------------------------------------
117
118...
119
Erik Schnetter489700d2013-11-11 06:36:33 +0000[diff] [blame]120OpenCL C Language Changes in Clang
121----------------------------------
122
Bill Wendling0a794a4b2013-11-20 10:13:37 +0000[diff] [blame]123...
Erik Schnetter489700d2013-11-11 06:36:33 +0000[diff] [blame]124
Alexey Bataev44b67502016-05-31 11:17:08 +0000[diff] [blame]125OpenMP Support in Clang
126----------------------------------
127
Alexey Bataev44b67502016-05-31 11:17:08 +0000[diff] [blame]128
Jonas Hahnfeld8da9c2a2018-04-20 13:04:54 +0000[diff] [blame]129CUDA Support in Clang
130---------------------
131
Jonas Hahnfeld8da9c2a2018-04-20 13:04:54 +0000[diff] [blame]132
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]133Internal API Changes
134--------------------
135
Hans Wennborg3d0d25d2018-08-01 14:01:27 +0000[diff] [blame]136These are major API changes that have happened since the 7.0.0 release of
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]137Clang. If upgrading an external codebase that uses Clang as a library,
138this section should help get you past the largest hurdles of upgrading.
139
Vedant Kumar5fb00e42016-07-27 23:01:55 +0000[diff] [blame]140- ...
Richard Smitha0334a92015-05-14 00:22:12 +0000[diff] [blame]141
Aaron Ballmancdc43af2015-09-17 13:47:22 +0000[diff] [blame]142AST Matchers
143------------
Aaron Ballmancdc43af2015-09-17 13:47:22 +0000[diff] [blame]144
Hans Wennborg7b852ea2018-01-03 15:49:39 +0000[diff] [blame]145- ...
Sylvestre Ledru72e3fa72017-03-14 09:43:55 +0000[diff] [blame]146
147clang-format
148------------
149
Krasimir Georgievf2ca41d2018-05-08 09:25:12 +0000[diff] [blame]150
Hans Wennborg7b852ea2018-01-03 15:49:39 +0000[diff] [blame]151- ...
Sylvestre Ledruc9410392017-12-05 09:23:47 +0000[diff] [blame]152
Ted Kremenek3a2291b2013-04-24 07:33:52 +0000[diff] [blame]153libclang
154--------
155
Bill Wendling61f44cc2013-06-04 06:17:46 +0000[diff] [blame]156...
Ted Kremenek3a2291b2013-04-24 07:33:52 +0000[diff] [blame]157
Sylvestre Ledruea49d3a2016-08-06 20:23:54 +0000[diff] [blame]158
Anna Zaksb6219a92013-04-25 23:14:38 +0000[diff] [blame]159Static Analyzer
Ted Kremenek004e8232013-04-26 00:01:34 +0000[diff] [blame]160---------------
Anna Zaksb6219a92013-04-25 23:14:38 +0000[diff] [blame]161
Hans Wennborg7b852ea2018-01-03 15:49:39 +0000[diff] [blame]162- ...
Roman Lebedev88b56ca2017-11-30 09:18:35 +0000[diff] [blame]163
Bill Wendling0a794a4b2013-11-20 10:13:37 +0000[diff] [blame]164...
Ted Kremenek004e8232013-04-26 00:01:34 +0000[diff] [blame]165
Roman Lebedevb69ba222018-07-30 18:58:30 +0000[diff] [blame]166.. _release-notes-ubsan:
167
Vedant Kumar840c2c72017-06-13 02:52:31 +0000[diff] [blame]168Undefined Behavior Sanitizer (UBSan)
169------------------------------------
170
Vedant Kumar840c2c72017-06-13 02:52:31 +0000[diff] [blame]171
Ted Kremenek004e8232013-04-26 00:01:34 +0000[diff] [blame]172Core Analysis Improvements
173==========================
174
Bill Wendling61f44cc2013-06-04 06:17:46 +0000[diff] [blame]175- ...
Ted Kremenek004e8232013-04-26 00:01:34 +0000[diff] [blame]176
177New Issues Found
178================
179
Bill Wendling61f44cc2013-06-04 06:17:46 +0000[diff] [blame]180- ...
Anna Zaksb6219a92013-04-25 23:14:38 +0000[diff] [blame]181
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]182Python Binding Changes
183----------------------
184
185The following methods have been added:
186
187- ...
188
189Significant Known Problems
190==========================
191
192Additional Information
193======================
194
195A wide variety of additional information is available on the `Clang web
196page <http://clang.llvm.org/>`_. The web page contains versions of the
197API documentation which are up-to-date with the Subversion version of
198the source code. You can access versions of these documents specific to
199this release by going into the "``clang/docs/``" directory in the Clang
200tree.
201
202If you have any questions or comments about Clang, please feel free to
203contact us via the `mailing
Tanya Lattner4a08e932015-08-05 03:55:23 +0000[diff] [blame]204list <http://lists.llvm.org/mailman/listinfo/cfe-dev>`_.