xref: /freebsd/contrib/llvm-project/lld/docs/ReleaseNotes.rst (revision 81ad626541db97eb356e2c1d4a20eb2a26a766ab)
11fd87a68SDimitry Andric===========================
21fd87a68SDimitry Andriclld |release| Release Notes
31fd87a68SDimitry Andric===========================
40b57cec5SDimitry Andric
50b57cec5SDimitry Andric.. contents::
60b57cec5SDimitry Andric    :local:
70b57cec5SDimitry Andric
81fd87a68SDimitry Andric.. only:: PreRelease
91fd87a68SDimitry Andric
10e8d8bef9SDimitry Andric  .. warning::
111fd87a68SDimitry Andric     These are in-progress notes for the upcoming LLVM |release| release.
12e8d8bef9SDimitry Andric     Release notes for previous releases can be found on
13e8d8bef9SDimitry Andric     `the Download Page <https://releases.llvm.org/download.html>`_.
14e8d8bef9SDimitry Andric
150b57cec5SDimitry AndricIntroduction
160b57cec5SDimitry Andric============
170b57cec5SDimitry Andric
181fd87a68SDimitry AndricThis document contains the release notes for the lld linker, release |release|.
1985868e8aSDimitry AndricHere we describe the status of lld, including major improvements
2085868e8aSDimitry Andricfrom the previous release. All lld releases may be downloaded
2185868e8aSDimitry Andricfrom the `LLVM releases web site <https://llvm.org/releases/>`_.
220b57cec5SDimitry Andric
230b57cec5SDimitry AndricNon-comprehensive list of changes in this release
240b57cec5SDimitry Andric=================================================
250b57cec5SDimitry Andric
260b57cec5SDimitry AndricELF Improvements
270b57cec5SDimitry Andric----------------
280b57cec5SDimitry Andric
29*81ad6265SDimitry Andric* ``-z pack-relative-relocs`` is now available to support ``DT_RELR`` for glibc 2.36+.
30*81ad6265SDimitry Andric  (`D120701 <https://reviews.llvm.org/D120701>`_)
31*81ad6265SDimitry Andric* ``--no-fortran-common`` (pre 12.0.0 behavior) is now the default.
3213138422SDimitry Andric
338c27c554SDimitry AndricBreaking changes
348c27c554SDimitry Andric----------------
3513138422SDimitry Andric
36*81ad6265SDimitry Andric* The GNU ld incompatible ``--no-define-common`` has been removed.
37*81ad6265SDimitry Andric* The obscure ``-dc``/``-dp`` options have been removed.
38*81ad6265SDimitry Andric* ``-d`` is now ignored.
39*81ad6265SDimitry Andric* 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*81ad6265SDimitry Andric  (`D120626 <https://reviews.llvm.org/D120626>`_)
41*81ad6265SDimitry Andric* Support for the legacy ``.zdebug`` format has been removed. Run
42*81ad6265SDimitry Andric  ``objcopy --decompress-debug-sections`` in case old object files use ``.zdebug``.
43*81ad6265SDimitry Andric  (`D126793 <https://reviews.llvm.org/D126793>`_)
44*81ad6265SDimitry Andric* ``--time-trace-file=<file>`` has been removed.
45*81ad6265SDimitry Andric  Use ``--time-trace=<file>`` instead.
46*81ad6265SDimitry Andric  (`D128451 <https://reviews.llvm.org/D128451>`_)
470b57cec5SDimitry Andric
485ffd83dbSDimitry AndricCOFF Improvements
495ffd83dbSDimitry Andric-----------------
505ffd83dbSDimitry Andric
51*81ad6265SDimitry Andric* Added autodetection of MSVC toolchain, a la clang-cl.  Also added
52*81ad6265SDimitry Andric  ``/winsysroot:`` support for explicit specification of MSVC toolchain
53*81ad6265SDimitry Andric  location, similar to clang-cl's ``/winsysroot``. For now,
54*81ad6265SDimitry Andric  ``/winsysroot:`` requires also passing in an explicit ``/machine:`` flag.
55*81ad6265SDimitry Andric  (`D118070 <https://reviews.llvm.org/D118070>`_)
56*81ad6265SDimitry Andric* ...
570b57cec5SDimitry Andric
580b57cec5SDimitry AndricMinGW Improvements
590b57cec5SDimitry Andric------------------
600b57cec5SDimitry Andric
61*81ad6265SDimitry Andric* ...
62e8d8bef9SDimitry Andric
63*81ad6265SDimitry AndricMachO Improvements
64*81ad6265SDimitry Andric------------------
65e8d8bef9SDimitry Andric
66*81ad6265SDimitry Andric* Item 1.
67e8d8bef9SDimitry Andric
68e8d8bef9SDimitry AndricWebAssembly Improvements
69e8d8bef9SDimitry Andric------------------------
70e8d8bef9SDimitry Andric
71