lld/docs/ReleaseNotes.rst

   1 ===========================
   2 lld |release| Release Notes
   3 ===========================
   4
   5 .. contents::
   6     :local:
   7
   8 .. only:: PreRelease
   9
  10   .. warning::
  11      These are in-progress notes for the upcoming LLVM |release| release.
  12      Release notes for previous releases can be found on
  13      `the Download Page <https://releases.llvm.org/download.html>`_.
  14
  15 Introduction
  16 ============
  17
  18 This document contains the release notes for the lld linker, release |release|.
  19 Here we describe the status of lld, including major improvements
  20 from the previous release. All lld releases may be downloaded
  21 from the `LLVM releases web site <https://llvm.org/releases/>`_.
  22
  23 Non-comprehensive list of changes in this release
  24 =================================================
  25
  26 ELF Improvements
  27 ----------------
  28
  29 * ``-z nosectionheader`` has been implemented to omit the section header table.
  30   The operation is similar to ``llvm-objcopy --strip-sections``.
  31   (`#101286 <https://github.com/llvm/llvm-project/pull/101286>`_)
  32 * Section ``CLASS`` linker script syntax binds input sections to named classes,
  33   which are referenced later one or more times. This provides access to the
  34   automatic spilling mechanism of `--enable-non-contiguous-regions` without
  35   globally changing the semantics of section matching. It also independently
  36   increases the expressive power of linker scripts.
  37   (`#95323 <https://github.com/llvm/llvm-project/pull/95323>`_)
  38
  39 Breaking changes
  40 ----------------
  41
  42 COFF Improvements
  43 -----------------
  44 * ``/includeglob`` has been implemented to match the behavior of ``--undefined-glob`` available for ELF.
  45 * ``/lldsavetemps`` allows saving select intermediate LTO compilation results (e.g. resolution, preopt, promote, internalize, import, opt, precodegen, prelink, combinedindex).
  46 * ``/machine:arm64ec`` support completed, enabling the linking of ARM64EC images.
  47 * COFF weak anti-dependency alias symbols are now supported.
  48
  49 MinGW Improvements
  50 ------------------
  51 * ``--undefined-glob`` is now supported by translating into the ``/includeglob`` flag.
  52
  53 MachO Improvements
  54 ------------------
  55
  56 WebAssembly Improvements
  57 ------------------------
  58
  59 Fixes
  60 #####