Bump the trunk version to 10.0.0svn

===================================================

Extra Clang Tools 9.0.0 (In-Progress) Release Notes

===================================================

====================================================

Extra Clang Tools 10.0.0 (In-Progress) Release Notes

====================================================

.. contents::

   :local:

.. warning::

   These are in-progress notes for the upcoming Extra Clang Tools 9 release.

   These are in-progress notes for the upcoming Extra Clang Tools 10 release.

   Release notes for previous releases can be found on

   `the Download Page <https://releases.llvm.org/download.html>`_.

============

This document contains the release notes for the Extra Clang Tools, part of the

Clang release 9.0.0. Here we describe the status of the Extra Clang Tools in

Clang release 10.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. All LLVM releases may be downloaded from the `LLVM releases web

site <https://llvm.org/releases/>`_.

the current one. To see the release notes for a specific release, please

see the `releases page <https://llvm.org/releases/>`_.

What's New in Extra Clang Tools 9.0.0?

======================================

What's New in Extra Clang Tools 10.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

Improvements to clang-tidy

--------------------------

- New OpenMP module.

  For checks specific to `OpenMP <https://www.openmp.org/>`_ API.

- New :doc:`abseil-duration-addition

  <clang-tidy/checks/abseil-duration-addition>` check.

  Checks for cases where addition should be performed in the ``absl::Time``

  domain.

- New :doc:`abseil-duration-conversion-cast

  <clang-tidy/checks/abseil-duration-conversion-cast>` check.

  Checks for casts of ``absl::Duration`` conversion functions, and recommends

  the right conversion function instead.

- New :doc:`abseil-duration-unnecessary-conversion

  <clang-tidy/checks/abseil-duration-unnecessary-conversion>` check.

  Finds and fixes cases where ``absl::Duration`` values are being converted to

  numeric types and back again.

- New :doc:`abseil-time-comparison

  <clang-tidy/checks/abseil-time-comparison>` check.

  Prefer comparisons in the ``absl::Time`` domain instead of the integer

  domain.

- New :doc:`abseil-time-subtraction

  <clang-tidy/checks/abseil-time-subtraction>` check.

  Finds and fixes ``absl::Time`` subtraction expressions to do subtraction

  in the Time domain instead of the numeric domain.

- New :doc:`android-cloexec-pipe

  <clang-tidy/checks/android-cloexec-pipe>` check.

  This check detects usage of ``pipe()``.

- New :doc:`android-cloexec-pipe2

  <clang-tidy/checks/android-cloexec-pipe2>` check.

  This checks ensures that ``pipe2()`` is called with the ``O_CLOEXEC`` flag.

- New :doc:`bugprone-branch-clone

  <clang-tidy/checks/bugprone-branch-clone>` check.

  Checks for repeated branches in ``if/else if/else`` chains, consecutive

  repeated branches in ``switch`` statements and indentical true and false

  branches in conditional operators.

- New :doc:`bugprone-posix-return

  <clang-tidy/checks/bugprone-posix-return>` check.

  Checks if any calls to POSIX functions (except ``posix_openpt``) expect negative

  return values.

- New :doc:`bugprone-unhandled-self-assignment

  <clang-tidy/checks/bugprone-unhandled-self-assignment>` check.

  Finds user-defined copy assignment operators which do not protect the code

  against self-assignment either by checking self-assignment explicitly or

  using the copy-and-swap or the copy-and-move method.

- New :doc:`fuchsia-default-arguments-calls

  <clang-tidy/checks/fuchsia-default-arguments-calls>` check.

  Warns if a function or method is called with default arguments.

  This was previously done by `fuchsia-default-arguments check`, which has been

  removed.

- New :doc:`fuchsia-default-arguments-declarations

  <clang-tidy/checks/fuchsia-default-arguments-declarations>` check.

  Warns if a function or method is declared with default parameters.

  This was previously done by `fuchsia-default-arguments check` check, which has

  been removed.

- New :doc:`google-objc-avoid-nsobject-new

  <clang-tidy/checks/google-objc-avoid-nsobject-new>` check.

  Checks for calls to ``+new`` or overrides of it, which are prohibited by the

  Google Objective-C style guide.

- New :doc:`google-readability-avoid-underscore-in-googletest-name

  <clang-tidy/checks/google-readability-avoid-underscore-in-googletest-name>`

  check.

  Checks whether there are underscores in googletest test and test case names in

  test macros, which is prohibited by the Googletest FAQ.

