| ======================== |
| LLVM 5.0.0 Release Notes |
| ======================== |
| |
| .. contents:: |
| :local: |
| |
| .. warning:: |
| These are in-progress notes for the upcoming LLVM 5 release. |
| Release notes for previous releases can be found on |
| `the Download Page <http://releases.llvm.org/download.html>`_. |
| |
| |
| Introduction |
| ============ |
| |
| This document contains the release notes for the LLVM Compiler Infrastructure, |
| release 5.0.0. Here we describe the status of LLVM, including major improvements |
| from the previous release, improvements in various subprojects of LLVM, and |
| some of the current users of the code. All LLVM releases may be downloaded |
| from the `LLVM releases web site <http://llvm.org/releases/>`_. |
| |
| For more information about LLVM, including information about the latest |
| release, please check out the `main LLVM web site <http://llvm.org/>`_. If you |
| have questions or comments, the `LLVM Developer's Mailing List |
| <http://lists.llvm.org/mailman/listinfo/llvm-dev>`_ is a good place to send |
| them. |
| |
| Non-comprehensive list of changes in this release |
| ================================================= |
| .. NOTE |
| For small 1-3 sentence descriptions, just add an entry at the end of |
| this list. If your description won't fit comfortably in one bullet |
| point (e.g. maybe you would like to give an example of the |
| functionality, or simply have a lot to talk about), see the `NOTE` below |
| for adding a new subsection. |
| |
| * LLVM's ``WeakVH`` has been renamed to ``WeakTrackingVH`` and a new ``WeakVH`` |
| has been introduced. The new ``WeakVH`` nulls itself out on deletion, but |
| does not track values across RAUW. |
| |
| * A new library named ``BinaryFormat`` has been created which holds a collection |
| of code which previously lived in ``Support``. This includes the |
| ``file_magic`` structure and ``identify_magic`` functions, as well as all the |
| structure and type definitions for DWARF, ELF, COFF, WASM, and MachO file |
| formats. |
| |
| * The tool ``llvm-pdbdump`` has been renamed ``llvm-pdbutil`` to better reflect |
| its nature as a general purpose PDB manipulation / diagnostics tool that does |
| more than just dumping contents. |
| |
| |
| * LLVM now handles invariant.group across different basic blocks, which makes |
| it possible to devirtualize virtual calls inside loops. |
| |
| * ... next change ... |
| |
| .. NOTE |
| If you would like to document a larger change, then you can add a |
| subsection about it right here. You can copy the following boilerplate |
| and un-indent it (the indentation causes it to be inside this comment). |
| |
| Special New Feature |
| ------------------- |
| |
| Makes programs 10x faster by doing Special New Thing. |
| |
| Improvements to ThinLTO (-flto=thin) |
| ------------------------------------ |
| * Integration with profile data (PGO). When available, profile data |
| enables more accurate function importing decisions, as well as |
| cross-module indirect call promotion. |
| * Significant build-time and binary-size improvements when compiling with |
| debug info (-g). |
| |
| Changes to the LLVM IR |
| ---------------------- |
| |
| Changes to the ARM Backend |
| -------------------------- |
| |
| During this release ... |
| |
| |
| Changes to the MIPS Target |
| -------------------------- |
| |
| During this release ... |
| |
| |
| Changes to the PowerPC Target |
| ----------------------------- |
| |
| During this release ... |
| |
| Changes to the X86 Target |
| ------------------------- |
| |
| During this release ... |
| |
| Changes to the AMDGPU Target |
| ----------------------------- |
| |
| During this release ... |
| |
| Changes to the AVR Target |
| ----------------------------- |
| |
| During this release ... |
| |
| Changes to the OCaml bindings |
| ----------------------------- |
| |
| During this release ... |
| |
| |
| External Open Source Projects Using LLVM 5 |
| ========================================== |
| |
| * A project... |
| |
| |
| Additional Information |
| ====================== |
| |
| A wide variety of additional information is available on the `LLVM web page |
| <http://llvm.org/>`_, in particular in the `documentation |
| <http://llvm.org/docs/>`_ section. The web page also contains versions of the |
| API documentation which is up-to-date with the Subversion version of the source |
| code. You can access versions of these documents specific to this release by |
| going into the ``llvm/docs/`` directory in the LLVM tree. |
| |
| If you have any questions or comments about LLVM, please feel free to contact |
| us via the `mailing lists <http://llvm.org/docs/#maillist>`_. |
