Blame - docs/ReleaseNotes.rst - platform/external/clang

blob: df4ee1b5a09285797af15036c77ea5e6ad92973f [file] [log] [blame]

Sean Silva	28c1f75	2013-01-02 22:05:33 +0000	[diff] [blame]	1	=====================================
Bill Wendling	a03209e	2013-06-04 06:17:46 +0000	[diff] [blame]	2	Clang 3.4 (In-Progress) Release Notes
Sean Silva	28c1f75	2013-01-02 22:05:33 +0000	[diff] [blame]	3	=====================================
Sean Silva	debc018	2012-12-23 01:19:35 +0000	[diff] [blame]	4
				5	.. contents::
				6	:local:
				7	:depth: 2
				8
				9	Written by the `LLVM Team <http://llvm.org/>`_
				10
				11	.. warning::
				12
Bill Wendling	a03209e	2013-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
Richard Smith	2c72000	2013-06-17 23:53:08 +0000	[diff] [blame]	15	<http://llvm.org/releases/3.3/tools/clang/docs/ReleaseNotes.html>`_.
Sean Silva	debc018	2012-12-23 01:19:35 +0000	[diff] [blame]	16
				17	Introduction
				18	============
				19
				20	This document contains the release notes for the Clang C/C++/Objective-C
Bill Wendling	a03209e	2013-06-04 06:17:46 +0000	[diff] [blame]	21	frontend, part of the LLVM Compiler Infrastructure, release 3.4. Here we
Sean Silva	debc018	2012-12-23 01:19:35 +0000	[diff] [blame]	22	describe the status of Clang in some detail, including major
				23	improvements from the previous release and new feature work. For the
				24	general LLVM release notes, see `the LLVM
				25	documentation <http://llvm.org/docs/ReleaseNotes.html>`_. All LLVM
				26	releases may be downloaded from the `LLVM releases web
				27	site <http://llvm.org/releases/>`_.
				28
				29	For more information about Clang or LLVM, including information about
				30	the latest release, please check out the main please see the `Clang Web
				31	Site <http://clang.llvm.org>`_ or the `LLVM Web
				32	Site <http://llvm.org>`_.
				33
				34	Note that if you are reading this file from a Subversion checkout or the
				35	main Clang web page, this document applies to the next release, not
				36	the current one. To see the release notes for a specific release, please
				37	see the `releases page <http://llvm.org/releases/>`_.
				38
Bill Wendling	a03209e	2013-06-04 06:17:46 +0000	[diff] [blame]	39	What's New in Clang 3.4?
Sean Silva	debc018	2012-12-23 01:19:35 +0000	[diff] [blame]	40	========================
				41
				42	Some of the major new features and improvements to Clang are listed
				43	here. Generic improvements to Clang as a whole or to its underlying
				44	infrastructure are described first, followed by language-specific
				45	sections with improvements to Clang's support for those languages.
				46
				47	Major New Features
				48	------------------
				49
				50	Improvements to Clang's diagnostics
				51	^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
				52
				53	Clang's diagnostics are constantly being improved to catch more issues,
				54	explain them more clearly, and provide more accurate source information
Bill Wendling	a03209e	2013-06-04 06:17:46 +0000	[diff] [blame]	55	about them. The improvements since the 3.3 release include:
Sean Silva	debc018	2012-12-23 01:19:35 +0000	[diff] [blame]	56
				57	- ...
				58
Sean Silva	debc018	2012-12-23 01:19:35 +0000	[diff] [blame]	59	New Compiler Flags
				60	------------------
				61
Rafael Espindola	3b0f62b	2013-08-23 21:49:00 +0000	[diff] [blame]	62	- Clang no longer special cases -O4 to enable lto. Explicitly pass -flto to
				63	enable it.
Shuxin Yang	8b49854	2013-08-23 22:01:03 +0000	[diff] [blame]	64	- Command line "clang -O3 -flto a.c -c" and "clang -emit-llvm a.c -c"
				65	are no longer equivalent.
Sean Silva	debc018	2012-12-23 01:19:35 +0000	[diff] [blame]	66
				67	C Language Changes in Clang
				68	---------------------------
				69
Michael Gottesman	98d1ec1	2013-06-20 23:28:10 +0000	[diff] [blame]	70	- Added new checked arithmetic builtins for security critical applications.
				71
