[LLD][ELF] Add initial LLD LinkerScript docs page
authorPeter Smith <peter.smith@arm.com>
Tue, 10 Mar 2020 13:26:50 +0000 (13:26 +0000)
committerPeter Smith <peter.smith@arm.com>
Wed, 11 Mar 2020 10:56:12 +0000 (10:56 +0000)
commit6d5603e2d22041c4873da4daebab3386a462c3e0
tree7f6223a185073a033a87cbed5ddd128d557c59db
parent8d9886f8936f334fade17084020c04bf25e09bbe
[LLD][ELF] Add initial LLD LinkerScript docs page

LLD implements Linker Scripts as they are described in the GNU ld manual.
This description is far from a specification, with the only true reference
the GNU ld implementation, which has undocumented behaviour that can vary
from release to release.

To make it easy for people to switch between linkers we try to follow GNU
ld implementation details wherever possible. We reserve the right to make
our own decisions where the undocumented GNU ld behaviour is not
appropriate for LLD. We don't have a place to document these decisions and
it can be difficult for users to find out this information.

This file is a statement of the LLD implementation policy and will contain
intentional deviations from GNU ld.

The first patch that will add concrete details to this file is D75724

Differential Revision: https://reviews.llvm.org/D75921
lld/docs/ELF/linker_script.rst [new file with mode: 0644]
lld/docs/index.rst