[PATCH] docs: ftrace: fix a few formatting issues

From: Jonathan Corbet
Date: Wed Mar 07 2018 - 12:44:08 EST


Make sure that literal * characters are not interpreted as emphasis
markers.

Signed-off-by: Jonathan Corbet <corbet@xxxxxxx>
---
Documentation/trace/events.rst | 10 +++++-----
Documentation/trace/ftrace.rst | 8 ++++----
2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/Documentation/trace/events.rst b/Documentation/trace/events.rst
index 27bfd06ae29d..bdf1963ba6ba 100644
--- a/Documentation/trace/events.rst
+++ b/Documentation/trace/events.rst
@@ -42,7 +42,7 @@ To disable all events, echo an empty line to the set_event file::

# echo > /sys/kernel/debug/tracing/set_event

-To enable all events, echo '*:*' or '*:' to the set_event file::
+To enable all events, echo ``*:*`` or ``*:`` to the set_event file::

# echo *:* > /sys/kernel/debug/tracing/set_event

@@ -50,7 +50,7 @@ The events are organized into subsystems, such as ext4, irq, sched,
etc., and a full event name looks like this: <subsystem>:<event>. The
subsystem name is optional, but it is displayed in the available_events
file. All of the events in a subsystem can be specified via the syntax
-"<subsystem>:*"; for example, to enable all irq events, you can use the
+``<subsystem>:*``; for example, to enable all irq events, you can use the
command::

# echo 'irq:*' > /sys/kernel/debug/tracing/set_event
@@ -111,8 +111,8 @@ It also displays the format string that will be used to print the
event in text mode, along with the event name and ID used for
profiling.

-Every event has a set of 'common' fields associated with it; these are
-the fields prefixed with 'common_'. The other fields vary between
+Every event has a set of ``common`` fields associated with it; these are
+the fields prefixed with ``common_``. The other fields vary between
events and correspond to the fields defined in the TRACE_EVENT
definition for that event.

@@ -190,7 +190,7 @@ And for string fields they are:

==, !=, ~

-The glob (~) accepts a wild card character (*,?) and character classes
+The glob (~) accepts a wild card character (\*,?) and character classes
([). For example::

prev_comm ~ "*sh"
diff --git a/Documentation/trace/ftrace.rst b/Documentation/trace/ftrace.rst
index 636aa9bf5674..0bc33ad4a3f9 100644
--- a/Documentation/trace/ftrace.rst
+++ b/Documentation/trace/ftrace.rst
@@ -2615,13 +2615,13 @@ To see which functions are being traced, you can cat the file:

Perhaps this is not enough. The filters also allow glob(7) matching.

- <match>*
+ ``<match>*``
will match functions that begin with <match>
- *<match>
+ ``*<match>``
will match functions that end with <match>
- *<match>*
+ ``*<match>*``
will match functions that have <match> in it
- <match1>*<match2>
+ ``<match1>*<match2>``
will match functions that begin with <match1> and end with <match2>

.. note::
--
2.14.3