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 | |
| 62 | - ... |
| 63 | |
| 64 | C Language Changes in Clang |
| 65 | --------------------------- |
| 66 | |
Michael Gottesman | 98d1ec1 | 2013-06-20 23:28:10 +0000 | [diff] [blame] | 67 | - Added new checked arithmetic builtins for security critical applications. |
| 68 | |
Sean Silva | debc018 | 2012-12-23 01:19:35 +0000 | [diff] [blame] | 69 | C11 Feature Support |
| 70 | ^^^^^^^^^^^^^^^^^^^ |
| 71 | |
| 72 | ... |
| 73 | |
| 74 | C++ Language Changes in Clang |
| 75 | ----------------------------- |
| 76 | |
Bill Wendling | a03209e | 2013-06-04 06:17:46 +0000 | [diff] [blame] | 77 | - ... |
Rafael Espindola | 40db515 | 2013-04-09 12:51:24 +0000 | [diff] [blame] | 78 | |
Sean Silva | debc018 | 2012-12-23 01:19:35 +0000 | [diff] [blame] | 79 | C++11 Feature Support |
| 80 | ^^^^^^^^^^^^^^^^^^^^^ |
| 81 | |
| 82 | ... |
| 83 | |
| 84 | Objective-C Language Changes in Clang |
| 85 | ------------------------------------- |
| 86 | |
| 87 | ... |
| 88 | |
| 89 | Internal API Changes |
| 90 | -------------------- |
| 91 | |
Bill Wendling | a03209e | 2013-06-04 06:17:46 +0000 | [diff] [blame] | 92 | 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] | 93 | Clang. If upgrading an external codebase that uses Clang as a library, |
| 94 | this section should help get you past the largest hurdles of upgrading. |
| 95 | |
Hans Wennborg | 0437e0d | 2013-05-20 14:53:06 +0000 | [diff] [blame] | 96 | Wide Character Types |
| 97 | ^^^^^^^^^^^^^^^^^^^^ |
| 98 | |
| 99 | The ASTContext class now keeps track of two different types for wide character |
| 100 | types: WCharTy and WideCharTy. WCharTy represents the built-in wchar_t type |
| 101 | available in C++. WideCharTy is the type used for wide character literals; in |
| 102 | C++ it is the same as WCharTy, but in C99, where wchar_t is a typedef, it is an |
| 103 | integer type. |
| 104 | |
Sean Silva | debc018 | 2012-12-23 01:19:35 +0000 | [diff] [blame] | 105 | ... |
| 106 | |
Ted Kremenek | 230fc37 | 2013-04-24 07:33:52 +0000 | [diff] [blame] | 107 | libclang |
| 108 | -------- |
| 109 | |
Bill Wendling | a03209e | 2013-06-04 06:17:46 +0000 | [diff] [blame] | 110 | ... |
Ted Kremenek | 230fc37 | 2013-04-24 07:33:52 +0000 | [diff] [blame] | 111 | |
Anna Zaks | 08741a0 | 2013-04-25 23:14:38 +0000 | [diff] [blame] | 112 | Static Analyzer |
Ted Kremenek | 1377a46 | 2013-04-26 00:01:34 +0000 | [diff] [blame] | 113 | --------------- |
Anna Zaks | 08741a0 | 2013-04-25 23:14:38 +0000 | [diff] [blame] | 114 | |
Ted Kremenek | 1377a46 | 2013-04-26 00:01:34 +0000 | [diff] [blame] | 115 | The static analyzer (which contains additional code checking beyond compiler |
| 116 | warnings) has improved significantly in both in the core analysis engine and |
| 117 | also in the kinds of issues it can find. |
| 118 | |
| 119 | Core Analysis Improvements |
| 120 | ========================== |
| 121 | |
Bill Wendling | a03209e | 2013-06-04 06:17:46 +0000 | [diff] [blame] | 122 | - ... |
Ted Kremenek | 1377a46 | 2013-04-26 00:01:34 +0000 | [diff] [blame] | 123 | |
| 124 | New Issues Found |
| 125 | ================ |
| 126 | |
Bill Wendling | a03209e | 2013-06-04 06:17:46 +0000 | [diff] [blame] | 127 | - ... |
Anna Zaks | 08741a0 | 2013-04-25 23:14:38 +0000 | [diff] [blame] | 128 | |
Sean Silva | debc018 | 2012-12-23 01:19:35 +0000 | [diff] [blame] | 129 | Python Binding Changes |
| 130 | ---------------------- |
| 131 | |
| 132 | The following methods have been added: |
| 133 | |
| 134 | - ... |
| 135 | |
| 136 | Significant Known Problems |
| 137 | ========================== |
| 138 | |
| 139 | Additional Information |
| 140 | ====================== |
| 141 | |
| 142 | A wide variety of additional information is available on the `Clang web |
| 143 | page <http://clang.llvm.org/>`_. The web page contains versions of the |
| 144 | API documentation which are up-to-date with the Subversion version of |
| 145 | the source code. You can access versions of these documents specific to |
| 146 | this release by going into the "``clang/docs/``" directory in the Clang |
| 147 | tree. |
| 148 | |
| 149 | If you have any questions or comments about Clang, please feel free to |
| 150 | contact us via the `mailing |
| 151 | list <http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev>`_. |