1
0
mirror of https://github.com/RPCS3/llvm-mirror.git synced 2024-11-26 12:43:36 +01:00

[docs] Convert remaining command guide entries from md to rst.

Summary:
Linking between markdown and rst files is currently not supported very well, e.g. the current llvm-addr2line docs [1] link to "llvm-symbolizer" instead of "llvm-symbolizer.html". This is weirdly broken in different ways depending on which versions of sphinx and recommonmark are being used, so workaround the bug by using rst everywhere.

[1] http://llvm.org/docs/CommandGuide/llvm-addr2line.html

Reviewers: jhenderson

Reviewed By: jhenderson

Subscribers: lebedev.ri, llvm-commits

Tags: #llvm

Differential Revision: https://reviews.llvm.org/D66305

llvm-svn: 369553
This commit is contained in:
Jordan Rupprecht 2019-08-21 18:00:17 +00:00
parent 2e4634042e
commit 1a675694f0
8 changed files with 91 additions and 65 deletions

View File

@ -1,28 +0,0 @@
# llvm-addr2line - a drop-in replacement for addr2line
## SYNOPSIS
**llvm-addr2line** [*options*]
## DESCRIPTION
**llvm-addr2line** is an alias for the [llvm-symbolizer](llvm-symbolizer) tool
with different defaults. The goal is to make it a drop-in replacement for
GNU's **addr2line**.
Here are some of those differences:
* Defaults not to print function names. Use [-f](llvm-symbolizer-opt-f)
to enable that.
* Defaults not to demangle function names. Use [-C](llvm-symbolizer-opt-C)
to switch the demangling on.
* Defaults not to print inlined frames. Use [-i](llvm-symbolizer-opt-i)
to show inlined frames for a source code location in an inlined function.
* Uses [--output-style=GNU](llvm-symbolizer-opt-output-style) by default.
## SEE ALSO
Refer to [llvm-symbolizer](llvm-symbolizer) for additional information.

View File

@ -0,0 +1,38 @@
llvm-addr2line - a drop-in replacement for addr2line
====================================================
.. program:: llvm-addr2line
SYNOPSIS
--------
:program:`llvm-addr2line` [*options*]
DESCRIPTION
-----------
:program:`llvm-addr2line` is an alias for the :manpage:`llvm-symbolizer(1)`
tool with different defaults. The goal is to make it a drop-in replacement for
GNU's :program:`addr2line`.
Here are some of those differences:
- Defaults not to print function names. Use `-f`_ to enable that.
- Defaults not to demangle function names. Use `-C`_ to switch the
demangling on.
- Defaults not to print inlined frames. Use `-i`_ to show inlined
frames for a source code location in an inlined function.
- Uses `--output-style=GNU`_ by default.
SEE ALSO
--------
:manpage:`llvm-symbolizer(1)`
.. _-f: llvm-symbolizer.html#llvm-symbolizer-opt-f
.. _-C: llvm-symbolizer.html#llvm-symbolizer-opt-c
.. _-i: llvm-symbolizer.html#llvm-symbolizer-opt-i
.. _--output-style=GNU: llvm-symbolizer.html#llvm-symbolizer-opt-output-style

View File

@ -1,17 +0,0 @@
# llvm-ranlib - generates an archive index
## SYNOPSIS
**llvm-ranlib** [*options*]
## DESCRIPTION
**llvm-ranlib** is an alias for the [llvm-ar](llvm-ar.html) tool that generates
an index for an archive. It can be used as a replacement for GNU's **ranlib**
tool.
Running **llvm-ranlib** is equivalent to running **llvm-ar s**.
## SEE ALSO
Refer to [llvm-ar](llvm-ar.html) for additional information.

View File

@ -0,0 +1,23 @@
llvm-ranlib - generates an archive index
========================================
.. program:: llvm-ranlib
SYNOPSIS
--------
:program:`llvm-ranlib` [*options*]
DESCRIPTION
-----------
:program:`llvm-ranlib` is an alias for the :doc:`llvm-ar <llvm-ar>` tool that
generates an index for an archive. It can be used as a replacement for GNUs
:program:`ranlib` tool.
Running :program:`llvm-ranlib` is equivalent to running ``llvm-ar s``.
SEE ALSO
--------
:manpage:`llvm-ar(1)`

View File

@ -1,10 +0,0 @@
# llvm-size - print segment sizes
## SYNOPSIS
**llvm-size** [*options*]
## DESCRIPTION
**llvm-size** is a tool that prints segment sizes in object files. The goal is
to make it a drop-in replacement for GNU's **size**.

View File

@ -0,0 +1,15 @@
llvm-size - print size information
==================================
.. program:: llvm-size
SYNOPSIS
--------
:program:`llvm-size` [*options*]
DESCRIPTION
-----------
:program:`llvm-size` is a tool that prints size information for object files.
The goal is to make it a drop-in replacement for GNUs :program:`size`.

View File

@ -1,10 +0,0 @@
# llvm-strings - print strings
## SYNOPSIS
**llvm-strings** [*options*]
## DESCRIPTION
**llvm-strings** is a tool that prints strings in object files. The goal is to
make it a drop-in replacement for GNU's **size**.

View File

@ -0,0 +1,15 @@
llvm-strings - print strings
============================
.. program:: llvm-strings
SYNOPSIS
--------
:program:`llvm-strings` [*options*]
DESCRIPTION
-----------
:program:`llvm-strings` is a tool that prints strings in files. The goal is to
make it a drop-in replacement for GNUs :program:`strings`.