From 0443499b89585b3a6f8509679f05142777d97339 Mon Sep 17 00:00:00 2001 From: Saleem Abdulrasool Date: Wed, 31 Jan 2018 00:16:23 +0000 Subject: [PATCH] docs: wordsmith some of the linker option extension Apply the grammatical improvements suggested by Rafael Avila de Espindola in post-commit review. llvm-svn: 323839 --- llvm/docs/Extensions.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/llvm/docs/Extensions.rst b/llvm/docs/Extensions.rst index 15f1f61bee88..83819eee6276 100644 --- a/llvm/docs/Extensions.rst +++ b/llvm/docs/Extensions.rst @@ -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