- New :doc:`llvm-prefer-isa-or-dyn-cast-in-conditionals

  <clang-tidy/checks/llvm-prefer-isa-or-dyn-cast-in-conditionals>` check.

  Looks at conditionals and finds and replaces cases of ``cast<>``,

  which will assert rather than return a null pointer, and

  ``dyn_cast<>`` where the return value is not captured. Additionally,

  finds and replaces cases that match the pattern ``var &&

  isa<X>(var)``, where ``var`` is evaluated twice.

- New :doc:`modernize-use-trailing-return-type

  <clang-tidy/checks/modernize-use-trailing-return-type>` check.

  Rewrites function signatures to use a trailing return type.

- New :doc:`objc-super-self <clang-tidy/checks/objc-super-self>` check.

  Finds invocations of ``-self`` on super instances in initializers of

  subclasses of ``NSObject`` and recommends calling a superclass initializer

  instead.

- New :doc:`openmp-exception-escape

  <clang-tidy/checks/openmp-exception-escape>` check.

  Analyzes OpenMP Structured Blocks and checks that no exception escapes

  out of the Structured Block it was thrown in.

- New :doc:`openmp-use-default-none

  <clang-tidy/checks/openmp-use-default-none>` check.

  Finds OpenMP directives that are allowed to contain a ``default`` clause,

  but either don't specify it or the clause is specified but with the kind

  other than ``none``, and suggests to use the ``default(none)`` clause.

- New :doc:`readability-convert-member-functions-to-static

  <clang-tidy/checks/readability-convert-member-functions-to-static>` check.

  Finds non-static member functions that can be made ``static``.

- New alias :doc:`cert-oop54-cpp

  <clang-tidy/checks/cert-oop54-cpp>` to

  :doc:`bugprone-unhandled-self-assignment

  <clang-tidy/checks/bugprone-unhandled-self-assignment>` was added.

- New alias :doc:`cppcoreguidelines-explicit-virtual-functions

  <clang-tidy/checks/cppcoreguidelines-explicit-virtual-functions>` to

  :doc:`modernize-use-override

  <clang-tidy/checks/modernize-use-override>` was added.

- The :doc:`bugprone-argument-comment

  <clang-tidy/checks/bugprone-argument-comment>` now supports

  `CommentBoolLiterals`, `CommentIntegerLiterals`, `CommentFloatLiterals`,

  `CommentUserDefiniedLiterals`, `CommentStringLiterals`,

  `CommentCharacterLiterals` & `CommentNullPtrs` options.

- The :doc:`bugprone-too-small-loop-variable

  <clang-tidy/checks/bugprone-too-small-loop-variable>` now supports

  `MagnitudeBitsUpperLimit` option. The default value was set to 16,

  which greatly reduces warnings related to loops which are unlikely to

  cause an actual functional bug.

- Added `UseAssignment` option to :doc:`cppcoreguidelines-pro-type-member-init

  <clang-tidy/checks/cppcoreguidelines-pro-type-member-init>`

  If set to true, the check will provide fix-its with literal initializers

  (``int i = 0;``) instead of curly braces (``int i{};``).

- The `fuchsia-default-arguments` check has been removed.

  Warnings of function or method calls and declarations with default arguments

  were moved to :doc:`fuchsia-default-arguments-calls

  <clang-tidy/checks/fuchsia-default-arguments-calls>` and

  :doc:`fuchsia-default-arguments-declarations

  <clang-tidy/checks/fuchsia-default-arguments-declarations>` checks

  respectively.

- The :doc:`google-runtime-int <clang-tidy/checks/google-runtime-int>`

  check has been disabled in Objective-C++.

- The :doc:`modernize-use-override

  <clang-tidy/checks/modernize-use-override>` now supports `OverrideSpelling`

  and `FinalSpelling` options.

- The :doc:`misc-throw-by-value-catch-by-reference

  <clang-tidy/checks/misc-throw-by-value-catch-by-reference>` now supports

  `WarnOnLargeObject` and `MaxSize` options to warn on any large trivial

  object caught by value.

- The `Acronyms` and `IncludeDefaultAcronyms` options for the

  :doc:`objc-property-declaration <clang-tidy/checks/objc-property-declaration>`

  check have been removed.

The improvements are...

Improvements to include-fixer

-----------------------------

Improvements to pp-trace

------------------------

- Added a new option `-callbacks` to filter preprocessor callbacks. It replaces

  the `-ignore` option.

The improvements are...

# built documents.

#

# The short version.

version = '9'

version = '10'

# The full version, including alpha/beta/rc tags.

release = '9'

release = '10'

# The language for content autogenerated by Sphinx. Refer to documentation

# for a list of supported languages.

=======================================

Clang 9.0.0 (In-Progress) Release Notes

=======================================

========================================

Clang 10.0.0 (In-Progress) Release Notes

========================================

.. contents::

   :local:

