diff options
author | Shao-Ce SUN <shaoce@nj.iscas.ac.cn> | 2021-11-15 09:17:08 +0800 |
---|---|---|
committer | Shao-Ce SUN <shaoce@nj.iscas.ac.cn> | 2021-11-15 09:17:08 +0800 |
commit | 0c660256eb41fb0ba44277a32f39d2a028f797f2 (patch) | |
tree | a9261cd00510df831f182952f215f757c169c71a /llvm/docs/CommandGuide | |
parent | 846f33572ee9f7152de27aca38369c3506711e64 (diff) | |
download | llvm-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.rst | 42 | ||||
-rw-r--r-- | llvm/docs/CommandGuide/llvm-mca.rst | 12 | ||||
-rw-r--r-- | llvm/docs/CommandGuide/llvm-objcopy.rst | 2 | ||||
-rw-r--r-- | llvm/docs/CommandGuide/llvm-objdump.rst | 4 | ||||
-rw-r--r-- | llvm/docs/CommandGuide/llvm-profdata.rst | 4 | ||||
-rw-r--r-- | llvm/docs/CommandGuide/llvm-readelf.rst | 8 | ||||
-rw-r--r-- | llvm/docs/CommandGuide/llvm-readobj.rst | 2 | ||||
-rw-r--r-- | llvm/docs/CommandGuide/llvm-symbolizer.rst | 4 |
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. |