aboutsummaryrefslogtreecommitdiff
path: root/llvm/docs/CommandGuide
diff options
context:
space:
mode:
authorShao-Ce SUN <shaoce@nj.iscas.ac.cn>2021-11-15 09:17:08 +0800
committerShao-Ce SUN <shaoce@nj.iscas.ac.cn>2021-11-15 09:17:08 +0800
commit0c660256eb41fb0ba44277a32f39d2a028f797f2 (patch)
treea9261cd00510df831f182952f215f757c169c71a /llvm/docs/CommandGuide
parent846f33572ee9f7152de27aca38369c3506711e64 (diff)
downloadllvm-0c660256eb41fb0ba44277a32f39d2a028f797f2.zip
llvm-0c660256eb41fb0ba44277a32f39d2a028f797f2.tar.gz
llvm-0c660256eb41fb0ba44277a32f39d2a028f797f2.tar.bz2
[NFC] Trim trailing whitespace in *.rst
Diffstat (limited to 'llvm/docs/CommandGuide')
-rw-r--r--llvm/docs/CommandGuide/llvm-ar.rst42
-rw-r--r--llvm/docs/CommandGuide/llvm-mca.rst12
-rw-r--r--llvm/docs/CommandGuide/llvm-objcopy.rst2
-rw-r--r--llvm/docs/CommandGuide/llvm-objdump.rst4
-rw-r--r--llvm/docs/CommandGuide/llvm-profdata.rst4
-rw-r--r--llvm/docs/CommandGuide/llvm-readelf.rst8
-rw-r--r--llvm/docs/CommandGuide/llvm-readobj.rst2
-rw-r--r--llvm/docs/CommandGuide/llvm-symbolizer.rst4
8 files changed, 39 insertions, 39 deletions
diff --git a/llvm/docs/CommandGuide/llvm-ar.rst b/llvm/docs/CommandGuide/llvm-ar.rst
index eda4cf8..f1385ad 100644
--- a/llvm/docs/CommandGuide/llvm-ar.rst
+++ b/llvm/docs/CommandGuide/llvm-ar.rst
@@ -25,32 +25,32 @@ archive files. If an SVR4 format archive is used with the :option:`r`
(quick update) operations, the archive will be reconstructed in the format
defined by :option:`--format`.
-Here's where :program:`llvm-ar` departs from previous :program:`ar`
+Here's where :program:`llvm-ar` departs from previous :program:`ar`
implementations:
*The following option is not supported*
-
+
[f] - truncate inserted filenames
-
+
*The following options are ignored for compatibility*
--plugin=<string> - load a plugin which adds support for other file formats
-
- [l] - ignored in :program:`ar`
+
+ [l] - ignored in :program:`ar`
*Symbol Table*
Since :program:`llvm-ar` supports bitcode files, the symbol table it creates
includes both native and bitcode symbols.
-
+
*Deterministic Archives*
By default, :program:`llvm-ar` always uses zero for timestamps and UIDs/GIDs
- to write archives in a deterministic mode. This is equivalent to the
+ to write archives in a deterministic mode. This is equivalent to the
:option:`D` modifier being enabled by default. If you wish to maintain
compatibility with other :program:`ar` implementations, you can pass the
:option:`U` modifier to write actual timestamps and UIDs/GIDs.
-
+
*Windows Paths*
When on Windows :program:`llvm-ar` treats the names of archived *files* in the same
@@ -62,7 +62,7 @@ OPTIONS
:program:`llvm-ar` operations are compatible with other :program:`ar`
implementations. However, there are a few modifiers (:option:`L`) that are not
-found in other :program:`ar` implementations. The options for
+found in other :program:`ar` implementations. The options for
:program:`llvm-ar` specify a single basic Operation to perform on the archive,
a variety of Modifiers for that Operation, the name of the archive file, and an
optional list of file names. If the *files* option is not specified, it
@@ -127,7 +127,7 @@ Operations
they do not exist. The :option:`a`, :option:`b`, :option:`T` and :option:`u`
modifiers apply to this operation. If no *files* are specified, the archive
is not modified.
-
+
t[v]
.. option:: t [vO]
@@ -139,10 +139,10 @@ t[v]
size, and the date. With the :option:`O` modifier, display member offsets. If
any *files* are specified, the listing is only for those files. If no *files*
are specified, the table of contents for the whole archive is printed.
-
+
.. option:: V
- A synonym for the :option:`--version` option.
+ A synonym for the :option:`--version` option.
.. option:: x [oP]
@@ -174,7 +174,7 @@ section to determine which modifiers are applicable to which operations.
.. option:: i
- A synonym for the :option:`b` option.
+ A synonym for the :option:`b` option.
.. option:: L
@@ -188,13 +188,13 @@ section to determine which modifiers are applicable to which operations.
selects the instance of the given name, with "1" indicating the first
instance. If :option:`N` is not specified the first member of that name will
be selected. If *count* is not supplied, the operation fails.*count* cannot be
-
+
.. option:: o
When extracting files, use the modification times of any *files* as they
appear in the ``archive``. By default *files* extracted from the archive
use the time of extraction.
-
+
.. option:: O
Display member offsets inside the archive.
@@ -248,12 +248,12 @@ The modifiers below may be applied to any operation.
This modifier is the opposite of the :option:`s` modifier. It instructs
:program:`llvm-ar` to not build the symbol table. If both :option:`s` and
:option:`S` are used, the last modifier to occur in the options will prevail.
-
+
.. option:: u
Only update ``archive`` members with *files* that have more recent
timestamps.
-
+
.. option:: U
Use actual timestamps and UIDs/GIDs.
@@ -277,7 +277,7 @@ Other
stream. No other options are compatible with this option.
.. option:: --rsp-quoting=<type>
- This option selects the quoting style ``<type>`` for response files, either
+ This option selects the quoting style ``<type>`` for response files, either
``posix`` or ``windows``. The default when on Windows is ``windows``, otherwise the
default is ``posix``.
@@ -296,11 +296,11 @@ MRI SCRIPTS
supported by archivers following in the ar tradition. An MRI script contains a
sequence of commands to be executed by the archiver. The :option:`-M` option
allows for an MRI script to be passed to :program:`llvm-ar` through the
-standard input stream.
-
+standard input stream.
+
Note that :program:`llvm-ar` has known limitations regarding the use of MRI
scripts:
-
+
* Each script can only create one archive.
* Existing archives can not be modified.
diff --git a/llvm/docs/CommandGuide/llvm-mca.rst b/llvm/docs/CommandGuide/llvm-mca.rst
index 4895edc..d226936 100644
--- a/llvm/docs/CommandGuide/llvm-mca.rst
+++ b/llvm/docs/CommandGuide/llvm-mca.rst
@@ -254,7 +254,7 @@ Code regions can have names. For example:
# LLVM-MCA-BEGIN A simple example
add %eax, %eax
- # LLVM-MCA-END
+ # LLVM-MCA-END
The code from the example above defines a region named "A simple example" with a
single instruction in it. Note how the region name doesn't have to be repeated
@@ -627,26 +627,26 @@ Below is an example of ``-bottleneck-analysis`` output generated by
Cycles with backend pressure increase [ 48.07% ]
- Throughput Bottlenecks:
+ Throughput Bottlenecks:
Resource Pressure [ 47.77% ]
- JFPA [ 47.77% ]
- JFPU0 [ 47.77% ]
Data Dependencies: [ 0.30% ]
- Register Dependencies [ 0.30% ]
- Memory Dependencies [ 0.00% ]
-
+
Critical sequence based on the simulation:
-
+
Instruction Dependency Information
+----< 2. vhaddps %xmm3, %xmm3, %xmm4
|
- | < loop carried >
+ | < loop carried >
|
| 0. vmulps %xmm0, %xmm1, %xmm2
+----> 1. vhaddps %xmm2, %xmm2, %xmm3 ## RESOURCE interference: JFPA [ probability: 74% ]
+----> 2. vhaddps %xmm3, %xmm3, %xmm4 ## REGISTER dependency: %xmm3
|
- | < loop carried >
+ | < loop carried >
|
+----> 1. vhaddps %xmm2, %xmm2, %xmm3 ## RESOURCE interference: JFPA [ probability: 74% ]
diff --git a/llvm/docs/CommandGuide/llvm-objcopy.rst b/llvm/docs/CommandGuide/llvm-objcopy.rst
index 79c181f..5f3aa88 100644
--- a/llvm/docs/CommandGuide/llvm-objcopy.rst
+++ b/llvm/docs/CommandGuide/llvm-objcopy.rst
@@ -383,7 +383,7 @@ them.
represents a single symbol, with leading and trailing whitespace ignored, as is
anything following a '#'. Can be specified multiple times to read names from
multiple files.
-
+
.. option:: --new-symbol-visibility <visibility>
Specify the visibility of the symbols automatically created when using binary
diff --git a/llvm/docs/CommandGuide/llvm-objdump.rst b/llvm/docs/CommandGuide/llvm-objdump.rst
index 52bf3bd..88bade71 100644
--- a/llvm/docs/CommandGuide/llvm-objdump.rst
+++ b/llvm/docs/CommandGuide/llvm-objdump.rst
@@ -32,7 +32,7 @@ combined with other commands:
.. option:: -D, --disassemble-all
Disassemble all sections found in the input files.
-
+
.. option:: --disassemble-symbols=<symbol1[,symbol2,...]>
Disassemble only the specified symbols. Takes demangled symbol names when
@@ -92,7 +92,7 @@ combined with other commands:
.. option:: -u, --unwind-info
Display the unwind info of the input(s).
-
+
This operation is only currently supported for COFF and Mach-O object files.
.. option:: -v, --version
diff --git a/llvm/docs/CommandGuide/llvm-profdata.rst b/llvm/docs/CommandGuide/llvm-profdata.rst
index 6472320..7c99e14 100644
--- a/llvm/docs/CommandGuide/llvm-profdata.rst
+++ b/llvm/docs/CommandGuide/llvm-profdata.rst
@@ -94,13 +94,13 @@ OPTIONS
.. option:: -sample
Specify that the input profile is a sample-based profile.
-
+
The format of the generated file can be generated in one of three ways:
.. option:: -binary (default)
Emit the profile using a binary encoding. For instrumentation-based profile
- the output format is the indexed binary format.
+ the output format is the indexed binary format.
.. option:: -extbinary
diff --git a/llvm/docs/CommandGuide/llvm-readelf.rst b/llvm/docs/CommandGuide/llvm-readelf.rst
index 8ba1a0e..d83d566 100644
--- a/llvm/docs/CommandGuide/llvm-readelf.rst
+++ b/llvm/docs/CommandGuide/llvm-readelf.rst
@@ -41,7 +41,7 @@ OPTIONS
.. option:: --demangle, -C
Display demangled symbol names in the output.
-
+
.. option:: --dependent-libraries
Display the dependent libraries section.
@@ -118,7 +118,7 @@ OPTIONS
.. option:: --needed-libs
Display the needed libraries.
-
+
.. option:: --no-demangle
Do not display demangled symbol names in the output. On by default.
@@ -196,11 +196,11 @@ OPTIONS
.. option:: --version-info, -V
Display version sections.
-
+
.. option:: --wide, -W
Ignored for GNU readelf compatibility. The output is already similar to when using -W with GNU readelf.
-
+
.. option:: @<FILE>
Read command-line options from response file `<FILE>`.
diff --git a/llvm/docs/CommandGuide/llvm-readobj.rst b/llvm/docs/CommandGuide/llvm-readobj.rst
index 068808e..e7e6c73b 100644
--- a/llvm/docs/CommandGuide/llvm-readobj.rst
+++ b/llvm/docs/CommandGuide/llvm-readobj.rst
@@ -116,7 +116,7 @@ file formats.
section index or section name.
.. option:: --string-table
-
+
Display contents of the string table.
.. option:: --symbols, --syms, -s
diff --git a/llvm/docs/CommandGuide/llvm-symbolizer.rst b/llvm/docs/CommandGuide/llvm-symbolizer.rst
index 9c15c7e..9518736 100644
--- a/llvm/docs/CommandGuide/llvm-symbolizer.rst
+++ b/llvm/docs/CommandGuide/llvm-symbolizer.rst
@@ -182,7 +182,7 @@ OPTIONS
Print just the file's name without any directories, instead of the
absolute path.
-
+
.. _llvm-symbolizer-opt-C:
.. option:: --demangle, -C
@@ -241,7 +241,7 @@ OPTIONS
Specify the preferred output style. Defaults to ``LLVM``. When the output
style is set to ``GNU``, the tool follows the style of GNU's **addr2line**.
The differences from the ``LLVM`` style are:
-
+
* Does not print the column of a source code location.
* Does not add an empty line after the report for an address.