[PATCH] D75921: [LLD][DOCS][ELF]Add initial LLD LinkerScript docs page

[Peter Smith via Phabricator via llvm-commits]

This revision was automatically updated to reflect the committed changes.
Closed by commit rG6d5603e2d220: [LLD][ELF] Add initial LLD LinkerScript docs page (authored by psmith).

Repository:
  rG LLVM Github Monorepo

CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D75921/new/

https://reviews.llvm.org/D75921

Files:
  lld/docs/ELF/linker_script.rst
  lld/docs/index.rst


Index: lld/docs/index.rst
===================================================================
--- lld/docs/index.rst
+++ lld/docs/index.rst
@@ -176,3 +176,4 @@
    missingkeyfunction
    Partitions
    ReleaseNotes
+   ELF/linker_script
Index: lld/docs/ELF/linker_script.rst
===================================================================
--- /dev/null
+++ lld/docs/ELF/linker_script.rst
@@ -0,0 +1,18 @@
+Linker Script implementation notes and policy
+=============================================
+
+LLD implements a large subset of the GNU ld linker script notation. The LLD
+implementation policy is to implement linker script features as they are
+documented in the ld `manual <https://sourceware.org/binutils/docs/ld/Scripts.html>`_
+We consider it a bug if the lld implementation does not agree with the manual
+and it is not mentioned in the exceptions below.
+
+The ld manual is not a complete specification, and is not sufficient to build
+an implementation. In particular some features are only defined by the
+implementation and have changed over time.
+
+The lld implementation policy for properties of linker scripts that are not
+defined by the documentation is to follow the GNU ld implementation wherever
+possible. We reserve the right to make different implementation choices where
+it is appropriate for LLD. Intentional deviations will be documented in this
+file.


-------------- next part --------------
A non-text attachment was scrubbed...
Name: D75921.249583.patch
Type: text/x-patch
Size: 1390 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/llvm-commits/attachments/20200311/060e918b/attachment.bin>