Sean Silva	debc018	2012-12-23 01:19:35 +0000	[diff] [blame]	72	C11 Feature Support
				73	^^^^^^^^^^^^^^^^^^^
				74
				75	...
				76
				77	C++ Language Changes in Clang
				78	-----------------------------
				79
Eli Friedman	6540052	2013-07-20 01:06:31 +0000	[diff] [blame]	80	- Fixed an ABI regression, introduced in Clang 3.2, which affected
				81	member offsets for classes inheriting from certain classes with tail padding.
				82	See PR16537.
				83
Bill Wendling	a03209e	2013-06-04 06:17:46 +0000	[diff] [blame]	84	- ...
Rafael Espindola	40db515	2013-04-09 12:51:24 +0000	[diff] [blame]	85
Sean Silva	debc018	2012-12-23 01:19:35 +0000	[diff] [blame]	86	C++11 Feature Support
				87	^^^^^^^^^^^^^^^^^^^^^
				88
				89	...
				90
				91	Objective-C Language Changes in Clang
				92	-------------------------------------
				93
				94	...
				95
				96	Internal API Changes
				97	--------------------
				98
Bill Wendling	a03209e	2013-06-04 06:17:46 +0000	[diff] [blame]	99	These are major API changes that have happened since the 3.3 release of
Sean Silva	debc018	2012-12-23 01:19:35 +0000	[diff] [blame]	100	Clang. If upgrading an external codebase that uses Clang as a library,
				101	this section should help get you past the largest hurdles of upgrading.
				102
Hans Wennborg	0437e0d	2013-05-20 14:53:06 +0000	[diff] [blame]	103	Wide Character Types
				104	^^^^^^^^^^^^^^^^^^^^
				105
				106	The ASTContext class now keeps track of two different types for wide character
				107	types: WCharTy and WideCharTy. WCharTy represents the built-in wchar_t type
				108	available in C++. WideCharTy is the type used for wide character literals; in
				109	C++ it is the same as WCharTy, but in C99, where wchar_t is a typedef, it is an
				110	integer type.
				111
Sean Silva	debc018	2012-12-23 01:19:35 +0000	[diff] [blame]	112	...
				113
Ted Kremenek	230fc37	2013-04-24 07:33:52 +0000	[diff] [blame]	114	libclang
				115	--------
				116
Bill Wendling	a03209e	2013-06-04 06:17:46 +0000	[diff] [blame]	117	...
Ted Kremenek	230fc37	2013-04-24 07:33:52 +0000	[diff] [blame]	118
Anna Zaks	08741a0	2013-04-25 23:14:38 +0000	[diff] [blame]	119	Static Analyzer
Ted Kremenek	1377a46	2013-04-26 00:01:34 +0000	[diff] [blame]	120	---------------
Anna Zaks	08741a0	2013-04-25 23:14:38 +0000	[diff] [blame]	121
Ted Kremenek	1377a46	2013-04-26 00:01:34 +0000	[diff] [blame]	122	The static analyzer (which contains additional code checking beyond compiler
				123	warnings) has improved significantly in both in the core analysis engine and
				124	also in the kinds of issues it can find.
				125
				126	Core Analysis Improvements
				127	==========================
				128
Bill Wendling	a03209e	2013-06-04 06:17:46 +0000	[diff] [blame]	129	- ...
Ted Kremenek	1377a46	2013-04-26 00:01:34 +0000	[diff] [blame]	130
				131	New Issues Found
				132	================
				133
Bill Wendling	a03209e	2013-06-04 06:17:46 +0000	[diff] [blame]	134	- ...
Anna Zaks	08741a0	2013-04-25 23:14:38 +0000	[diff] [blame]	135
Sean Silva	debc018	2012-12-23 01:19:35 +0000	[diff] [blame]	136	Python Binding Changes
				137	----------------------
				138
				139	The following methods have been added:
				140
				141	- ...
				142
				143	Significant Known Problems
				144	==========================
				145
				146	Additional Information
				147	======================
				148
				149	A wide variety of additional information is available on the `Clang web
				150	page <http://clang.llvm.org/>`_. The web page contains versions of the
				151	API documentation which are up-to-date with the Subversion version of
				152	the source code. You can access versions of these documents specific to
				153	this release by going into the "``clang/docs/``" directory in the Clang
				154	tree.
				155
				156	If you have any questions or comments about Clang, please feel free to
				157	contact us via the `mailing
				158	list <http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev>`_.