Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / external / clang / refs/heads/fp2-m-sibon / . / docs / ReleaseNotes.rst
blob: 90655d4d6f75ff400cb66416e2d6012ddec5a7b2 [file] [log] [blame]
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]1=====================================
Stephen Hines0e2c34f2015-03-23 12:09:02 -0700[diff] [blame]2Clang 3.7 (In-Progress) Release Notes
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]3=====================================
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]4
5.. contents::
6 :local:
7 :depth: 2
8
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]9Written by the `LLVM Team <http://llvm.org/>`_
10
11.. warning::
12
Stephen Hines0e2c34f2015-03-23 12:09:02 -0700[diff] [blame]13 These are in-progress notes for the upcoming Clang 3.7 release. You may
Stephen Hines176edba2014-12-01 14:53:08 -0800[diff] [blame]14 prefer the `Clang 3.5 Release Notes
Stephen Hines0e2c34f2015-03-23 12:09:02 -0700[diff] [blame]15 <http://llvm.org/releases/3.5.0/tools/clang/docs/ReleaseNotes.html>`_.
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]16
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]17Introduction
18============
19
20This document contains the release notes for the Clang C/C++/Objective-C
Stephen Hines0e2c34f2015-03-23 12:09:02 -0700[diff] [blame]21frontend, part of the LLVM Compiler Infrastructure, release 3.7. Here we
Sean Silvadebc0182012-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
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]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>`_.
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]33
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]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/>`_.
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]38
Stephen Hines0e2c34f2015-03-23 12:09:02 -0700[diff] [blame]39What's New in Clang 3.7?
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]40========================
41
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]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.
Chandler Carruthfe1088d2013-11-07 00:26:32 +0000[diff] [blame]46
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]47Major New Features
48------------------
49
Stephen Hines0e2c34f2015-03-23 12:09:02 -0700[diff] [blame]50- Feature ...
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]51
52
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]53Improvements to Clang's diagnostics
54^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
55
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]56Clang's diagnostics are constantly being improved to catch more issues,
57explain them more clearly, and provide more accurate source information
Stephen Hines176edba2014-12-01 14:53:08 -0800[diff] [blame]58about them. The improvements since the 3.5 release include:
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]59
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]60- ...
Bill Wendlingad0116e2013-12-16 19:53:36 +0000[diff] [blame]61
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]62New Compiler Flags
63------------------
64
Pirama Arumuga Nainar3ea9e332015-04-08 08:57:32 -0700[diff] [blame]65The sized deallocation feature of C++14 is now controlled by the
66``-fsized-deallocation`` flag. This feature relies on library support that
67isn't yet widely deployed, so the user must supply an extra flag to get the
68extra functionality.
69
Stephen Hines176edba2014-12-01 14:53:08 -0800[diff] [blame]70The option ....
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]71
Stephen Hinesc568f1e2014-07-21 00:47:37 -0700[diff] [blame]72
73New Pragmas in Clang
74-----------------------
75
Stephen Hines176edba2014-12-01 14:53:08 -0800[diff] [blame]76Clang now supports the ...
77
78Windows Support
79---------------
80
81Clang's support for building native Windows programs ...
82
Stephen Hinesc568f1e2014-07-21 00:47:37 -0700[diff] [blame]83
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]84C Language Changes in Clang
85---------------------------
86
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]87...
88
89C11 Feature Support
90^^^^^^^^^^^^^^^^^^^
91
92...
Michael Gottesman98d1ec12013-06-20 23:28:10 +0000[diff] [blame]93
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]94C++ Language Changes in Clang
95-----------------------------
96
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]97- ...
Eli Friedman65400522013-07-20 01:06:31 +0000[diff] [blame]98
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]99C++11 Feature Support
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]100^^^^^^^^^^^^^^^^^^^^^
101
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]102...
Richard Smith22540da2013-12-12 02:20:54 +0000[diff] [blame]103
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]104Objective-C Language Changes in Clang
105-------------------------------------
Richard Smith22540da2013-12-12 02:20:54 +0000[diff] [blame]106
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]107...
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]108
Erik Schnettera87219b2013-11-11 06:36:33 +0000[diff] [blame]109OpenCL C Language Changes in Clang
110----------------------------------
111
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]112...
Erik Schnettera87219b2013-11-11 06:36:33 +0000[diff] [blame]113
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]114Internal API Changes
115--------------------
116
Stephen Hines0e2c34f2015-03-23 12:09:02 -0700[diff] [blame]117These are major API changes that have happened since the 3.6 release of
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]118Clang. If upgrading an external codebase that uses Clang as a library,
119this section should help get you past the largest hurdles of upgrading.
120
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]121...
Hans Wennborg0437e0d2013-05-20 14:53:06 +0000[diff] [blame]122
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]123libclang
124--------
125
126...
Hans Wennborg0437e0d2013-05-20 14:53:06 +0000[diff] [blame]127
Anna Zaks08741a02013-04-25 23:14:38 +0000[diff] [blame]128Static Analyzer
Ted Kremenek1377a462013-04-26 00:01:34 +0000[diff] [blame]129---------------
Anna Zaks08741a02013-04-25 23:14:38 +0000[diff] [blame]130
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]131...
Sylvestre Ledruaa7fc192013-12-13 11:30:23 +0000[diff] [blame]132
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]133Core Analysis Improvements
134==========================
Daniel Jasper87ddfdd2013-12-11 14:41:33 +0000[diff] [blame]135
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]136- ...
Daniel Jasper87ddfdd2013-12-11 14:41:33 +0000[diff] [blame]137
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]138New Issues Found
139================
Hans Wennborga6c18502013-12-02 22:38:55 +0000[diff] [blame]140
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]141- ...
Hans Wennborga6c18502013-12-02 22:38:55 +0000[diff] [blame]142
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]143Python Binding Changes
144----------------------
145
146The following methods have been added:
147
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]148- ...
149
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]150Significant Known Problems
151==========================
152
153Additional Information
154======================
155
156A wide variety of additional information is available on the `Clang web
157page <http://clang.llvm.org/>`_. The web page contains versions of the
Stephen Hines651f13c2014-04-23 16:59:28 -0700[diff] [blame]158API documentation which are up-to-date with the Subversion version of
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]159the source code. You can access versions of these documents specific to
160this release by going into the "``clang/docs/``" directory in the Clang
161tree.
162
163If you have any questions or comments about Clang, please feel free to
164contact us via the `mailing
165list <http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev>`_.