[docs][llvm-strip] Update llvm-strip doc to better match llvm-objcopy's

Main changes are mostly wording of some options, but this change also
fixes a switch reference so that a link is created and moves
--strip-sections into the ELF-specific area since it is only supported
for ELF currently.

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@372864 91177308-0d34-0410-b5e6-96231b3b80d8

diff --git a/docs/CommandGuide/llvm-strip.rst b/docs/CommandGuide/llvm-strip.rst
index 5f820d6ce4f132d6ec805c92d5cf12fa972e9cd2..41529bf08cc14e40083ba466f69c08f169671bd3 100644 (file)
--- a/docs/CommandGuide/llvm-strip.rst
+++ b/docs/CommandGuide/llvm-strip.rst
@@ -52,7 +52,7 @@ multiple file formats.
 
 .. option::  --no-strip-all
 
- Disable --strip-all.
+ Disable :option:`--strip-all`.
 
 .. option::  -o <file>
 
@@ -84,11 +84,7 @@ multiple file formats.
 
 .. option:: --strip-debug, -g
 
- Remove all debug sections.
-
-.. option:: --strip-sections
-
- Remove all section headers and all sections not in segments.
+ Remove all debug sections from the output.
 
 .. option:: --strip-symbol <symbol>, -N
 
@@ -147,12 +143,18 @@ them.
 
 .. option:: --keep-symbol <symbol>, -K
 
- Do not remove symbols named ``<symbol>``. Can be specified multiple times to
- keep multiple symbols.
+ When removing symbols from the output, do not remove symbols named
+ ``<symbol>``. Can be specified multiple times to keep multiple symbols.
 
 .. option::  --preserve-dates, -p
 
- Preserve access and modification timestamps.
+ Preserve access and modification timestamps in the output.
+
+.. option:: --strip-sections
+
+ Remove from the output all section headers and all section data not within
+ segments. Note that many tools will not be able to use an object without
+ section headers.
 
 EXIT STATUS
 -----------