docs: wordsmith some of the linker option extension

Apply the grammatical improvements suggested by Rafael Avila de
Espindola in post-commit review.

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@323839 91177308-0d34-0410-b5e6-96231b3b80d8
This commit is contained in:
Saleem Abdulrasool 2018-01-31 00:16:23 +00:00
parent 5ee8d5edce
commit 77fc888bfe

View File

@ -228,13 +228,13 @@ In order to support passing linker options from the frontend to the linker, a
special section of type ``SHT_LLVM_LINKER_OPTIONS`` (usually named
``.linker-options`` though the name is not significant as it is identified by
the type). The contents of this section is a simple pair-wise encoding of
options for consideration by the linker. The strings are encoded as standard
directives for consideration by the linker. The strings are encoded as standard
null-terminated UTF-8 strings. They are emitted inline to avoid having the
linker to traverse the object file for retrieving the value. The linker is
linker traverse the object file for retrieving the value. The linker is
permitted to not honour the option and instead provide a warning/error to the
user that the requested option was not honoured.
The section is marked as ``SHT_LLVM_LINKER_OPTIONS`` and has the ``SHF_EXCLUDE``
The section has type ``SHT_LLVM_LINKER_OPTIONS`` and has the ``SHF_EXCLUDE``
flag to ensure that the section is treated as opaque by linkers which do not
support the feature and will not be emitted into the final linked binary.
@ -248,7 +248,8 @@ This would be equivalent to the follow raw assembly:
.asciz "option 2"
.asciz "value 2"
LLVM emits the following options:
The following directives are specified:
- lib
The parameter identifies a library to be linked against. The library will