Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / clang / c5493d7d60005fc8aa9b0e06d326026a9f9a688d / . / docs / ReleaseNotes.html
blob: 1dfdfbefe9f480a8e71475f8a95b6a2a01b017ab [file] [log] [blame]
Benjamin Kramer665a8dc2012-01-15 15:26:07 +0000[diff] [blame]1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
2 "http://www.w3.org/TR/html4/strict.dtd">
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]3<html>
4<head>
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]5<title>Clang 3.1 Release Notes</title>
Benjamin Kramer665a8dc2012-01-15 15:26:07 +0000[diff] [blame]6<link type="text/css" rel="stylesheet" href="../menu.css">
7<link type="text/css" rel="stylesheet" href="../content.css">
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]8<style type="text/css">
9td {
10 vertical-align: top;
11}
12</style>
13</head>
14<body>
15
16<!--#include virtual="../menu.html.incl"-->
17
18<div id="content">
19
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]20<h1>Clang 3.1 Release Notes</h1>
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]21
Benjamin Kramer665a8dc2012-01-15 15:26:07 +0000[diff] [blame]22<img style="float:right" src="http://llvm.org/img/DragonSmall.png"
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]23 width="136" height="136" alt="LLVM Dragon Logo">
24
25<ul>
26 <li><a href="#intro">Introduction</a></li>
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]27 <li><a href="#whatsnew">What's New in Clang 3.1?</a>
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]28 <ul>
29 <li><a href="#majorfeatures">Major New Features</a></li>
30 <li><a href="#cchanges">C Language Changes</a></li>
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]31 <li><a href="#cxxchanges">C++ Language Changes</a></li>
Jean-Daniel Dupas3fd80872012-03-03 13:37:22 +0000[diff] [blame]32 <li><a href="#objcchanges">Objective-C Language Changes</a></li>
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]33 <li><a href="#apichanges">Internal API Changes</a></li>
Gregory Szorc63419002012-05-12 20:45:56 +0000[diff] [blame]34 <li><a href="#pythonchanges">Python Binding Changes</a></li>
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]35 </ul>
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]36 </li>
37 <li><a href="#knownproblems">Known Problems</a></li>
38 <li><a href="#additionalinfo">Additional Information</a></li>
39</ul>
40
41<div class="doc_author">
42 <p>Written by the <a href="http://llvm.org/">LLVM Team</a></p>
43</div>
44
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]45<h1 style="color:red">These are in-progress notes for the upcoming Clang 3.1
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]46release.<br>
47You may prefer the
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]48<a href="http://llvm.org/releases/3.0/docs/ClangReleaseNotes.html">Clang 3.0
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]49Release Notes</a>.</h1>
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]50
51<!-- ======================================================================= -->
52<h2 id="intro">Introduction</h2>
53<!-- ======================================================================= -->
54
55<p>This document contains the release notes for the Clang C/C++/Objective-C
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]56frontend, part of the LLVM Compiler Infrastructure, release 3.1. Here we
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]57describe the status of Clang in some detail, including major improvements from
58the previous release and new feature work. For the general LLVM release notes,
Peter Collingbourne5cc989e2011-11-29 02:03:03 +0000[diff] [blame]59see <a href="http://llvm.org/docs/ReleaseNotes.html">the LLVM
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]60 documentation</a>. All LLVM releases may be downloaded from the
61<a href="http://llvm.org/releases/">LLVM releases web site</a>.</p>
62
63<p>For more information about Clang or LLVM, including information about the
64latest release, please check out the main please see the
65<a href="http://clang.llvm.org">Clang Web Site</a> or the
66<a href="http://llvm.org">LLVM Web Site</a>.
67
68<p>Note that if you are reading this file from a Subversion checkout or the main
69Clang web page, this document applies to the <i>next</i> release, not the
70current one. To see the release notes for a specific release, please see the
71<a href="http://llvm.org/releases/">releases page</a>.</p>
72
73<!-- ======================================================================= -->
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]74<h2 id="whatsnew">What's New in Clang 3.1?</h2>
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]75<!-- ======================================================================= -->
76
77<p>Some of the major new features and improvements to Clang are listed here.
78Generic improvements to Clang as a whole or two its underlying infrastructure
79are described first, followed by language-specific sections with improvements to
80Clang's support for those languages.</p>
81
82<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
83<h3 id="majorfeatures">Major New Features</h3>
84<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
85
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]86<h4 id="majorfeature1">Feature 1</h4>
87...
Chandler Carrutha0df07d2011-11-28 22:17:58 +0000[diff] [blame]88
Nico Weber04606512012-02-16 02:35:03 +0000[diff] [blame]89<h4 id="diagnostics">New and better diagnostics</h4>
90
Dmitri Gribenko65005eb2012-02-18 14:13:26 +0000[diff] [blame]91<p>New: <code>-Wdangling-else</code>, <code>-Wstrncat-size</code>, ...</p>
Nico Weber04606512012-02-16 02:35:03 +0000[diff] [blame]92
David Blaikief76e7f72012-04-05 00:47:38 +0000[diff] [blame]93<p>Improved: <code>-Wformat</code>, <code>-Wempty-body</code>,
94<code>-Wliteral-conversion</code>, ...</p>
Nico Weber04606512012-02-16 02:35:03 +0000[diff] [blame]95
Manuel Klimek92f74092012-04-04 12:53:16 +0000[diff] [blame]96<h4 id="tooling">Tooling</h4>
97<!-- FIXME: add a link to the tooling documentation once that's written. -->
98<p>Added an API to enable clang-based standalone tools, including initial build
99system integration.</p>
100
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]101<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
102<h3 id="cchanges">C Language Changes in Clang</h3>
103<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
104
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]105<h4 id="c11changes">C11 Feature Support</h4>
Richard Smith62d730f2011-11-28 22:48:25 +0000[diff] [blame]106
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]107<p>Clang 3.1 adds support for anonymous structs and anonymous unions, added in
108the latest ISO C standard. Use <code>-std=c11</code> or <code>-std=gnu11</code>
109to enable support for the new language standard. The new C11 features are
Richard Smith62d730f2011-11-28 22:48:25 +0000[diff] [blame]110backwards-compatible and are available as an extension in all language
111modes.</p>
112
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]113<p>All warning and language selection flags which previously accepted
114<code>c1x</code> have been updated to accept <code>c11</code>. The old
David Chisnalld66117b2012-05-15 13:18:03 +0000[diff] [blame]115<code>c1x</code> forms have been removed.</p>
116
117<p>Clang 3.1 adds a family of <code>__c11_atomic</code> builtins corresponding
118 directly to the <code>_explict</code> versions of the C11 atomic functions.
119 This means that C11's <code>&lt;stdatomic.h&gt;</code> can be implemented in
120 a small set of trivial macros. </p>
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]121
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]122<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
123<h3 id="cxxchanges">C++ Language Changes in Clang</h3>
124<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
125
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]126<h4 id="cxx11changes">C++11 Feature Support</h4>
Richard Smith526cda32012-04-27 00:40:44 +0000[diff] [blame]127<p>Clang 3.1 supports
128<a href="http://clang.llvm.org/cxx_status.html#cxx11">most of the language
Richard Smith47931382011-11-28 23:35:03 +0000[diff] [blame]129features</a> added in the latest ISO C++ standard,
130<a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=50372">C++ 2011</a>.
131Use <code>-std=c++11</code> or <code>-std=gnu++11</code> to enable support for
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]132these features. In addition to the features supported by Clang 3.0, the
133following are now considered to be of production quality:
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]134<ul>
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]135 <li>Generalized constant expressions</li>
Douglas Gregorf28ded52012-02-23 17:54:00 +0000[diff] [blame]136 <li>Lambda expressions</li>
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]137 <li>Generalized initializers</li>
Richard Smithec92bc72012-03-03 23:51:05 +0000[diff] [blame]138 <li>Unrestricted unions</li>
Richard Smith69e76922012-03-09 19:09:47 +0000[diff] [blame]139 <li>User-defined literals</li>
Richard Smith1f4c54d2012-03-26 20:31:41 +0000[diff] [blame]140 <li>Forward-declared enumerations</li>
Richard Smith95e7aaf2012-04-13 01:24:35 +0000[diff] [blame]141 <li>Atomics (both libc++'s and libstdc++4.7's <tt>&lt;atomic&gt;</tt> are
142 supported)</li>
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]143</ul>
144
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]145<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
146<h3 id="objcchanges">Objective-C Language Changes in Clang</h3>
147<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]148Clang 3.1 introduces several new Objective-C language features and improvements.
Chandler Carruth4d582122011-11-29 00:15:23 +0000[diff] [blame]149
Nico Weber04606512012-02-16 02:35:03 +0000[diff] [blame]150<h4 id="objcwformat">Format string checking for NSString literals</h4>
151
152<code>-Wformat</code> now checks <code>@"nsstring literals"</code>.
Chandler Carruth52e375e2011-11-29 00:15:25 +0000[diff] [blame]153
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]154<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
155<h3 id="apichanges">Internal API Changes</h3>
156<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
157
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]158These are major API changes that have happened since the 3.0 release of Clang.
Chandler Carruthc4dbffa2011-11-28 18:55:47 +0000[diff] [blame]159If upgrading an external codebase that uses Clang as a library, this section
160should help get you past the largest hurdles of upgrading.
161
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]162<h4 id="api1">API change 1</h4>
163...
Chandler Carruthc4dbffa2011-11-28 18:55:47 +0000[diff] [blame]164
Gregory Szorc63419002012-05-12 20:45:56 +0000[diff] [blame]165<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
166<h3 id="pythonchanges">Python Binding Changes</h3>
167<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
168
169The following methods have been added:
170<ul>
171 <li>SourceLocation.from_position (static)</li>
172 <li>SourceLocation.__eq__ and SourceLocation.__ne__</li>
173 <li>SourceRange.__eq__ and SourceRange.__ne__</li>
174 <li>Diagnostic.category_number (property)</li>
175 <li>Diagnostic.category_name (property)</li>
176 <li>Diagnostic.option (property)</li>
177 <li>Diagnostic.disable_option (property)</li>
178 <li>CursorKind.is_translation_unit</li>
179 <li>CursorKind.is_preprocessing</li>
180 <li>CursorKind.is_unexposed</li>
181 <li>Cursor.from_location (static)</li>
182 <li>Cursor.underlying_typedef_type (property)</li>
183 <li>Cursor.enum_type (property)</li>
184 <li>Cursor.objc_type_encoding (property)</li>
185 <li>Cursor.hash</li>
186 <li>TypeKind.spelling</li>
187 <li>Type.argument_types</li>
188 <li>Type.element_type (property)</li>
189 <li>Type.element_count (property)</li>
190 <li>Type.is_function_variadic</li>
191 <li>Type.is_pod</li>
192 <li>Type.get_array_element_type</li>
193 <li>Type.get_array_size</li>
194 <li>Type.__eq__ and Type.__ne__</li>
195 <li>File.from_name (static)</li>
196 <li>File.__str__ and File.__repr__</li>
197</ul>
198
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]199<!-- ======================================================================= -->
200<h2 id="knownproblems">Significant Known Problems</h2>
201<!-- ======================================================================= -->
202
203<!-- ======================================================================= -->
204<h2 id="additionalinfo">Additional Information</h2>
205<!-- ======================================================================= -->
206
207<p>A wide variety of additional information is available on the
208<a href="http://clang.llvm.org/">Clang web page</a>. The web page contains
209versions of the API documentation which are up-to-date with the Subversion
210version of the source code. You can access versions of these documents specific
211to this release by going into the "<tt>clang/doc/</tt>" directory in the Clang
212tree.</p>
213
214<p>If you have any questions or comments about Clang, please feel free to
215contact us via the <a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev">
216mailing list</a>.</p>
217
Chandler Carruth59abf062011-11-28 22:12:44 +0000[diff] [blame]218
219<!-- ======================================================================= -->
220<!-- Likely 3.1 release notes -->
221<!-- ======================================================================= -->
222<!--
223This is just a section to hold things that have already gotten started and
224should likely pick up proper release notes in 3.1.
225
226- C1X and C++11 atomics infrastructure and support
227- CUDA support?
228
229-->
230
Benjamin Kramer665a8dc2012-01-15 15:26:07 +0000[diff] [blame]231</div>
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]232</body>
233</html>