tejohnson created this revision. tejohnson added a reviewer: hans. Herald added subscribers: dexonsmith, inglorion. Herald added a reviewer: MaskRay. Herald added projects: clang, LLVM. tejohnson requested review of this revision.
This adds documentation for the options added / changed by D71913 <https://reviews.llvm.org/D71913>, which enabled aggressive WPD under LTO. The lld release notes already mentioned it, but I expanded the note. Repository: rG LLVM Github Monorepo https://reviews.llvm.org/D86958 Files: clang/docs/ReleaseNotes.rst lld/docs/ReleaseNotes.rst llvm/docs/ReleaseNotes.rst Index: llvm/docs/ReleaseNotes.rst =================================================================== --- llvm/docs/ReleaseNotes.rst +++ llvm/docs/ReleaseNotes.rst @@ -267,6 +267,12 @@ passed to the callee. The feature improves the debugging user experience when debugging optimized code. +Changes to the Gold Plugin +-------------------------- + +* ``whole-program-visibility`` is added to specify that classes have hidden LTO visibility in LTO and ThinLTO links of source files compiled with -fwhole-program-vtables. See `LTOVisibility <https://clang.llvm.org/docs/LTOVisibility.html>`_ for details. + (`D71913 <https://reviews.llvm.org/D71913>`_) + Changes to the LLVM tools --------------------------------- Index: lld/docs/ReleaseNotes.rst =================================================================== --- lld/docs/ReleaseNotes.rst +++ lld/docs/ReleaseNotes.rst @@ -26,7 +26,7 @@ * ``--lto-emit-asm`` is added to emit assembly output for debugging purposes. (`D77231 <https://reviews.llvm.org/D77231>`_) -* ``--lto-whole-program-visibility`` is added to support LTO whole-program devirtualization. +* ``--lto-whole-program-visibility`` is added to specify that classes have hidden LTO visibility in LTO and ThinLTO links of source files compiled with -fwhole-program-vtables. See `LTOVisibility <https://clang.llvm.org/docs/LTOVisibility.html>`_ for details. (`D71913 <https://reviews.llvm.org/D71913>`_) * ``--print-archive-stats=`` is added to print the number of members and the number of fetched members for each archive. The feature is similar to GNU gold's ``--print-symbol-counts=``. Index: clang/docs/ReleaseNotes.rst =================================================================== --- clang/docs/ReleaseNotes.rst +++ clang/docs/ReleaseNotes.rst @@ -296,6 +296,8 @@ ``char8_t`` as the character type of ``u8`` literals. This restores the Clang 8 behavior that regressed in Clang 9 and 10. - -print-targets has been added to print the registered targets. +- ``-fwhole-program-vtables`` (along with ``-flto*``) now prepares all classes for possible whole program visibility if specified during the LTO link. + (`D71913 <https://reviews.llvm.org/D71913>`_) New Pragmas in Clang --------------------
Index: llvm/docs/ReleaseNotes.rst =================================================================== --- llvm/docs/ReleaseNotes.rst +++ llvm/docs/ReleaseNotes.rst @@ -267,6 +267,12 @@ passed to the callee. The feature improves the debugging user experience when debugging optimized code. +Changes to the Gold Plugin +-------------------------- + +* ``whole-program-visibility`` is added to specify that classes have hidden LTO visibility in LTO and ThinLTO links of source files compiled with -fwhole-program-vtables. See `LTOVisibility <https://clang.llvm.org/docs/LTOVisibility.html>`_ for details. + (`D71913 <https://reviews.llvm.org/D71913>`_) + Changes to the LLVM tools --------------------------------- Index: lld/docs/ReleaseNotes.rst =================================================================== --- lld/docs/ReleaseNotes.rst +++ lld/docs/ReleaseNotes.rst @@ -26,7 +26,7 @@ * ``--lto-emit-asm`` is added to emit assembly output for debugging purposes. (`D77231 <https://reviews.llvm.org/D77231>`_) -* ``--lto-whole-program-visibility`` is added to support LTO whole-program devirtualization. +* ``--lto-whole-program-visibility`` is added to specify that classes have hidden LTO visibility in LTO and ThinLTO links of source files compiled with -fwhole-program-vtables. See `LTOVisibility <https://clang.llvm.org/docs/LTOVisibility.html>`_ for details. (`D71913 <https://reviews.llvm.org/D71913>`_) * ``--print-archive-stats=`` is added to print the number of members and the number of fetched members for each archive. The feature is similar to GNU gold's ``--print-symbol-counts=``. Index: clang/docs/ReleaseNotes.rst =================================================================== --- clang/docs/ReleaseNotes.rst +++ clang/docs/ReleaseNotes.rst @@ -296,6 +296,8 @@ ``char8_t`` as the character type of ``u8`` literals. This restores the Clang 8 behavior that regressed in Clang 9 and 10. - -print-targets has been added to print the registered targets. +- ``-fwhole-program-vtables`` (along with ``-flto*``) now prepares all classes for possible whole program visibility if specified during the LTO link. + (`D71913 <https://reviews.llvm.org/D71913>`_) New Pragmas in Clang --------------------
_______________________________________________ cfe-commits mailing list cfe-commits@lists.llvm.org https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
