Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / external / clang / 0724b7c43007d978c46f890dcd2ab3c8d3c22920 / . / docs / ReleaseNotes.html
blob: 628079978e7329f15c69f67dd4d472d02d9d611b [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>
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]34 </ul>
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]35 </li>
36 <li><a href="#knownproblems">Known Problems</a></li>
37 <li><a href="#additionalinfo">Additional Information</a></li>
38</ul>
39
40<div class="doc_author">
41 <p>Written by the <a href="http://llvm.org/">LLVM Team</a></p>
42</div>
43
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]44<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]45release.<br>
46You may prefer the
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]47<a href="http://llvm.org/releases/3.0/docs/ClangReleaseNotes.html">Clang 3.0
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]48Release Notes</a>.</h1>
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]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
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]55frontend, part of the LLVM Compiler Infrastructure, release 3.1. Here we
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]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,
Peter Collingbourne5cc989e2011-11-29 02:03:03 +0000[diff] [blame]58see <a href="http://llvm.org/docs/ReleaseNotes.html">the LLVM
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]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<!-- ======================================================================= -->
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]73<h2 id="whatsnew">What's New in Clang 3.1?</h2>
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]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
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]85<h4 id="majorfeature1">Feature 1</h4>
86...
Chandler Carrutha0df07d2011-11-28 22:17:58 +0000[diff] [blame]87
Nico Weber04606512012-02-16 02:35:03 +0000[diff] [blame]88<h4 id="diagnostics">New and better diagnostics</h4>
89
Dmitri Gribenko65005eb2012-02-18 14:13:26 +0000[diff] [blame]90<p>New: <code>-Wdangling-else</code>, <code>-Wstrncat-size</code>, ...</p>
Nico Weber04606512012-02-16 02:35:03 +0000[diff] [blame]91
Dmitri Gribenko65005eb2012-02-18 14:13:26 +0000[diff] [blame]92<p>Improved: <code>-Wformat</code>, <code>-Wempty-body</code>, ...</p>
Nico Weber04606512012-02-16 02:35:03 +0000[diff] [blame]93
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]94<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
95<h3 id="cchanges">C Language Changes in Clang</h3>
96<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
97
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]98<h4 id="c11changes">C11 Feature Support</h4>
Richard Smith62d730f2011-11-28 22:48:25 +0000[diff] [blame]99
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]100<p>Clang 3.1 adds support for anonymous structs and anonymous unions, added in
101the latest ISO C standard. Use <code>-std=c11</code> or <code>-std=gnu11</code>
102to enable support for the new language standard. The new C11 features are
Richard Smith62d730f2011-11-28 22:48:25 +0000[diff] [blame]103backwards-compatible and are available as an extension in all language
104modes.</p>
105
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]106<p>All warning and language selection flags which previously accepted
107<code>c1x</code> have been updated to accept <code>c11</code>. The old
108<code>c1x</code> forms have been removed.
109
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]110<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
111<h3 id="cxxchanges">C++ Language Changes in Clang</h3>
112<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
113
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]114<h4 id="cxx11changes">C++11 Feature Support</h4>
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]115<p>Clang 3.1 adds support for
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]116<a href="http://clang.llvm.org/cxx_status.html#cxx11">more of the language
Richard Smith47931382011-11-28 23:35:03 +0000[diff] [blame]117features</a> added in the latest ISO C++ standard,
118<a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=50372">C++ 2011</a>.
119Use <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]120these features. In addition to the features supported by Clang 3.0, the
121following are now considered to be of production quality:
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]122<ul>
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]123 <li>Generalized constant expressions</li>
Douglas Gregorf28ded52012-02-23 17:54:00 +0000[diff] [blame]124 <li>Lambda expressions</li>
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]125 <li>Generalized initializers</li>
Richard Smithec92bc72012-03-03 23:51:05 +0000[diff] [blame]126 <li>Unrestricted unions</li>
Richard Smith69e76922012-03-09 19:09:47 +0000[diff] [blame]127 <li>User-defined literals</li>
Richard Smith855746b2011-11-28 20:02:05 +0000[diff] [blame]128</ul>
129
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]130<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
131<h3 id="objcchanges">Objective-C Language Changes in Clang</h3>
132<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]133Clang 3.1 introduces several new Objective-C language features and improvements.
Chandler Carruth4d582122011-11-29 00:15:23 +0000[diff] [blame]134
Nico Weber04606512012-02-16 02:35:03 +0000[diff] [blame]135<h4 id="objcwformat">Format string checking for NSString literals</h4>
136
137<code>-Wformat</code> now checks <code>@"nsstring literals"</code>.
Chandler Carruth52e375e2011-11-29 00:15:25 +0000[diff] [blame]138
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]139<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
140<h3 id="apichanges">Internal API Changes</h3>
141<!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
142
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]143These are major API changes that have happened since the 3.0 release of Clang.
Chandler Carruthc4dbffa2011-11-28 18:55:47 +0000[diff] [blame]144If upgrading an external codebase that uses Clang as a library, this section
145should help get you past the largest hurdles of upgrading.
146
Richard Smith45fb9952012-02-16 00:32:27 +0000[diff] [blame]147<h4 id="api1">API change 1</h4>
148...
Chandler Carruthc4dbffa2011-11-28 18:55:47 +0000[diff] [blame]149
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]150<!-- ======================================================================= -->
151<h2 id="knownproblems">Significant Known Problems</h2>
152<!-- ======================================================================= -->
153
154<!-- ======================================================================= -->
155<h2 id="additionalinfo">Additional Information</h2>
156<!-- ======================================================================= -->
157
158<p>A wide variety of additional information is available on the
159<a href="http://clang.llvm.org/">Clang web page</a>. The web page contains
160versions of the API documentation which are up-to-date with the Subversion
161version of the source code. You can access versions of these documents specific
162to this release by going into the "<tt>clang/doc/</tt>" directory in the Clang
163tree.</p>
164
165<p>If you have any questions or comments about Clang, please feel free to
166contact us via the <a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev">
167mailing list</a>.</p>
168
Chandler Carruth59abf062011-11-28 22:12:44 +0000[diff] [blame]169
170<!-- ======================================================================= -->
171<!-- Likely 3.1 release notes -->
172<!-- ======================================================================= -->
173<!--
174This is just a section to hold things that have already gotten started and
175should likely pick up proper release notes in 3.1.
176
177- C1X and C++11 atomics infrastructure and support
178- CUDA support?
179
180-->
181
Benjamin Kramer665a8dc2012-01-15 15:26:07 +0000[diff] [blame]182</div>
Chandler Carruthc00c0c32011-11-28 07:16:19 +0000[diff] [blame]183</body>
184</html>