blob: 77eb2e3db6f624f99c011b9c86779e85ad63877e [file] [log] [blame]
Sean Silvab0455142013-01-02 22:05:33 +00001=====================================
Hans Wennborge904ea22015-07-14 22:52:36 +00002Clang 3.8 (In-Progress) Release Notes
Sean Silvab0455142013-01-02 22:05:33 +00003=====================================
Sean Silvafe251442012-12-23 01:19:35 +00004
5.. contents::
6 :local:
7 :depth: 2
8
9Written by the `LLVM Team <http://llvm.org/>`_
10
11.. warning::
12
Hans Wennborge904ea22015-07-14 22:52:36 +000013 These are in-progress notes for the upcoming Clang 3.8 release. You may
Aaron Ballmand6ea9142015-05-26 16:12:07 +000014 prefer the `Clang 3.6 Release Notes
15 <http://llvm.org/releases/3.6.0/tools/clang/docs/ReleaseNotes.html>`_.
Sean Silvafe251442012-12-23 01:19:35 +000016
17Introduction
18============
19
20This document contains the release notes for the Clang C/C++/Objective-C
Hans Wennborge904ea22015-07-14 22:52:36 +000021frontend, part of the LLVM Compiler Infrastructure, release 3.8. Here we
Sean Silvafe251442012-12-23 01:19:35 +000022describe 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 Wennborge904ea22015-07-14 22:52:36 +000039What's New in Clang 3.8?
Sean Silvafe251442012-12-23 01:19:35 +000040========================
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 Wennborge904ea22015-07-14 22:52:36 +000050- Feature1...
Rafael Espindola34970692013-12-12 16:07:11 +000051
Sean Silvafe251442012-12-23 01:19:35 +000052Improvements to Clang's diagnostics
53^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
54
55Clang's diagnostics are constantly being improved to catch more issues,
56explain them more clearly, and provide more accurate source information
Rafael Espindolaaf742502014-08-22 21:59:11 +000057about them. The improvements since the 3.5 release include:
Sylvestre Ledru5e43f742014-07-14 18:30:23 +000058
Sean Silvafe251442012-12-23 01:19:35 +000059- ...
60
Sean Silvafe251442012-12-23 01:19:35 +000061New Compiler Flags
62------------------
63
Rafael Espindolaaf742502014-08-22 21:59:11 +000064The option ....
Renato Golin1588cda2013-12-11 09:35:10 +000065
Sylvestre Ledru0e767b12014-07-14 18:34:37 +000066
Tyler Nowickidb2668a2014-06-18 00:51:32 +000067New Pragmas in Clang
68-----------------------
69
Rafael Espindolaaf742502014-08-22 21:59:11 +000070Clang now supports the ...
Mark Heffernanbd26f5e2014-07-21 18:08:34 +000071
Hans Wennborg02dc0002014-08-05 00:21:23 +000072Windows Support
73---------------
74
Rafael Espindolaaf742502014-08-22 21:59:11 +000075Clang's support for building native Windows programs ...
Hans Wennborg02dc0002014-08-05 00:21:23 +000076
77
Renato Golinf2fcddb2013-12-13 09:27:34 +000078C Language Changes in Clang
79---------------------------
80
81...
82
Sean Silvafe251442012-12-23 01:19:35 +000083C11 Feature Support
84^^^^^^^^^^^^^^^^^^^
85
86...
87
88C++ Language Changes in Clang
89-----------------------------
90
Bill Wendling61f44cc2013-06-04 06:17:46 +000091- ...
Rafael Espindola9ca6e812013-04-09 12:51:24 +000092
Sean Silvafe251442012-12-23 01:19:35 +000093C++11 Feature Support
94^^^^^^^^^^^^^^^^^^^^^
95
96...
97
98Objective-C Language Changes in Clang
99-------------------------------------
100
101...
102
Erik Schnetter489700d2013-11-11 06:36:33 +0000103OpenCL C Language Changes in Clang
104----------------------------------
105
Bill Wendling0a794a4b2013-11-20 10:13:37 +0000106...
Erik Schnetter489700d2013-11-11 06:36:33 +0000107
Sean Silvafe251442012-12-23 01:19:35 +0000108Internal API Changes
109--------------------
110
Hans Wennborge904ea22015-07-14 22:52:36 +0000111These are major API changes that have happened since the 3.7 release of
Sean Silvafe251442012-12-23 01:19:35 +0000112Clang. If upgrading an external codebase that uses Clang as a library,
113this section should help get you past the largest hurdles of upgrading.
114
Hans Wennborge904ea22015-07-14 22:52:36 +0000115- ...
Richard Smitha0334a92015-05-14 00:22:12 +0000116
Ted Kremenek3a2291b2013-04-24 07:33:52 +0000117libclang
118--------
119
Bill Wendling61f44cc2013-06-04 06:17:46 +0000120...
Ted Kremenek3a2291b2013-04-24 07:33:52 +0000121
Anna Zaksb6219a92013-04-25 23:14:38 +0000122Static Analyzer
Ted Kremenek004e8232013-04-26 00:01:34 +0000123---------------
Anna Zaksb6219a92013-04-25 23:14:38 +0000124
Bill Wendling0a794a4b2013-11-20 10:13:37 +0000125...
Ted Kremenek004e8232013-04-26 00:01:34 +0000126
127Core Analysis Improvements
128==========================
129
Bill Wendling61f44cc2013-06-04 06:17:46 +0000130- ...
Ted Kremenek004e8232013-04-26 00:01:34 +0000131
132New Issues Found
133================
134
Bill Wendling61f44cc2013-06-04 06:17:46 +0000135- ...
Anna Zaksb6219a92013-04-25 23:14:38 +0000136
Sean Silvafe251442012-12-23 01:19:35 +0000137Python Binding Changes
138----------------------
139
140The following methods have been added:
141
142- ...
143
144Significant Known Problems
145==========================
146
147Additional Information
148======================
149
150A wide variety of additional information is available on the `Clang web
151page <http://clang.llvm.org/>`_. The web page contains versions of the
152API documentation which are up-to-date with the Subversion version of
153the source code. You can access versions of these documents specific to
154this release by going into the "``clang/docs/``" directory in the Clang
155tree.
156
157If you have any questions or comments about Clang, please feel free to
158contact us via the `mailing
159list <http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev>`_.