Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / external / clang / 050315bfd0473323a68f2da99b51bbe2842f6c36 / . / docs / ReleaseNotes.rst
blob: be7a1da2f58aa895a99bb3d49ccec7fad7eacce3 [file] [log] [blame]
Sean Silva28c1f752013-01-02 22:05:33 +0000[diff] [blame]1=====================================
Bill Wendlinga03209e2013-06-04 06:17:46 +0000[diff] [blame]2Clang 3.4 (In-Progress) Release Notes
Sean Silva28c1f752013-01-02 22:05:33 +0000[diff] [blame]3=====================================
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]4
5.. contents::
6 :local:
7 :depth: 2
8
9Written by the `LLVM Team <http://llvm.org/>`_
10
11.. warning::
12
Bill Wendlinga03209e2013-06-04 06:17:46 +0000[diff] [blame]13 These are in-progress notes for the upcoming Clang 3.4 release. You may
14 prefer the `Clang 3.3 Release Notes
15 <http://llvm.org/releases/3.3/docs/ClangReleaseNotes.html>`_.
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]16
17Introduction
18============
19
20This document contains the release notes for the Clang C/C++/Objective-C
Bill Wendlinga03209e2013-06-04 06:17:46 +0000[diff] [blame]21frontend, part of the LLVM Compiler Infrastructure, release 3.4. 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
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
Bill Wendlinga03209e2013-06-04 06:17:46 +0000[diff] [blame]39What's New in Clang 3.4?
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]40========================
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
50Improvements to Clang's diagnostics
51^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
52
53Clang's diagnostics are constantly being improved to catch more issues,
54explain them more clearly, and provide more accurate source information
Bill Wendlinga03209e2013-06-04 06:17:46 +0000[diff] [blame]55about them. The improvements since the 3.3 release include:
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]56
57- ...
58
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]59New Compiler Flags
60------------------
61
62- ...
63
64C Language Changes in Clang
65---------------------------
66
67C11 Feature Support
68^^^^^^^^^^^^^^^^^^^
69
70...
71
72C++ Language Changes in Clang
73-----------------------------
74
Bill Wendlinga03209e2013-06-04 06:17:46 +0000[diff] [blame]75- ...
Rafael Espindola40db5152013-04-09 12:51:24 +0000[diff] [blame]76
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]77C++11 Feature Support
78^^^^^^^^^^^^^^^^^^^^^
79
80...
81
82Objective-C Language Changes in Clang
83-------------------------------------
84
85...
86
87Internal API Changes
88--------------------
89
Bill Wendlinga03209e2013-06-04 06:17:46 +0000[diff] [blame]90These are major API changes that have happened since the 3.3 release of
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]91Clang. If upgrading an external codebase that uses Clang as a library,
92this section should help get you past the largest hurdles of upgrading.
93
Hans Wennborg0437e0d2013-05-20 14:53:06 +0000[diff] [blame]94Wide Character Types
95^^^^^^^^^^^^^^^^^^^^
96
97The ASTContext class now keeps track of two different types for wide character
98types: WCharTy and WideCharTy. WCharTy represents the built-in wchar_t type
99available in C++. WideCharTy is the type used for wide character literals; in
100C++ it is the same as WCharTy, but in C99, where wchar_t is a typedef, it is an
101integer type.
102
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]103...
104
Ted Kremenek230fc372013-04-24 07:33:52 +0000[diff] [blame]105libclang
106--------
107
Bill Wendlinga03209e2013-06-04 06:17:46 +0000[diff] [blame]108...
Ted Kremenek230fc372013-04-24 07:33:52 +0000[diff] [blame]109
Anna Zaks08741a02013-04-25 23:14:38 +0000[diff] [blame]110Static Analyzer
Ted Kremenek1377a462013-04-26 00:01:34 +0000[diff] [blame]111---------------
Anna Zaks08741a02013-04-25 23:14:38 +0000[diff] [blame]112
Ted Kremenek1377a462013-04-26 00:01:34 +0000[diff] [blame]113The static analyzer (which contains additional code checking beyond compiler
114warnings) has improved significantly in both in the core analysis engine and
115also in the kinds of issues it can find.
116
117Core Analysis Improvements
118==========================
119
Bill Wendlinga03209e2013-06-04 06:17:46 +0000[diff] [blame]120- ...
Ted Kremenek1377a462013-04-26 00:01:34 +0000[diff] [blame]121
122New Issues Found
123================
124
Bill Wendlinga03209e2013-06-04 06:17:46 +0000[diff] [blame]125- ...
Anna Zaks08741a02013-04-25 23:14:38 +0000[diff] [blame]126
Sean Silvadebc0182012-12-23 01:19:35 +0000[diff] [blame]127Python Binding Changes
128----------------------
129
130The following methods have been added:
131
132- ...
133
134Significant Known Problems
135==========================
136
137Additional Information
138======================
139
140A wide variety of additional information is available on the `Clang web
141page <http://clang.llvm.org/>`_. The web page contains versions of the
142API documentation which are up-to-date with the Subversion version of
143the source code. You can access versions of these documents specific to
144this release by going into the "``clang/docs/``" directory in the Clang
145tree.
146
147If you have any questions or comments about Clang, please feel free to
148contact us via the `mailing
149list <http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev>`_.