From 21669b4e493cf5aaf56dea3b3f5dbb90e1163ced Mon Sep 17 00:00:00 2001 From: Hans Wennborg Date: Mon, 18 Jul 2016 18:08:59 +0000 Subject: [PATCH] Trunk release notes are now for 4.0.0 The 3.9 release are on the 3.9 branch. llvm-svn: 275846 --- clang-tools-extra/docs/ReleaseNotes.rst | 354 +------------------------------- 1 file changed, 11 insertions(+), 343 deletions(-) diff --git a/clang-tools-extra/docs/ReleaseNotes.rst b/clang-tools-extra/docs/ReleaseNotes.rst index 9026da9..32e855a 100644 --- a/clang-tools-extra/docs/ReleaseNotes.rst +++ b/clang-tools-extra/docs/ReleaseNotes.rst @@ -1,6 +1,6 @@ -================================================= -Extra Clang Tools 3.9 (In-Progress) Release Notes -================================================= +=================================================== +Extra Clang Tools 4.0.0 (In-Progress) Release Notes +=================================================== .. contents:: :local: @@ -10,7 +10,7 @@ Written by the `LLVM Team `_ .. warning:: - These are in-progress notes for the upcoming Clang 3.9 release. You may + These are in-progress notes for the upcoming Clang 4.0.0 release. You may prefer the `Clang 3.8 Release Notes `_. @@ -18,7 +18,7 @@ Introduction ============ This document contains the release notes for the Extra Clang Tools, part of the -Clang release 3.9. Here we describe the status of the Extra Clang Tools in some +Clang release 4.0.0. Here we describe the status of the Extra Clang Tools in some detail, including major improvements from the previous release and new feature work. For the general Clang release notes, see `the Clang documentation `_. All LLVM @@ -34,8 +34,8 @@ main Clang web page, this document applies to the *next* release, not the current one. To see the release notes for a specific release, please see the `releases page `_. -What's New in Extra Clang Tools 3.9? -==================================== +What's New in Extra Clang Tools 4.0.0? +====================================== Some of the major new features and improvements to Extra Clang Tools are listed here. Generic improvements to Extra Clang Tools as a whole or to its underlying @@ -44,8 +44,7 @@ infrastructure are described first, followed by tool-specific sections. Major New Features ------------------ -- :program:`clang-include-fixer`, a tool that provides an automated way of - adding ``#include`` directives for missing symbols in one translation unit. +... Improvements to clang-query --------------------------- @@ -60,343 +59,12 @@ The improvements are... Improvements to clang-tidy -------------------------- -:program:`clang-tidy`'s checks are constantly being improved to catch more issues, -explain them more clearly, and provide more accurate fix-its for the issues -identified. The improvements since the 3.8 release include: +... -- New Boost module containing checks for issues with Boost library. - -- New `boost-use-to-string - `_ check - - Finds usages of ``boost::lexical_cast`` and changes it to - ``std::to_string``. - -- New `cert-env33-c - `_ check - - Flags calls to ``system()``, ``popen()``, and ``_popen()``, which execute a - command processor. - -- New `cert-err34-c - `_ check - - Flags calls to string-to-number conversion functions that do not verify the - validity of the conversion. - -- New `cert-flp30-c - `_ check - - Flags ``for`` loops where the induction expression has a floating-point type. - -- New `cppcoreguidelines-interfaces-global-init - `_ check - - Flags initializers of globals that access extern objects, and therefore can - lead to order-of-initialization problems. - -- New `cppcoreguidelines-pro-type-member-init - `_ check - - Flags user-defined constructor definitions that do not initialize all builtin - and pointer fields which leaves their memory in an undefined state. - -- New `google-default-arguments - `_ check - - Flags default arguments in virtual methods. - -- New `misc-dangling-handle - `_ check - - Detects dangling references in value handlers like - ``std::experimental::string_view``. - -- New `misc-fold-init-type - `_ check - - The check flags type mismatches in `folds` like ``std::accumulate`` that might - result in loss of precision. - -- New `misc-forward-declaration-namespace - `_ check - - Checks if an unused forward declaration is in a wrong namespace. - -- New `misc-misplaced-const - `_ check - - Checks if a ``const`` qualifier is applied to a ``typedef`` to pointer type - instead of the underlying pointee type. - -- New `misc-misplaced-widening-cast - `_ check - - Warns when there is a explicit redundant cast of a calculation result to a - bigger type. - -- New `misc-multiple-statement-macro - `_ check - - Detect multiple statement macros that are used in unbraced conditionals. - -- New `misc-pointer-and-integral-operation - `_ check - - Warns about suspicious operations involving pointers and integral types. - -- New `misc-redundant-expression - `_ check - - Warns about redundant and equivalent expressions. - -- New `misc-sizeof-expression - `_ check - - Warns about incorrect uses of ``sizeof`` operator. - -- New `misc-string-constructor - `_ check - - Finds string constructors that are suspicious and probably errors. - -- New `misc-string-literal-with-embedded-nul - `_ check - - Warns about suspicious NUL character in string literals which may lead to - truncation or invalid character escaping. - -- New `misc-suspicious-missing-comma - `_ check - - Warns about 'probably' missing comma in string literals initializer list. - -- New `misc-suspicious-semicolon - `_ check - - Finds most instances of stray semicolons that unexpectedly alter the meaning - of the code. - -- New `misc-suspicious-string-compare - `_ check - - Find suspicious usage of runtime string comparison functions. - -- New `misc-unconventional-assign-operator - `_ - check replacing the *misc-assign-operator-signature* check. - - Does not only checks for correct signature but also for correct ``return`` - statements (returning ``*this``) - -- New `misc-unused-using-decls - `_ check - - Finds unused ``using`` declarations. - -- New `modernize-avoid-bind - `_ check - - Finds uses of ``std::bind`` and replaces simple uses with lambdas. - -- New `modernize-deprecated-headers - `_ check - - Replaces C standard library headers with their C++ alternatives. - -- New `modernize-make-shared - `_ check - - Replaces creation of ``std::shared_ptr`` from new expression with call to ``std::make_shared``. - -- New `modernize-raw-string-literal - `_ check - - Selectively replaces string literals containing escaped characters with raw - string literals. - -- New `modernize-use-bool-literals - `_ check - - Finds integer literals which are cast to ``bool``. - -- New `modernize-use-emplace - `_ check - - Finds calls that could be changed to emplace. - -- New `modernize-use-using - `_ check - - Finds typedefs and replaces it with usings. - -- New `performance-faster-string-find - `_ check - - Optimize calls to ``std::string::find()`` and friends when the needle passed - is a single character string literal. - -- New `performance-implicit-cast-in-loop - `_ check - - Warns about range-based loop with a loop variable of const ref type where the - type of the variable does not match the one returned by the iterator. - -- New `performance-unnecessary-value-param - `_ check - - Flags value parameter declarations of expensive to copy types that are copied - for each invocation but it would suffice to pass them by const reference. - -- New `readability-avoid-const-params-in-decls - `_ check - - Warns about top-level const parameters in function declarations. - -- New `readability-deleted-default - `_ check - - Warns about defaulted constructors and assignment operators that are actually - deleted. - -- Updated `readability-identifier-naming-check - `_ - - Added support for enforcing the case of macro statements. - -- New `readability-redundant-control-flow - `_ check - - Looks for procedures (functions returning no value) with ``return`` statements - at the end of the function. Such `return` statements are redundant. - -- New `readability-redundant-string-init - `_ check - - Finds unnecessary string initializations. - -- New `readability-static-definition-in-anonymous-namespace - `_ check - - Finds static function and variable definitions in anonymous namespace. - -Fixed bugs: - -- Crash when running on compile database with relative source files paths. - -- Crash when running with the `-fdelayed-template-parsing` flag. - -- The `modernize-use-override` check: incorrect fix-its placement around - ``__declspec`` and other attributes. - -Clang-tidy changes from 3.7 to 3.8 +Clang-tidy changes from 3.9 to 4.0 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -The 3.8 release didn't include release notes for :program:`clang-tidy`. In the -3.8 release many new checks have been added to :program:`clang-tidy`: - -- Checks enforcing certain rules of the `CERT Secure Coding Standards - `_: - - * `cert-dcl03-c - `_ - (an alias to the pre-existing check `misc-static-assert - `_) - * `cert-dcl50-cpp - `_ - * `cert-err52-cpp - `_ - * `cert-err58-cpp - `_ - * `cert-err60-cpp - `_ - * `cert-err61-cpp - `_ - * `cert-fio38-c - `_ - (an alias to the pre-existing check `misc-non-copyable-objects - `_) - * `cert-oop11-cpp - `_ - (an alias to the pre-existing check `misc-move-constructor-init - `_) - -- Checks supporting the `C++ Core Guidelines - `_: - - * `cppcoreguidelines-pro-bounds-array-to-pointer-decay - `_ - * `cppcoreguidelines-pro-bounds-constant-array-index - `_ - * `cppcoreguidelines-pro-bounds-pointer-arithmetic - `_ - * `cppcoreguidelines-pro-type-const-cast - `_ - * `cppcoreguidelines-pro-type-cstyle-cast - `_ - * `cppcoreguidelines-pro-type-reinterpret-cast - `_ - * `cppcoreguidelines-pro-type-static-cast-downcast - `_ - * `cppcoreguidelines-pro-type-union-access - `_ - * `cppcoreguidelines-pro-type-vararg - `_ - -- The functionality of the :program:`clang-modernize` tool has been moved to the - new ``modernize`` module in :program:`clang-tidy` along with a few new checks: - - * `modernize-loop-convert - `_ - * `modernize-make-unique - `_ - * `modernize-pass-by-value - `_ - * `modernize-redundant-void-arg - `_ - * `modernize-replace-auto-ptr - `_ - * `modernize-shrink-to-fit - `_ - (renamed from ``readability-shrink-to-fit``) - * `modernize-use-auto - `_ - * `modernize-use-default - `_ - * `modernize-use-nullptr - `_ - * `modernize-use-override - `_ - (renamed from ``misc-use-override``) - -- New checks flagging various readability-related issues: - - * `readability-identifier-naming - `_ - * `readability-implicit-bool-cast - `_ - * `readability-inconsistent-declaration-parameter-name - `_ - * `readability-uniqueptr-delete-release - `_ - -- Updated ``cppcoreguidelines-pro-member-type-member-init`` check - - This check now conforms to C++ Core Guidelines rule Type.6: Always Initialize - a Member Variable. The check examines every record type where construction - might result in an undefined memory state. These record types needing - initialization have at least one default-initialized built-in, pointer, - array or record type matching these criteria or a default-initialized - direct base class of this kind. - - The check has two complementary aspects: - - 1. Ensure every constructor for a record type needing initialization - value-initializes all members and direct bases via a combination of - in-class initializers and the member initializer list. - 2. Value-initialize every non-member instance of a record type needing - initialization that lacks a user-provided default constructor, e.g. - a POD. +... Improvements to modularize -------------------------- -- 2.7.4