.. warning::

   These are in-progress notes for the upcoming Clang 9 release.

   These are in-progress notes for the upcoming Clang 10 release.

   Release notes for previous releases can be found on

   `the Download Page <https://releases.llvm.org/download.html>`_.

============

This document contains the release notes for the Clang C/C++/Objective-C

frontend, part of the LLVM Compiler Infrastructure, release 9.0.0. Here we

frontend, part of the LLVM Compiler Infrastructure, release 10.0.0. Here we

describe the status of Clang in some detail, including major

improvements from the previous release and new feature work. For the

general LLVM release notes, see `the LLVM

the current one. To see the release notes for a specific release, please

see the `releases page <https://llvm.org/releases/>`_.

What's New in Clang 9.0.0?

==========================

What's New in Clang 10.0.0?

===========================

Some of the major new features and improvements to Clang are listed

here. Generic improvements to Clang as a whole or to its underlying

Non-comprehensive list of changes in this release

-------------------------------------------------

- The ``__VERSION__`` macro has been updated.

  Previously this macro contained the string '4.2.1 Compatible' to achieve

  compatibility with GCC 4.2.1, but that should no longer be necessary.

  However, to retrieve Clang's version, please favor the one of the macro

  defined in :ref:`clang namespaced version macros <languageextensions-builtin-macros>`.

- ...

Modified Compiler Flags

-----------------------

- ``clang -dumpversion`` now returns the version of Clang itself.

- ...

New Pragmas in Clang

Windows Support

---------------

- clang-cl now treats non-existent files as possible typos for flags,

  ``clang-cl /diagnostic:caret /c test.cc`` for example now produces

  ``clang: error: no such file or directory: '/diagnostic:caret'; did you mean '/diagnostics:caret'?``

- ...

C Language Changes in Clang

---------------------------

- ``__FILE_NAME__`` macro has been added as a Clang specific extension supported

  in all C-family languages. This macro is similar to ``__FILE__`` except it

  will always provide the last path component when possible.

- ...

C11 Feature Support

Objective-C Language Changes in Clang

-------------------------------------

- Fixed encoding of ObjC pointer types that are pointers to typedefs.

.. code-block:: objc

      typedef NSArray<NSObject *> MyArray;

      // clang used to encode this as "^{NSArray=#}" instead of "@".

      const char *s0 = @encode(MyArray *);

- ...

OpenCL C Language Changes in Clang

----------------------------------

OpenMP Support in Clang

-----------------------

- Added emission of the debug information for NVPTX target devices.

- ...

CUDA Support in Clang

---------------------

- Added emission of the debug information for the device code.

- ...

Internal API Changes

--------------------

These are major API changes that have happened since the 8.0.0 release of

These are major API changes that have happened since the 9.0.0 release of

Clang. If upgrading an external codebase that uses Clang as a library,

this section should help get you past the largest hurdles of upgrading.

Build System Changes

--------------------

These are major changes to the build system that have happened since the 8.0.0

These are major changes to the build system that have happened since the 9.0.0

release of Clang. Users of the build system should adjust accordingly.

- In 8.0.0 and below, the install-clang-headers target would install clang's

clang-format

------------

- Add language support for clang-formatting C# files.

- Add Microsoft coding style to encapsulate default C# formatting style.

- Added new option `PPDIS_BeforeHash` (in configuration: `BeforeHash`) to

  `IndentPPDirectives` which indents preprocessor directives before the hash.

- Added new option `AlignConsecutiveMacros` to align the C/C++ preprocessor

  macros of consecutive lines.

- ...

libclang

--------

- When `CINDEXTEST_INCLUDE_ATTRIBUTED_TYPES` is not provided when making a

  CXType, the equivalent type of the AttributedType is returned instead of the

  modified type if the user does not want attribute sugar. The equivalent type

  represents the minimally-desugared type which the AttributedType is

  canonically equivalent to.

- ...

Static Analyzer

---------------

- The UninitializedObject checker is now considered as stable.

  (moved from the 'alpha.cplusplus' to the 'optin.cplusplus' package)

...

- ...

.. _release-notes-ubsan:

# built documents.

#

# The short version.

version = '9'

version = '10'

# The full version, including alpha/beta/rc tags.

release = '9'

release = '10'

# The language for content autogenerated by Sphinx. Refer to documentation

# for a list of supported languages.

  project(libcxx CXX C)

  set(PACKAGE_NAME libcxx)

  set(PACKAGE_VERSION 9.0.0svn)

  set(PACKAGE_VERSION 10.0.0svn)

  set(PACKAGE_STRING "${PACKAGE_NAME} ${PACKAGE_VERSION}")

  set(PACKAGE_BUGREPORT "llvm-bugs@lists.llvm.org")