Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / external / clang / 58f2cbc083e1b564a3c393c0ad9006b2e0c45e67 / . / docs / ReleaseNotes.html
blob: 62793b2fed1cbedf19f727518d11ba35dd6485f3 [file] [log] [blame]
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]1<html>
2<head>
3<title>Clang 3.0 Release Notes</title>
4<link type="text/css" rel="stylesheet" href="../menu.css" />
5<link type="text/css" rel="stylesheet" href="../content.css" />
6<style type="text/css">
7td {
8 vertical-align: top;
9}
10</style>
11</head>
12<body>
13
14<!--#include virtual="../menu.html.incl"-->
15
16<div id="content">
17
18<h1>Clang 3.0 Release Notes</h1>
19
20<img align=right src="http://llvm.org/img/DragonSmall.png"
21 width="136" height="136" alt="LLVM Dragon Logo">
22
23<ul>
24 <li><a href="#intro">Introduction</a></li>
25 <li><a href="#whatsnew">What's New in Clang 3.0?</a>
26 <ul>
27 <li><a href="#majorfeatures">Major New Features</a></li>
28 <li><a href="#cchanges">C Language Changes</a></li>
29 <li><a href="#cxxhanges">C++ Language Changes</a></li>
30 <li><a href="#objchanges">Objective-C Language Changes</a></li>
31 <li><a href="#apichanges">Internal API Changes</a></li>
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]32 </ul>
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]33 </li>
34 <li><a href="#knownproblems">Known Problems</a></li>
35 <li><a href="#additionalinfo">Additional Information</a></li>
36</ul>
37
38<div class="doc_author">
39 <p>Written by the <a href="http://llvm.org/">LLVM Team</a></p>
40</div>
41
42<!--
43<h1 style="color:red">These are in-progress notes for the upcoming LLVM 3.0
44release.<br>
45You may prefer the
46<a href="http://llvm.org/releases/2.9/docs/ReleaseNotes.html">LLVM 2.9
47Release Notes</a>.</h1>
48 -->
49
50<!-- ======================================================================= -->
51<h2 id="intro">Introduction</h2>
52<!-- ======================================================================= -->
53
54<p>This document contains the release notes for the Clang C/C++/Objective-C
55frontend, part of the LLVM Compiler Infrastructure, release 3.0. Here we
56describe the status of Clang in some detail, including major improvements from
57the previous release and new feature work. For the general LLVM release notes,
58see <a href ="http;//llvm.org/docs/ReleaseNotes.html">the LLVM
59 documentation</a>. All LLVM releases may be downloaded from the
60<a href="http://llvm.org/releases/">LLVM releases web site</a>.</p>
61
62<p>For more information about Clang or LLVM, including information about the
63latest release, please check out the main please see the
64<a href="http://clang.llvm.org">Clang Web Site</a> or the
65<a href="http://llvm.org">LLVM Web Site</a>.
66
67<p>Note that if you are reading this file from a Subversion checkout or the main
68Clang web page, this document applies to the <i>next</i> release, not the
69current one. To see the release notes for a specific release, please see the
70<a href="http://llvm.org/releases/">releases page</a>.</p>
71
72<!-- ======================================================================= -->
73<h2 id="whatsnew">What's New in Clang 3.0?</h2>
74<!-- ======================================================================= -->
75
76<p>Some of the major new features and improvements to Clang are listed here.
77Generic improvements to Clang as a whole or two its underlying infrastructure
78are described first, followed by language-specific sections with improvements to
79Clang's support for those languages.</p>
80
81<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
82<h3 id="majorfeatures">Major New Features</h3>
83<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
84
Chandler Carrutha3950cc2011-11-28 08:41:06 +0000[diff] [blame]85<h4 id="notes">Unorganized Notes</h4>
86<p>These are completely random notes as I'm organizing my thoughts and reviewing
87the history. Anything still here needs to be distilled and turned into proper
88prose in a section of its own. When doing that, delete the notes.</p>
89<ul>
Chandler Carrutha3950cc2011-11-28 08:41:06 +0000[diff] [blame]90 <li>Building Clang on windows -- mingw, 32 and 64 bit, native windows builds,
91 cygwin. get chapuni to flesh out details.</li>
Chandler Carruth1af40222011-11-28 09:43:30 +0000[diff] [blame]92 <li>Compiling C/C++ w/ MinGW (32/64) and Cygwin on Windows -- chapuni</li>
93 <li>C++ -- Parsing and AST support for Windows Structured Exception
94 Handling.</li>
Chandler Carrutha3950cc2011-11-28 08:41:06 +0000[diff] [blame]95 <li>Uninitialized values Clang warning rewrite -- more accurate, faster, able
96 to differentiate between the possibility of an uninitialized use and the
97 certainty of an uninitialized use.</li>
Chandler Carrutha3950cc2011-11-28 08:41:06 +0000[diff] [blame]98 <li>Support for language specific address spaces</li>
Chandler Carruth1af40222011-11-28 09:43:30 +0000[diff] [blame]99 <li>Support for compiling on NetBSD systems -- Joerg Sonnenberger to fill
100 out</li>
Chandler Carrutha3950cc2011-11-28 08:41:06 +0000[diff] [blame]101 <li>Support for '--sysroot' based cross-compilation</li>
102 <li>Crash recovery handling for libclang clients -- Ted</li>
103 <li>Driver support for automatic preparation of reproduction steps for
104 compiler crashes -- Chad</li>
105 <li>OS Availability attribute -- r128127</li>
106 <li>GNU ObjectiveC Runtime support -- David Chisnall</li>
Douglas Gregor7c304c42011-11-28 17:50:36 +0000[diff] [blame]107 <li>libclang improvements bucket
Chandler Carruth7717ce42011-11-28 12:24:23 +0000[diff] [blame]108 <ul>
109 <li>Better Python Bindings</li>
110 <li>More AST coverage</li>
111 <li>Improved cursor support within macros, especially function-style macro
112 arguments.</li>
113 <li>Improved code completion surrounding macros, macro arguments, and
114 token pasting.</li>
Douglas Gregor7c304c42011-11-28 17:50:36 +0000[diff] [blame]115 <li>Improved code completion for in-class member functions.</li>
Chandler Carruth7717ce42011-11-28 12:24:23 +0000[diff] [blame]116 </ul>
117 </li>
Anna Zaksa5a6d1d2011-11-28 21:31:55 +0000[diff] [blame]118 <li>Basic C++ support in the static analyzer.</li>
Chandler Carruth1af40222011-11-28 09:43:30 +0000[diff] [blame]119 <li>Improved AST support for partially constructed nodes and incomplete
120 information for LLDB and other clients which dynamically build AST nodes.</li>
121 <li>Largely complete MSVC-compatible parsing mode -- fpichet</li>
122 <li>C1X -- static asserts and generic selections</li>
Chandler Carruth1af40222011-11-28 09:43:30 +0000[diff] [blame]123 <li>Memory reduction -- initializers, macro expansions, source locations,
124 etc.</li>
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]125 <li>The Embarcadero
126 <a href="http://docwiki.embarcadero.com/RADStudio/en/Is_lvalue_expr"><tt>__is_lvalue_expr</tt></a> and
127 <a href="http://docwiki.embarcadero.com/RADStudio/en/Is_rvalue_expr"><tt>__is_rvalue_expr</tt></a> expression traits.</li>
Chandler Carruthbba72a82011-11-28 10:57:14 +0000[diff] [blame]128 <li>CFI-based debug info -- nlewycky/espindola details</li>
Chandler Carruthb6a1d9d2011-11-28 11:27:33 +0000[diff] [blame]129 <li>ObjC ARC -- get a blurb from rjmccall</li>
Douglas Gregora1e3e8c2011-11-28 17:51:39 +0000[diff] [blame]130 <li>ObjC related result type/instancetype</li>
Chandler Carruth7717ce42011-11-28 12:24:23 +0000[diff] [blame]131 <li>Thread Safety attributes and correctness analysis added to Clang.</li>
Chandler Carruth7a1f1482011-11-28 13:02:29 +0000[diff] [blame]132 <li>NRVO for blocks.</li>
133 <li>Major improvements to the interactions between serializing and
134 deserializing the AST and the preprocessor -- argiris</li>
Chandler Carrutha3950cc2011-11-28 08:41:06 +0000[diff] [blame]135</ul>
136
Chandler Carruth58f2cbc2011-11-28 22:34:59 +0000[diff] [blame^]137<h4 id="diagnostics">A multitude of improvements to Clang's diagnostics</h4>
138Clang's diagnostics are constantly being improved to catch more issues, explain
139them more clearly, and provide more accurate source information about them.
140A few improvements since the 2.9 release that have a particularly high impact:
141<ul>
142 <li>Substantially shorter messages due to better recovery, fewer include
143 stacks, and tuning verbose features such as 'a.k.a.' type printing.</li>
144 <li>
145 Able to recover and correct from misspelled type names at the begging of statements. For example, Clang now emits:
146 <code>t.c:6:3: error: use of undeclared identifier 'integer'; did you mean
147'Integer'?
148 integer *i = 0;
149 ^~~~~~~
150 Integer
151t.c:1:13: note: 'Integer' declared here
152typedef int Integer;
153 ^</code>
154 </li>
155 <li>Expanded typo correction to (among other improvements) look across
156 namespaces and suggest namespace qualifiers in addition to misspellings of the
157 identifier itself.</li>
158 <li>More rich macro expansion backtraces and some (limited) fix-it hints when
159 diagnostics stem from macro arguments.</li>
160</ul>
161
Chandler Carruthb882a1d2011-11-28 21:56:30 +0000[diff] [blame]162<h4 id="driver">The Clang GCC-compatible command-line driver improved dramatically</h4>
163A great deal of work went into the GCC-compatible driver for the 3.0 release
164making it support more operating systems, emulate GCC behavior more accurately,
165and support a much broader range of Linux distributions out of the box.
166<ul>
167 <li>More accurate support for hardware architecture pre-defined macros (e.g.,
168 __i686__).</li>
169 <li>Robust library and header search paths for the vast majority of x86 and
170 x86-64 Linux distributions.</li>
171 <li>Improved support for newer Darwin platforms.</li>
172 <li>Partial support for <code>--sysroot=...</code> based cross-compiling on
173 Linux (and similar) host systems.</li>
174 <li>Improved support for locating and using libcxx when installed, especially
175 on Darwin.</li>
176 <!-- There are likely more Darwin-specific improvements to mention here? -->
177 <!-- What support was added for FreeBSD? NetBSD? Anything noteworthy? -->
178</ul>
179
Chandler Carruthc6f2af32011-11-28 19:17:25 +0000[diff] [blame]180<h4 id="ppcallbacks">Expanded support for instrumenting the preprocessor through
181 callbacks</h4>
Chandler Carruthf16d7252011-11-28 21:47:51 +0000[diff] [blame]182Several enhancements were made to the <code>PPCallbacks</code> interface to
183expand the information available to tools and library users of Clang that wish
184to introspect the preprocessing.
Chandler Carruthc6f2af32011-11-28 19:17:25 +0000[diff] [blame]185<ul>
186 <li>The exact text used between the <code>""</code>s or <code>&lt;&gt;</code>s is reported.</li>
187 <li>The header search path used to locate the header is reported.</li>
188 <li>Missing files during including headers reported.</li>
189 <li>The exact source range for expanded macros can be retrieved.</li>
190</ul>
191
Chandler Carrutha0df07d2011-11-28 22:17:58 +0000[diff] [blame]192<!--
193Need Peter and/or Tanya to flesh this out if we want it in 3.0's notes.. The
194state isn't clear just from documentation or commit logs.
195
196<h4 id="opencl">Initial work to support compiling OpenCL with Clang</h4>
197Clang has some (limited) support for compiling OpenCL.
198-->
199
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]200<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
201<h3 id="cchanges">C Language Changes in Clang</h3>
202<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
203
204<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
205<h3 id="cxxchanges">C++ Language Changes in Clang</h3>
206<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
207
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]208<h4 id="cxx11changes">C++11 Feature Support</h4>
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]209<p>Clang 3.0 adds support for
210<a href="http://clang.llvm.org/cxx_status.html#cxx11">more of the language
211features</a> added in the latest ISO C++ standard, C++11. Use
Chandler Carruthf16d7252011-11-28 21:47:51 +0000[diff] [blame]212<code>-std=c++11</code> or <code>-std=gnu++11</code> to enable support for these
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]213features. The following are now considered to be of production quality:
214<ul>
Chandler Carruthf16d7252011-11-28 21:47:51 +0000[diff] [blame]215 <li>Range-based <code>for</code> loops</li>
216 <li>Alias declarations (a new syntax for <code>typedef</code> declarations),
217 including their <code>template</code> forms</li>
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]218 <li>Specifying default values for class data members within a class
219 definition</li>
220 <li>Constructors delegating to other constructors of the same class</li>
Chandler Carruthf16d7252011-11-28 21:47:51 +0000[diff] [blame]221 <li>The <code>override</code> context-sensitive keyword for virtual member
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]222 function declarations</li>
Chandler Carruthf16d7252011-11-28 21:47:51 +0000[diff] [blame]223 <li>Explicitly generating default function definitions with
224 <code>= default</code></li>
225 <li>The <code>nullptr</code> keyword, and the corresponding type</li>
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]226 <li>Raw string literals with arbitary delimiters (for instance,
Chandler Carruthf16d7252011-11-28 21:47:51 +0000[diff] [blame]227 <code>R"delim(str"ing)delim"</code>)</li>
228 <li>Unicode string literals (for instance, <code>U"\u1234"</code>) and the
229 <code>char16_t</code> and <code>char32_t</code> built-in types
230 <li><code>noexcept</code> expressions and the <code>noexcept</code> specifier
231 on function declarations</li>
232 <li><code>alignof</code> expressions and the <code>alignas</code> specifier on
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]233 variable declarations</li>
234 <li>A full set of <a href="http://clang.llvm.org/docs/LanguageExtensions.html#checking_type_traits">type traits</a>,
235 sufficient to support C++11 standard libraries</li>
236</ul>
Chandler Carruthbc02a042011-11-28 21:55:34 +0000[diff] [blame]237All warning and language selection flags which previously accepted
238<code>c++0x</code> now accept <code>c++11</code>. The old <code>c++0x</code>
239form remains as an alias.
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]240
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]241<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
242<h3 id="objcchanges">Objective-C Language Changes in Clang</h3>
243<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
244
245<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
246<h3 id="apichanges">Internal API Changes</h3>
247<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
248
Chandler Carruthc4dbffa2011-11-28 18:55:47 +0000[diff] [blame]249These are major API changes that have happened since the 2.9 release of Clang.
250If upgrading an external codebase that uses Clang as a library, this section
251should help get you past the largest hurdles of upgrading.
252
Chandler Carruth7d727b72011-11-28 19:06:34 +0000[diff] [blame]253<h4 id="macroexpansion">Switched terminology from "instantiation" to "expansion"
254 for macros</h4>
255A great deal of comments and code changes fell out of this, but also every API
256relating to macros with the word "instantiation" (or some variant thereof) was
257renamed. An incomplete list of the most note-worthy ones is here:
258<ul>
259 <li><code>MacroInstantiation</code> became <code>MacroExpansion</code></li>
260 <li><code>SourceManager::getInstantiationLoc</code> became
261 <code>SourceManager::getExpansionLoc</code></li>
262 <li><code>SourceManager::getInstantiationRange</code> became
263 <code>SourceManager::getExpansionRange</code></li>
264 <li><code>SourceManager::getImmediateInstantiationRange</code> became
265 <code>SourceManager::getImmediateExpansionRange</code></li>
266 <li><code>SourceManager::getDecomposedInstantiationLoc</code> became
267 <code>SourceManager::getDecomposedExpansionLoc</code></li>
268 <li><code>SourceManager::getInstantiationColumnNumber</code> became
269 <code>SourceManager::getExpansionColumnNumber</code></li>
270 <li><code>SourceManager::getInstantiationLineNumber</code> became
271 <code>SourceManager::getExpansionLineNumber</code></li>
272 <!-- TODO: Make this more complete! -->
273</ul>
274
Chandler Carruthc4dbffa2011-11-28 18:55:47 +0000[diff] [blame]275<h4 id="diagnosticrename">Diagnostic class names were shuffled</h4>
276<ul>
277 <li><code>Diagnostic</code> became <code>DiagnosticEngine</code></li>
278 <li><code>DiagnosticClient</code> became <code>DiagnosticConsumer</code></li>
279 <li><code>DiagnosticInfo</code> became <code>Diagnostic</code></li>
280</ul>
281Subclasses of <code>DiagnosticConsumer</code> were also then renamed to end with
282<code>Consumer</code>.
283
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]284<!-- ======================================================================= -->
285<h2 id="knownproblems">Significant Known Problems</h2>
286<!-- ======================================================================= -->
287
288<!-- ======================================================================= -->
289<h2 id="additionalinfo">Additional Information</h2>
290<!-- ======================================================================= -->
291
292<p>A wide variety of additional information is available on the
293<a href="http://clang.llvm.org/">Clang web page</a>. The web page contains
294versions of the API documentation which are up-to-date with the Subversion
295version of the source code. You can access versions of these documents specific
296to this release by going into the "<tt>clang/doc/</tt>" directory in the Clang
297tree.</p>
298
299<p>If you have any questions or comments about Clang, please feel free to
300contact us via the <a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev">
301mailing list</a>.</p>
302
Chandler Carruth59abf062011-11-28 22:12:44 +0000[diff] [blame]303
304<!-- ======================================================================= -->
305<!-- Likely 3.1 release notes -->
306<!-- ======================================================================= -->
307<!--
308This is just a section to hold things that have already gotten started and
309should likely pick up proper release notes in 3.1.
310
311- C1X and C++11 atomics infrastructure and support
312- CUDA support?
313
314-->
315
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]316</body>
317</html>