| 1 | ======================================= |
|---|
| 2 | Clang 9.0.0 (In-Progress) Release Notes |
|---|
| 3 | ======================================= |
|---|
| 4 | |
|---|
| 5 | .. contents:: |
|---|
| 6 | :local: |
|---|
| 7 | :depth: 2 |
|---|
| 8 | |
|---|
| 9 | Written by the `LLVM Team <https://llvm.org/>`_ |
|---|
| 10 | |
|---|
| 11 | .. warning:: |
|---|
| 12 | |
|---|
| 13 | These are in-progress notes for the upcoming Clang 9 release. |
|---|
| 14 | Release notes for previous releases can be found on |
|---|
| 15 | `the Download Page <https://releases.llvm.org/download.html>`_. |
|---|
| 16 | |
|---|
| 17 | Introduction |
|---|
| 18 | ============ |
|---|
| 19 | |
|---|
| 20 | This document contains the release notes for the Clang C/C++/Objective-C |
|---|
| 21 | frontend, part of the LLVM Compiler Infrastructure, release 9.0.0. Here we |
|---|
| 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 <https://llvm.org/docs/ReleaseNotes.html>`_. All LLVM |
|---|
| 26 | releases may be downloaded from the `LLVM releases web |
|---|
| 27 | site <https://llvm.org/releases/>`_. |
|---|
| 28 | |
|---|
| 29 | For more information about Clang or LLVM, including information about the |
|---|
| 30 | latest release, please see the `Clang Web Site <https://clang.llvm.org>`_ or the |
|---|
| 31 | `LLVM Web Site <https://llvm.org>`_. |
|---|
| 32 | |
|---|
| 33 | Note that if you are reading this file from a Subversion checkout or the |
|---|
| 34 | main Clang web page, this document applies to the *next* release, not |
|---|
| 35 | the current one. To see the release notes for a specific release, please |
|---|
| 36 | see the `releases page <https://llvm.org/releases/>`_. |
|---|
| 37 | |
|---|
| 38 | What's New in Clang 9.0.0? |
|---|
| 39 | ========================== |
|---|
| 40 | |
|---|
| 41 | Some of the major new features and improvements to Clang are listed |
|---|
| 42 | here. Generic improvements to Clang as a whole or to its underlying |
|---|
| 43 | infrastructure are described first, followed by language-specific |
|---|
| 44 | sections with improvements to Clang's support for those languages. |
|---|
| 45 | |
|---|
| 46 | Major New Features |
|---|
| 47 | ------------------ |
|---|
| 48 | |
|---|
| 49 | - ... |
|---|
| 50 | |
|---|
| 51 | Improvements to Clang's diagnostics |
|---|
| 52 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
|---|
| 53 | |
|---|
| 54 | - ... |
|---|
| 55 | |
|---|
| 56 | Non-comprehensive list of changes in this release |
|---|
| 57 | ------------------------------------------------- |
|---|
| 58 | |
|---|
| 59 | - ... |
|---|
| 60 | |
|---|
| 61 | |
|---|
| 62 | New Compiler Flags |
|---|
| 63 | ------------------ |
|---|
| 64 | |
|---|
| 65 | - ... |
|---|
| 66 | |
|---|
| 67 | Deprecated Compiler Flags |
|---|
| 68 | ------------------------- |
|---|
| 69 | |
|---|
| 70 | The following options are deprecated and ignored. They will be removed in |
|---|
| 71 | future versions of Clang. |
|---|
| 72 | |
|---|
| 73 | - ... |
|---|
| 74 | |
|---|
| 75 | Modified Compiler Flags |
|---|
| 76 | ----------------------- |
|---|
| 77 | |
|---|
| 78 | - `clang -dumpversion` now returns the version of Clang itself. |
|---|
| 79 | |
|---|
| 80 | - ... |
|---|
| 81 | |
|---|
| 82 | New Pragmas in Clang |
|---|
| 83 | -------------------- |
|---|
| 84 | |
|---|
| 85 | - ... |
|---|
| 86 | |
|---|
| 87 | Attribute Changes in Clang |
|---|
| 88 | -------------------------- |
|---|
| 89 | |
|---|
| 90 | - ... |
|---|
| 91 | |
|---|
| 92 | Windows Support |
|---|
| 93 | --------------- |
|---|
| 94 | |
|---|
| 95 | - ... |
|---|
| 96 | |
|---|
| 97 | |
|---|
| 98 | C Language Changes in Clang |
|---|
| 99 | --------------------------- |
|---|
| 100 | |
|---|
| 101 | - ... |
|---|
| 102 | |
|---|
| 103 | ... |
|---|
| 104 | |
|---|
| 105 | C11 Feature Support |
|---|
| 106 | ^^^^^^^^^^^^^^^^^^^ |
|---|
| 107 | |
|---|
| 108 | ... |
|---|
| 109 | |
|---|
| 110 | C++ Language Changes in Clang |
|---|
| 111 | ----------------------------- |
|---|
| 112 | |
|---|
| 113 | - ... |
|---|
| 114 | |
|---|
| 115 | C++1z Feature Support |
|---|
| 116 | ^^^^^^^^^^^^^^^^^^^^^ |
|---|
| 117 | |
|---|
| 118 | ... |
|---|
| 119 | |
|---|
| 120 | Objective-C Language Changes in Clang |
|---|
| 121 | ------------------------------------- |
|---|
| 122 | |
|---|
| 123 | ... |
|---|
| 124 | |
|---|
| 125 | OpenCL C Language Changes in Clang |
|---|
| 126 | ---------------------------------- |
|---|
| 127 | |
|---|
| 128 | ... |
|---|
| 129 | |
|---|
| 130 | ABI Changes in Clang |
|---|
| 131 | -------------------- |
|---|
| 132 | |
|---|
| 133 | - ... |
|---|
| 134 | |
|---|
| 135 | OpenMP Support in Clang |
|---|
| 136 | ----------------------- |
|---|
| 137 | |
|---|
| 138 | - Added emission of the debug information for NVPTX target devices. |
|---|
| 139 | |
|---|
| 140 | CUDA Support in Clang |
|---|
| 141 | --------------------- |
|---|
| 142 | |
|---|
| 143 | - Added emission of the debug information for the device code. |
|---|
| 144 | |
|---|
| 145 | Internal API Changes |
|---|
| 146 | -------------------- |
|---|
| 147 | |
|---|
| 148 | These are major API changes that have happened since the 8.0.0 release of |
|---|
| 149 | Clang. If upgrading an external codebase that uses Clang as a library, |
|---|
| 150 | this section should help get you past the largest hurdles of upgrading. |
|---|
| 151 | |
|---|
| 152 | Build System Changes |
|---|
| 153 | -------------------- |
|---|
| 154 | |
|---|
| 155 | These are major changes to the build system that have happened since the 8.0.0 |
|---|
| 156 | release of Clang. Users of the build system should adjust accordingly. |
|---|
| 157 | |
|---|
| 158 | - In 8.0.0 and below, the install-clang-headers target would install clang's |
|---|
| 159 | resource directory headers. This installation is now performed by the |
|---|
| 160 | install-clang-resource-headers target. Users of the old install-clang-headers |
|---|
| 161 | target should switch to the new install-clang-resource-headers target. The |
|---|
| 162 | install-clang-headers target now installs clang's API headers (corresponding |
|---|
| 163 | to its libraries), which is consistent with the install-llvm-headers target. |
|---|
| 164 | |
|---|
| 165 | - ... |
|---|
| 166 | |
|---|
| 167 | AST Matchers |
|---|
| 168 | ------------ |
|---|
| 169 | |
|---|
| 170 | - ... |
|---|
| 171 | |
|---|
| 172 | clang-format |
|---|
| 173 | ------------ |
|---|
| 174 | |
|---|
| 175 | - Add language support for clang-formatting C# files |
|---|
| 176 | - Add Microsoft coding style to encapsulate default C# formatting style |
|---|
| 177 | - Added new option `PPDIS_BeforeHash` (in configuration: `BeforeHash`) to |
|---|
| 178 | `IndentPPDirectives` which indents preprocessor directives before the hash. |
|---|
| 179 | |
|---|
| 180 | libclang |
|---|
| 181 | -------- |
|---|
| 182 | |
|---|
| 183 | - When `CINDEXTEST_INCLUDE_ATTRIBUTED_TYPES` is not provided when making a |
|---|
| 184 | CXType, the equivalent type of the AttributedType is returned instead of the |
|---|
| 185 | modified type if the user does not want attribute sugar. The equivalent type |
|---|
| 186 | represents the minimally-desugared type which the AttributedType is |
|---|
| 187 | canonically equivalent to. |
|---|
| 188 | |
|---|
| 189 | |
|---|
| 190 | Static Analyzer |
|---|
| 191 | --------------- |
|---|
| 192 | |
|---|
| 193 | - ... |
|---|
| 194 | |
|---|
| 195 | ... |
|---|
| 196 | |
|---|
| 197 | .. _release-notes-ubsan: |
|---|
| 198 | |
|---|
| 199 | Undefined Behavior Sanitizer (UBSan) |
|---|
| 200 | ------------------------------------ |
|---|
| 201 | |
|---|
| 202 | - ... |
|---|
| 203 | |
|---|
| 204 | Core Analysis Improvements |
|---|
| 205 | ========================== |
|---|
| 206 | |
|---|
| 207 | - ... |
|---|
| 208 | |
|---|
| 209 | New Issues Found |
|---|
| 210 | ================ |
|---|
| 211 | |
|---|
| 212 | - ... |
|---|
| 213 | |
|---|
| 214 | Python Binding Changes |
|---|
| 215 | ---------------------- |
|---|
| 216 | |
|---|
| 217 | The following methods have been added: |
|---|
| 218 | |
|---|
| 219 | - ... |
|---|
| 220 | |
|---|
| 221 | Significant Known Problems |
|---|
| 222 | ========================== |
|---|
| 223 | |
|---|
| 224 | Additional Information |
|---|
| 225 | ====================== |
|---|
| 226 | |
|---|
| 227 | A wide variety of additional information is available on the `Clang web |
|---|
| 228 | page <https://clang.llvm.org/>`_. The web page contains versions of the |
|---|
| 229 | API documentation which are up-to-date with the Subversion version of |
|---|
| 230 | the source code. You can access versions of these documents specific to |
|---|
| 231 | this release by going into the "``clang/docs/``" directory in the Clang |
|---|
| 232 | tree. |
|---|
| 233 | |
|---|
| 234 | If you have any questions or comments about Clang, please feel free to |
|---|
| 235 | contact us via the `mailing |
|---|
| 236 | list <https://lists.llvm.org/mailman/listinfo/cfe-dev>`_. |
|---|
| 237 | |
|---|