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
42COFF Improvements
43-----------------
44
45* Added autodetection of MSVC toolchain, a la clang-cl.  Also added
46  ``/winsysroot:`` support for explicit specification of MSVC toolchain
47  location, similar to clang-cl's ``/winsysroot``. For now,
48  ``/winsysroot:`` requires also passing in an explicit ``/machine:`` flag.
49  (`D118070 <https://reviews.llvm.org/D118070>`_)
50* ...
51
52MinGW Improvements
53------------------
54
55* ...
56
57MachO Improvements
58------------------
59
60* Item 1.
61
62WebAssembly Improvements
63------------------------
64
65