xref: /freebsd/contrib/llvm-project/lld/docs/ReleaseNotes.rst (revision cb14a3fe5122c879eae1fb480ed7ce82a699ddb6)
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* ``--fat-lto-objects`` option is added to support LLVM FatLTO.
30  Without ``--fat-lto-objects``, LLD will link LLVM FatLTO objects using the
31  relocatable object file. (`D146778 <https://reviews.llvm.org/D146778>`_)
32* common-page-size can now be larger than the system page-size.
33  (`#57618 <https://github.com/llvm/llvm-project/issues/57618>`_)
34
35Breaking changes
36----------------
37
38COFF Improvements
39-----------------
40
41* Added support for ``--time-trace`` and associated ``--time-trace-granularity``.
42  This generates a .json profile trace of the linker execution.
43
44MinGW Improvements
45------------------
46
47MachO Improvements
48------------------
49
50WebAssembly Improvements
51------------------------
52
53Fixes
54#####
55