Gitiles
Code Review Sign In
gerrit-public.fairphone.software / toolchain / llvm-project / b755aea8eb910d2f690b9a00c359e481892659f0 / . / clang / docs / ReleaseNotes.rst
blob: 11ee88f4ae202fd9378def467a7b78b7939e9005 [file] [log] [blame]
Hans Wennborg60d06bf2016-07-18 18:05:19 +0000[diff] [blame]1=======================================
2Clang 4.0.0 (In-Progress) Release Notes
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 Wennborg60d06bf2016-07-18 18:05:19 +0000[diff] [blame]13 These are in-progress notes for the upcoming Clang 4.0.0 release. You may
Sylvestre Ledru503d95d2016-11-12 10:38:18 +0000[diff] [blame]14 prefer the `Clang 3.9 Release Notes
15 <http://llvm.org/releases/3.9.0/tools/clang/docs/ReleaseNotes.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 Wennborg60d06bf2016-07-18 18:05:19 +0000[diff] [blame]21frontend, part of the LLVM Compiler Infrastructure, release 4.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
29For more information about Clang or LLVM, including information about
30the latest release, please check out the main please see the `Clang Web
31Site <http://clang.llvm.org>`_ or the `LLVM Web
32Site <http://llvm.org>`_.
33
34Note that if you are reading this file from a Subversion checkout or the
35main Clang web page, this document applies to the *next* release, not
36the current one. To see the release notes for a specific release, please
37see the `releases page <http://llvm.org/releases/>`_.
38
Hans Wennborg60d06bf2016-07-18 18:05:19 +0000[diff] [blame]39What's New in Clang 4.0.0?
40==========================
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]41
42Some of the major new features and improvements to Clang are listed
43here. Generic improvements to Clang as a whole or to its underlying
44infrastructure are described first, followed by language-specific
45sections with improvements to Clang's support for those languages.
46
47Major New Features
48------------------
49
Hans Wennborg60d06bf2016-07-18 18:05:19 +0000[diff] [blame]50- ...
Rafael Espindola34970692013-12-12 16:07:11 +0000[diff] [blame]51
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]52Improvements to Clang's diagnostics
53^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
54
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]55- ...
56
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]57New Compiler Flags
58------------------
59
Sylvestre Ledruf6b48972016-11-12 10:37:17 +0000[diff] [blame]60The option -Og has been added to optimize the debugging experience.
61For now, this option is exactly the same as -O1. However, in the future,
62some other optimizations might be enabled or disabled.
Renato Golin1588cda2013-12-11 09:35:10 +0000[diff] [blame]63
Sylvestre Ledru0e767b12014-07-14 18:34:37 +0000[diff] [blame]64
Sylvestre Ledruf6b48972016-11-12 10:37:17 +0000[diff] [blame]65The option ....
66
Tyler Nowickidb2668a2014-06-18 00:51:32 +0000[diff] [blame]67New Pragmas in Clang
68-----------------------
69
Rafael Espindolaaf742502014-08-22 21:59:11 +0000[diff] [blame]70Clang now supports the ...
Mark Heffernanbd26f5e2014-07-21 18:08:34 +0000[diff] [blame]71
Paul Robinsonf9ede1c2016-07-18 17:19:12 +0000[diff] [blame]72
73Attribute Changes in Clang
74--------------------------
75
Hans Wennborg60d06bf2016-07-18 18:05:19 +0000[diff] [blame]76- ...
Paul Robinsonf9ede1c2016-07-18 17:19:12 +0000[diff] [blame]77
Hans Wennborg02dc0002014-08-05 00:21:23 +0000[diff] [blame]78Windows Support
79---------------
80
Rafael Espindolaaf742502014-08-22 21:59:11 +0000[diff] [blame]81Clang's support for building native Windows programs ...
Hans Wennborg02dc0002014-08-05 00:21:23 +0000[diff] [blame]82
83
Renato Golinf2fcddb2013-12-13 09:27:34 +0000[diff] [blame]84C Language Changes in Clang
85---------------------------
86
Hans Wennborg60d06bf2016-07-18 18:05:19 +0000[diff] [blame]87- ...
Pirama Arumuga Nainarc85c8532016-06-21 16:09:30 +0000[diff] [blame]88
Renato Golinf2fcddb2013-12-13 09:27:34 +0000[diff] [blame]89...
90
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]91C11 Feature Support
92^^^^^^^^^^^^^^^^^^^
93
94...
95
96C++ Language Changes in Clang
97-----------------------------
98
Richard Smith8eb53c82016-05-05 18:40:37 +0000[diff] [blame]99...
100
101C++1z Feature Support
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]102^^^^^^^^^^^^^^^^^^^^^
103
104...
105
106Objective-C Language Changes in Clang
107-------------------------------------
108
109...
110
Erik Schnetter489700d2013-11-11 06:36:33 +0000[diff] [blame]111OpenCL C Language Changes in Clang
112----------------------------------
113
Bill Wendling0a794a4b2013-11-20 10:13:37 +0000[diff] [blame]114...
Erik Schnetter489700d2013-11-11 06:36:33 +0000[diff] [blame]115
Alexey Bataev44b67502016-05-31 11:17:08 +0000[diff] [blame]116OpenMP Support in Clang
117----------------------------------
118
Hans Wennborg60d06bf2016-07-18 18:05:19 +0000[diff] [blame]119...
Alexey Bataev44b67502016-05-31 11:17:08 +0000[diff] [blame]120
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]121Internal API Changes
122--------------------
123
Sylvestre Ledru503d95d2016-11-12 10:38:18 +0000[diff] [blame]124These are major API changes that have happened since the 3.9 release of
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]125Clang. If upgrading an external codebase that uses Clang as a library,
126this section should help get you past the largest hurdles of upgrading.
127
Vedant Kumar5fb00e42016-07-27 23:01:55 +0000[diff] [blame]128- ...
Richard Smitha0334a92015-05-14 00:22:12 +0000[diff] [blame]129
Aaron Ballmancdc43af2015-09-17 13:47:22 +0000[diff] [blame]130AST Matchers
131------------
Aaron Ballmancdc43af2015-09-17 13:47:22 +0000[diff] [blame]132
133...
134
Ted Kremenek3a2291b2013-04-24 07:33:52 +0000[diff] [blame]135libclang
136--------
137
Bill Wendling61f44cc2013-06-04 06:17:46 +0000[diff] [blame]138...
Ted Kremenek3a2291b2013-04-24 07:33:52 +0000[diff] [blame]139
Sylvestre Ledruea49d3a2016-08-06 20:23:54 +0000[diff] [blame]140With the option --show-description, scan-build's list of defects will also
141show the description of the defects.
142
143
Anna Zaksb6219a92013-04-25 23:14:38 +0000[diff] [blame]144Static Analyzer
Ted Kremenek004e8232013-04-26 00:01:34 +0000[diff] [blame]145---------------
Anna Zaksb6219a92013-04-25 23:14:38 +0000[diff] [blame]146
Bill Wendling0a794a4b2013-11-20 10:13:37 +0000[diff] [blame]147...
Ted Kremenek004e8232013-04-26 00:01:34 +0000[diff] [blame]148
149Core Analysis Improvements
150==========================
151
Bill Wendling61f44cc2013-06-04 06:17:46 +0000[diff] [blame]152- ...
Ted Kremenek004e8232013-04-26 00:01:34 +0000[diff] [blame]153
154New Issues Found
155================
156
Bill Wendling61f44cc2013-06-04 06:17:46 +0000[diff] [blame]157- ...
Anna Zaksb6219a92013-04-25 23:14:38 +0000[diff] [blame]158
Sean Silvafe251442012-12-23 01:19:35 +0000[diff] [blame]159Python Binding Changes
160----------------------
161
162The following methods have been added:
163
164- ...
165
166Significant Known Problems
167==========================
168
169Additional Information
170======================
171
172A wide variety of additional information is available on the `Clang web
173page <http://clang.llvm.org/>`_. The web page contains versions of the
174API documentation which are up-to-date with the Subversion version of
175the source code. You can access versions of these documents specific to
176this release by going into the "``clang/docs/``" directory in the Clang
177tree.
178
179If you have any questions or comments about Clang, please feel free to
180contact us via the `mailing
Tanya Lattner4a08e932015-08-05 03:55:23 +0000[diff] [blame]181list <http://lists.llvm.org/mailman/listinfo/cfe-dev>`_.