2016-07-19 02:08:59 +08:00
|
|
|
===================================================
|
2017-07-19 22:15:27 +08:00
|
|
|
Extra Clang Tools 6.0.0 (In-Progress) Release Notes
|
2016-07-19 02:08:59 +08:00
|
|
|
===================================================
|
2016-03-27 13:06:57 +08:00
|
|
|
|
|
|
|
.. contents::
|
|
|
|
:local:
|
2016-03-30 20:05:33 +08:00
|
|
|
:depth: 3
|
2016-03-27 13:06:57 +08:00
|
|
|
|
|
|
|
Written by the `LLVM Team <http://llvm.org/>`_
|
|
|
|
|
|
|
|
.. warning::
|
|
|
|
|
2017-07-19 22:15:27 +08:00
|
|
|
These are in-progress notes for the upcoming Extra Clang Tools 6 release.
|
2017-02-10 07:25:52 +08:00
|
|
|
Release notes for previous releases can be found on
|
|
|
|
`the Download Page <http://releases.llvm.org/download.html>`_.
|
2016-03-27 13:06:57 +08:00
|
|
|
|
|
|
|
Introduction
|
|
|
|
============
|
|
|
|
|
|
|
|
This document contains the release notes for the Extra Clang Tools, part of the
|
2017-07-19 22:15:27 +08:00
|
|
|
Clang release 6.0.0. Here we describe the status of the Extra Clang Tools in
|
2016-09-07 01:52:44 +08:00
|
|
|
some detail, including major improvements from the previous release and new
|
|
|
|
feature work. All LLVM releases may be downloaded from the `LLVM releases web
|
2016-03-27 13:06:57 +08:00
|
|
|
site <http://llvm.org/releases/>`_.
|
|
|
|
|
|
|
|
For more information about Clang or LLVM, including information about
|
|
|
|
the latest release, please see the `Clang Web Site <http://clang.llvm.org>`_ or
|
|
|
|
the `LLVM Web Site <http://llvm.org>`_.
|
|
|
|
|
|
|
|
Note that if you are reading this file from a Subversion checkout or the
|
|
|
|
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 <http://llvm.org/releases/>`_.
|
|
|
|
|
2017-07-19 22:15:27 +08:00
|
|
|
What's New in Extra Clang Tools 6.0.0?
|
2016-07-19 02:08:59 +08:00
|
|
|
======================================
|
2016-03-27 13:06:57 +08:00
|
|
|
|
|
|
|
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
|
|
|
|
infrastructure are described first, followed by tool-specific sections.
|
|
|
|
|
|
|
|
Major New Features
|
|
|
|
------------------
|
|
|
|
|
2016-07-19 02:08:59 +08:00
|
|
|
...
|
2016-03-27 13:06:57 +08:00
|
|
|
|
2016-03-30 20:05:33 +08:00
|
|
|
Improvements to clang-query
|
|
|
|
---------------------------
|
2016-03-27 13:06:57 +08:00
|
|
|
|
|
|
|
The improvements are...
|
|
|
|
|
2016-03-30 20:05:33 +08:00
|
|
|
Improvements to clang-rename
|
|
|
|
----------------------------
|
2016-03-27 13:06:57 +08:00
|
|
|
|
2017-01-13 05:58:40 +08:00
|
|
|
The improvements are...
|
2016-03-27 13:06:57 +08:00
|
|
|
|
2016-03-30 20:05:33 +08:00
|
|
|
Improvements to clang-tidy
|
|
|
|
--------------------------
|
2016-03-27 13:06:57 +08:00
|
|
|
|
2017-10-26 16:23:20 +08:00
|
|
|
- New module `objc` for Objective-C style checks.
|
|
|
|
|
2017-10-27 15:41:36 +08:00
|
|
|
- New `objc-forbidden-subclassing
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/objc-forbidden-subclassing.html>`_ check
|
|
|
|
|
|
|
|
Ensures Objective-C classes do not subclass any classes which are
|
2017-11-03 04:00:17 +08:00
|
|
|
not intended to be subclassed. Includes a list of classes from Foundation
|
|
|
|
and UIKit which are documented as not supporting subclassing.
|
2017-10-27 15:41:36 +08:00
|
|
|
|
2017-08-10 20:54:05 +08:00
|
|
|
- Renamed checks to use correct term "implicit conversion" instead of "implicit
|
2017-08-08 22:53:52 +08:00
|
|
|
cast" and modified messages and option names accordingly:
|
|
|
|
|
2017-08-10 20:54:05 +08:00
|
|
|
* **performance-implicit-cast-in-loop** was renamed to
|
2017-08-08 22:53:52 +08:00
|
|
|
`performance-implicit-conversion-in-loop
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/performance-implicit-conversion-in-loop.html>`_
|
2017-08-10 20:54:05 +08:00
|
|
|
* **readability-implicit-bool-cast** was renamed to
|
2017-08-08 22:53:52 +08:00
|
|
|
`readability-implicit-bool-conversion
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/readability-implicit-bool-conversion.html>`_;
|
|
|
|
the check's options were renamed as follows:
|
|
|
|
``AllowConditionalIntegerCasts`` -> ``AllowIntegerConditions``,
|
|
|
|
``AllowConditionalPointerCasts`` -> ``AllowPointerConditions``.
|
|
|
|
|
2017-08-17 01:18:16 +08:00
|
|
|
- New `android-cloexec-accept
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/android-cloexec-accept.html>`_ check
|
|
|
|
|
|
|
|
Detects usage of ``accept()``.
|
|
|
|
|
2017-08-17 01:46:18 +08:00
|
|
|
- New `android-cloexec-accept4
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/android-cloexec-accept4.html>`_ check
|
|
|
|
|
|
|
|
Checks if the required file flag ``SOCK_CLOEXEC`` is present in the argument of
|
|
|
|
``accept4()``.
|
|
|
|
|
2017-08-15 01:04:16 +08:00
|
|
|
- New `android-cloexec-dup
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/android-cloexec-dup.html>`_ check
|
|
|
|
|
|
|
|
Detects usage of ``dup()``.
|
|
|
|
|
2017-08-15 01:25:41 +08:00
|
|
|
- New `android-cloexec-inotify-init
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/android-cloexec-inotify-init.html>`_ check
|
|
|
|
|
|
|
|
Detects usage of ``inotify_init()``.
|
|
|
|
|
2017-08-17 01:53:12 +08:00
|
|
|
- New `android-cloexec-epoll-create1
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/android-cloexec-epoll-create1.html>`_ check
|
|
|
|
|
|
|
|
Checks if the required file flag ``EPOLL_CLOEXEC`` is present in the argument of
|
|
|
|
``epoll_create1()``.
|
|
|
|
|
2017-08-17 02:02:49 +08:00
|
|
|
- New `android-cloexec-epoll-create
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/android-cloexec-epoll-create.html>`_ check
|
|
|
|
|
|
|
|
Detects usage of ``epoll_create()``.
|
|
|
|
|
2017-08-11 06:09:22 +08:00
|
|
|
- New `android-cloexec-memfd_create
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/android-cloexec-memfd_create.html>`_ check
|
|
|
|
|
|
|
|
Checks if the required file flag ``MFD_CLOEXEC`` is present in the argument
|
|
|
|
of ``memfd_create()``.
|
|
|
|
|
2017-08-10 21:30:30 +08:00
|
|
|
- New `bugprone-integer-division
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/bugprone-integer-division.html>`_ check
|
|
|
|
|
|
|
|
Finds cases where integer division in a floating point context is likely to
|
|
|
|
cause unintended loss of precision.
|
|
|
|
|
2017-09-13 04:00:42 +08:00
|
|
|
- New `cppcoreguidelines-owning-memory <http://clang.llvm.org/extra/clang-tidy/checks/cppcoreguidelines-owning-memory.html>`_ check
|
|
|
|
|
|
|
|
This check implements the type-based semantic of ``gsl::owner<T*>``, but without
|
|
|
|
flow analysis.
|
|
|
|
|
2017-08-12 00:31:51 +08:00
|
|
|
- New `hicpp-exception-baseclass
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/hicpp-exception-baseclass.html>`_ check
|
|
|
|
|
|
|
|
Ensures that all exception will be instances of ``std::exception`` and classes
|
|
|
|
that are derived from it.
|
|
|
|
|
2017-08-30 21:32:05 +08:00
|
|
|
- New `hicpp-signed-bitwise
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/hicpp-signed-bitwise.html>`_ check
|
|
|
|
|
|
|
|
Finds uses of bitwise operations on signed integer types, which may lead to
|
|
|
|
undefined or implementation defined behaviour.
|
|
|
|
|
2017-08-15 01:45:48 +08:00
|
|
|
- New `android-cloexec-inotify-init1
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/android-cloexec-inotify-init1.html>`_ check
|
|
|
|
|
|
|
|
Checks if the required file flag ``IN_CLOEXEC`` is present in the argument of
|
|
|
|
``inotify_init1()``.
|
|
|
|
|
2017-08-08 23:33:48 +08:00
|
|
|
- New `readability-static-accessed-through-instance
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/readability-static-accessed-through-instance.html>`_ check
|
|
|
|
|
|
|
|
Finds member expressions that access static members through instances and
|
|
|
|
replaces them with uses of the appropriate qualified-id.
|
|
|
|
|
2017-08-10 20:54:05 +08:00
|
|
|
- Added `modernize-use-emplace.IgnoreImplicitConstructors
|
|
|
|
<http://clang.llvm.org/extra/clang-tidy/checks/modernize-use-emplace.html#cmdoption-arg-IgnoreImplicitConstructors>`_
|
|
|
|
option.
|
|
|
|
|
2017-09-11 17:20:07 +08:00
|
|
|
- Added aliases for the `High Integrity C++ Coding Standard <http://www.codingstandard.com/section/index/>`_
|
|
|
|
to already implemented checks in other modules.
|
|
|
|
|
|
|
|
- `hicpp-deprecated-headers <http://clang.llvm.org/extra/clang-tidy/checks/hicpp-deprecated-headers.html>`_
|
|
|
|
- `hicpp-move-const-arg <http://clang.llvm.org/extra/clang-tidy/checks/hicpp-move-const-arg.html>`_
|
|
|
|
- `hicpp-no-array-decay <http://clang.llvm.org/extra/clang-tidy/checks/hicpp-no-array-decay.html>`_
|
|
|
|
- `hicpp-no-malloc <http://clang.llvm.org/extra/clang-tidy/checks/hicpp-no-malloc.html>`_
|
|
|
|
- `hicpp-static-assert <http://clang.llvm.org/extra/clang-tidy/checks/hicpp-static-assert.html>`_
|
|
|
|
- `hicpp-use-auto <http://clang.llvm.org/extra/clang-tidy/checks/hicpp-use-auto.html>`_
|
|
|
|
- `hicpp-use-emplace <http://clang.llvm.org/extra/clang-tidy/checks/hicpp-use-emplace.html>`_
|
|
|
|
- `hicpp-use-noexcept <http://clang.llvm.org/extra/clang-tidy/checks/hicpp-use-noexcept.html>`_
|
|
|
|
- `hicpp-use-nullptr <http://clang.llvm.org/extra/clang-tidy/checks/hicpp-use-nullptr.html>`_
|
|
|
|
- `hicpp-vararg <http://clang.llvm.org/extra/clang-tidy/checks/hicpp-vararg.html>`_
|
2017-08-11 20:12:36 +08:00
|
|
|
|
2016-07-22 08:34:42 +08:00
|
|
|
Improvements to include-fixer
|
|
|
|
-----------------------------
|
2016-03-30 20:05:33 +08:00
|
|
|
|
2017-01-13 05:58:40 +08:00
|
|
|
The improvements are...
|
2016-03-30 20:05:33 +08:00
|
|
|
|
|
|
|
Improvements to modularize
|
|
|
|
--------------------------
|
2016-03-27 13:06:57 +08:00
|
|
|
|
|
|
|
The improvements are...
|