1===========================
2lld |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
15Introduction
16============
17
18This document contains the release notes for the lld linker, release |release|.
19Here we describe the status of lld, including major improvements
20from the previous release. All lld releases may be downloaded
21from the `LLVM releases web site <https://llvm.org/releases/>`_.
22
23Non-comprehensive list of changes in this release
24=================================================
25
26ELF Improvements
27----------------
28
29* ``-z pack-relative-relocs`` is now available to support ``DT_RELR`` for glibc 2.36+.
30  (`D120701 <https://reviews.llvm.org/D120701>`_)
31* ``--no-fortran-common`` (pre 12.0.0 behavior) is now the default.
32
33Breaking changes
34----------------
35
36* The GNU ld incompatible ``--no-define-common`` has been removed.
37* The obscure ``-dc``/``-dp`` options have been removed.
38* ``-d`` is now ignored.
39* If a prevailing COMDAT group defines STB_WEAK symbol, having a STB_GLOBAL symbol in a non-prevailing group is now rejected with a diagnostic.
40  (`D120626 <https://reviews.llvm.org/D120626>`_)
41* Support for the legacy ``.zdebug`` format has been removed. Run
42  ``objcopy --decompress-debug-sections`` in case old object files use ``.zdebug``.
43  (`D126793 <https://reviews.llvm.org/D126793>`_)
44* ``--time-trace-file=<file>`` has been removed.
45  Use ``--time-trace=<file>`` instead.
46  (`D128451 <https://reviews.llvm.org/D128451>`_)
47
48COFF Improvements
49-----------------
50
51* Added autodetection of MSVC toolchain, a la clang-cl.  Also added
52  ``/winsysroot:`` support for explicit specification of MSVC toolchain
53  location, similar to clang-cl's ``/winsysroot``. For now,
54  ``/winsysroot:`` requires also passing in an explicit ``/machine:`` flag.
55  (`D118070 <https://reviews.llvm.org/D118070>`_)
56* ...
57
58MinGW Improvements
59------------------
60
61* ...
62
63MachO Improvements
64------------------
65
66* Item 1.
67
68WebAssembly Improvements
69------------------------
70
71