Re: [PATCH 00/17] Include linux trace docs to Sphinx TOC tree

[Steven Rostedt]

On Wed, 7 Mar 2018 10:46:49 -0700
Jonathan Corbet  wrote:

> Anyway, with that, the patch series is applied.  Thanks for helping to
> improve the docs, and my apologies for taking so long to get to this.

Thanks for doing this Jon. I'm going to have to find some time to
revisit all the documentation in the tracing directory, because I'm
sure they have fallen out of date.

-- Steve

Re: [PATCH 00/17] Include linux trace docs to Sphinx TOC tree

[Steven Rostedt]

On Wed, 7 Mar 2018 10:46:49 -0700
Jonathan Corbet  wrote:

> Anyway, with that, the patch series is applied.  Thanks for helping to
> improve the docs, and my apologies for taking so long to get to this.

Thanks for doing this Jon. I'm going to have to find some time to
revisit all the documentation in the tracing directory, because I'm
sure they have fallen out of date.

-- Steve

Re: [PATCH 00/17] Include linux trace docs to Sphinx TOC tree

[Du, Changbin]

On Wed, Mar 07, 2018 at 10:46:49AM -0700, Jonathan Corbet wrote:
> On Tue, 27 Feb 2018 17:43:37 -0500
> Steven Rostedt  wrote:
> 
> > On Tue, 27 Feb 2018 17:34:22 +0800
> > "Du, Changbin"  wrote:
> >
> > > Ten days past, will you accept this serias? Thank you!
> > 
> > Currently I'm very overloaded with other code that needs to get done
> > ASAP, and I need to balance what is critical and what is not. I don't
> > have time to review this, as this isn't critical, and can wait.
> > 
> > If Jon can review it to make sure that it doesn't change the
> > readability of the text, then I'll trust his judgment. 
> 
> So I've spent a while working through the patches.  I think it's a
> well-done RST conversion carried out with a light hand; I do not believe
> there are any readability issues with the resulting text files.
> 
> I will note that the series adds some new build warnings:
> 
> > Documentation/trace/events.rst:45: WARNING: Inline emphasis start-string 
> > without end-string.
> > Documentation/trace/events.rst:49: WARNING: Inline emphasis start-string 
> > without end-string.
> > Documentation/trace/events.rst:193: WARNING: Inline emphasis start-string 
> > without end-string.
> > Documentation/trace/events.rst:114: WARNING: Unknown target name: "common".
> > Documentation/trace/ftrace.rst:2620: WARNING: Inline emphasis start-string 
> > without end-string.
> 
> These point to places where the resulting formatted docs are, in fact,
> incorrect.  I had to append the attached patch to the series to make those
> problems go away.  The warnings are there for a purpose!
> 
> Anyway, with that, the patch series is applied.  Thanks for helping to
> improve the docs, and my apologies for taking so long to get to this.
> 
> jon
> 
I am also appriciated for your review. And I am glade to see these docs can 
appear
in the new beautiful html documentation! Thnak you.

- changbin

Re: [PATCH 00/17] Include linux trace docs to Sphinx TOC tree

[Du, Changbin]

On Wed, Mar 07, 2018 at 10:46:49AM -0700, Jonathan Corbet wrote:
> On Tue, 27 Feb 2018 17:43:37 -0500
> Steven Rostedt  wrote:
> 
> > On Tue, 27 Feb 2018 17:34:22 +0800
> > "Du, Changbin"  wrote:
> >
> > > Ten days past, will you accept this serias? Thank you!
> > 
> > Currently I'm very overloaded with other code that needs to get done
> > ASAP, and I need to balance what is critical and what is not. I don't
> > have time to review this, as this isn't critical, and can wait.
> > 
> > If Jon can review it to make sure that it doesn't change the
> > readability of the text, then I'll trust his judgment. 
> 
> So I've spent a while working through the patches.  I think it's a
> well-done RST conversion carried out with a light hand; I do not believe
> there are any readability issues with the resulting text files.
> 
> I will note that the series adds some new build warnings:
> 
> > Documentation/trace/events.rst:45: WARNING: Inline emphasis start-string 
> > without end-string.
> > Documentation/trace/events.rst:49: WARNING: Inline emphasis start-string 
> > without end-string.
> > Documentation/trace/events.rst:193: WARNING: Inline emphasis start-string 
> > without end-string.
> > Documentation/trace/events.rst:114: WARNING: Unknown target name: "common".
> > Documentation/trace/ftrace.rst:2620: WARNING: Inline emphasis start-string 
> > without end-string.
> 
> These point to places where the resulting formatted docs are, in fact,
> incorrect.  I had to append the attached patch to the series to make those
> problems go away.  The warnings are there for a purpose!
> 
> Anyway, with that, the patch series is applied.  Thanks for helping to
> improve the docs, and my apologies for taking so long to get to this.
> 
> jon
> 
I am also appriciated for your review. And I am glade to see these docs can 
appear
in the new beautiful html documentation! Thnak you.

- changbin

Re: [PATCH 00/17] Include linux trace docs to Sphinx TOC tree

[Jonathan Corbet]

On Tue, 27 Feb 2018 17:43:37 -0500
Steven Rostedt  wrote:

> On Tue, 27 Feb 2018 17:34:22 +0800
> "Du, Changbin"  wrote:
>
> > Ten days past, will you accept this serias? Thank you!
> 
> Currently I'm very overloaded with other code that needs to get done
> ASAP, and I need to balance what is critical and what is not. I don't
> have time to review this, as this isn't critical, and can wait.
> 
> If Jon can review it to make sure that it doesn't change the
> readability of the text, then I'll trust his judgment. 

So I've spent a while working through the patches.  I think it's a
well-done RST conversion carried out with a light hand; I do not believe
there are any readability issues with the resulting text files.

I will note that the series adds some new build warnings:

> Documentation/trace/events.rst:45: WARNING: Inline emphasis start-string 
> without end-string.
> Documentation/trace/events.rst:49: WARNING: Inline emphasis start-string 
> without end-string.
> Documentation/trace/events.rst:193: WARNING: Inline emphasis start-string 
> without end-string.
> Documentation/trace/events.rst:114: WARNING: Unknown target name: "common".
> Documentation/trace/ftrace.rst:2620: WARNING: Inline emphasis start-string 
> without end-string.

These point to places where the resulting formatted docs are, in fact,
incorrect.  I had to append the attached patch to the series to make those
problems go away.  The warnings are there for a purpose!

Anyway, with that, the patch series is applied.  Thanks for helping to
improve the docs, and my apologies for taking so long to get to this.

jon

>From 6234c7bd8c14508fb76c0a4d6f01eb81c8ce9cbf Mon Sep 17 00:00:00 2001
From: Jonathan Corbet 
Date: Wed, 7 Mar 2018 10:44:08 -0700
Subject: [PATCH] docs: ftrace: fix a few formatting issues

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

Signed-off-by: Jonathan Corbet 
---
 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: :.  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
-":*"; for example, to enable all irq events, you can use the
+``:*``; 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.
 
-  *
+  ``*``
will match functions that begin with 
-  *
+  ``*``
will match functions that end with 
-  **
+  ``**``
will match functions that have  in it
-  *
+  ``*``
will match functions that begin with  and end with 
 
 .. note::
-- 
2.14.3

Re: [PATCH 00/17] Include linux trace docs to Sphinx TOC tree

[Jonathan Corbet]

On Tue, 27 Feb 2018 17:43:37 -0500
Steven Rostedt  wrote:

> On Tue, 27 Feb 2018 17:34:22 +0800
> "Du, Changbin"  wrote:
>
> > Ten days past, will you accept this serias? Thank you!
> 
> Currently I'm very overloaded with other code that needs to get done
> ASAP, and I need to balance what is critical and what is not. I don't
> have time to review this, as this isn't critical, and can wait.
> 
> If Jon can review it to make sure that it doesn't change the
> readability of the text, then I'll trust his judgment. 

So I've spent a while working through the patches.  I think it's a
well-done RST conversion carried out with a light hand; I do not believe
there are any readability issues with the resulting text files.

I will note that the series adds some new build warnings:

> Documentation/trace/events.rst:45: WARNING: Inline emphasis start-string 
> without end-string.
> Documentation/trace/events.rst:49: WARNING: Inline emphasis start-string 
> without end-string.
> Documentation/trace/events.rst:193: WARNING: Inline emphasis start-string 
> without end-string.
> Documentation/trace/events.rst:114: WARNING: Unknown target name: "common".
> Documentation/trace/ftrace.rst:2620: WARNING: Inline emphasis start-string 
> without end-string.

These point to places where the resulting formatted docs are, in fact,
incorrect.  I had to append the attached patch to the series to make those
problems go away.  The warnings are there for a purpose!

Anyway, with that, the patch series is applied.  Thanks for helping to
improve the docs, and my apologies for taking so long to get to this.

jon

>From 6234c7bd8c14508fb76c0a4d6f01eb81c8ce9cbf Mon Sep 17 00:00:00 2001
From: Jonathan Corbet 
Date: Wed, 7 Mar 2018 10:44:08 -0700
Subject: [PATCH] docs: ftrace: fix a few formatting issues

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

Signed-off-by: Jonathan Corbet 
---
 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: :.  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
-":*"; for example, to enable all irq events, you can use the
+``:*``; 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.
 
-  *
+  ``*``
will match functions that begin with 
-  *
+  ``*``
will match functions that end with 
-  **
+  ``**``
will match functions that have  in it
-  *
+  ``*``
will match functions that begin with  and end with 
 
 .. note::
-- 
2.14.3

Re: [PATCH 00/17] Include linux trace docs to Sphinx TOC tree

[Steven Rostedt]

On Tue, 27 Feb 2018 17:34:22 +0800
"Du, Changbin"  wrote:

> Hello Steven and Corbet,
> Ten days past, will you accept this serias? Thank you!
> 
> On Sat, Feb 17, 2018 at 01:39:33PM +0800, changbin...@intel.com wrote:
> > From: Changbin Du 
> > 
> > Hi All,
> > The linux tracers are so useful that I want to make the docs better. The 
> > kernel
> > now uses Sphinx to generate intelligent and beautiful documentation from
> > reStructuredText files. I converted most of the Linux trace docs to rst 
> > format
> > in this serias.
> > 
> > For you to preview, please visit below url:
> > http://docservice.askxiong.com/linux-kernel/trace/index.html
> > 
> > Thank you!

Currently I'm very overloaded with other code that needs to get done
ASAP, and I need to balance what is critical and what is not. I don't
have time to review this, as this isn't critical, and can wait.

If Jon can review it to make sure that it doesn't change the
readability of the text, then I'll trust his judgment. 

-- Steve

Re: [PATCH 00/17] Include linux trace docs to Sphinx TOC tree

[Steven Rostedt]

On Tue, 27 Feb 2018 17:34:22 +0800
"Du, Changbin"  wrote:

> Hello Steven and Corbet,
> Ten days past, will you accept this serias? Thank you!
> 
> On Sat, Feb 17, 2018 at 01:39:33PM +0800, changbin...@intel.com wrote:
> > From: Changbin Du 
> > 
> > Hi All,
> > The linux tracers are so useful that I want to make the docs better. The 
> > kernel
> > now uses Sphinx to generate intelligent and beautiful documentation from
> > reStructuredText files. I converted most of the Linux trace docs to rst 
> > format
> > in this serias.
> > 
> > For you to preview, please visit below url:
> > http://docservice.askxiong.com/linux-kernel/trace/index.html
> > 
> > Thank you!

Currently I'm very overloaded with other code that needs to get done
ASAP, and I need to balance what is critical and what is not. I don't
have time to review this, as this isn't critical, and can wait.

If Jon can review it to make sure that it doesn't change the
readability of the text, then I'll trust his judgment. 

-- Steve

Re: [PATCH 00/17] Include linux trace docs to Sphinx TOC tree

[Du, Changbin]

Hello Steven and Corbet,
Ten days past, will you accept this serias? Thank you!

On Sat, Feb 17, 2018 at 01:39:33PM +0800, changbin...@intel.com wrote:
> From: Changbin Du 
> 
> Hi All,
> The linux tracers are so useful that I want to make the docs better. The 
> kernel
> now uses Sphinx to generate intelligent and beautiful documentation from
> reStructuredText files. I converted most of the Linux trace docs to rst format
> in this serias.
> 
> For you to preview, please visit below url:
> http://docservice.askxiong.com/linux-kernel/trace/index.html
> 
> Thank you!
> 
> Changbin Du (17):
>   Documentation: add Linux tracing to Sphinx TOC tree
>   trace doc: convert trace/ftrace-design.txt to rst format
>   trace doc: add ftrace-uses.rst to doc tree
>   trace doc: convert trace/tracepoint-analysis.txt to rst format
>   trace doc: convert trace/ftrace.txt to rst format
>   trace doc: convert trace/kprobetrace.txt to rst format
>   trace doc: convert trace/uprobetracer.txt to rst format
>   trace doc: convert trace/tracepoints.txt to rst format
>   trace doc: convert trace/events.txt to rst format
>   trace doc: convert trace/events-kmem.txt to rst format
>   trace doc: convert trace/events-power.txt to rst format
>   trace doc: convert trace/events-nmi.txt to rst format
>   trace doc: convert trace/events-msr.txt to rst format
>   trace doc: convert trace/mmiotrace.txt to rst format
>   trace doc: convert trace/hwlat_detector.txt to rst fromat
>   trace doc: convert trace/intel_th.txt to rst format
>   trace doc: convert trace/stm.txt to rst format
> 
>  Documentation/index.rst|1 +
>  .../trace/{events-kmem.txt => events-kmem.rst} |   50 +-
>  Documentation/trace/events-msr.rst |   40 +
>  Documentation/trace/events-msr.txt |   37 -
>  Documentation/trace/events-nmi.rst |   45 +
>  Documentation/trace/events-nmi.txt |   43 -
>  .../trace/{events-power.txt => events-power.rst}   |   52 +-
>  Documentation/trace/{events.txt => events.rst} |  669 ++--
>  .../trace/{ftrace-design.txt => ftrace-design.rst} |  252 +-
>  Documentation/trace/ftrace-uses.rst|   23 +-
>  Documentation/trace/ftrace.rst | 3332 
> 
>  Documentation/trace/ftrace.txt | 3220 ---
>  .../{hwlat_detector.txt => hwlat_detector.rst} |   26 +-
>  Documentation/trace/index.rst  |   23 +
>  Documentation/trace/{intel_th.txt => intel_th.rst} |   43 +-
>  .../trace/{kprobetrace.txt => kprobetrace.rst} |  100 +-
>  .../trace/{mmiotrace.txt => mmiotrace.rst} |   86 +-
>  Documentation/trace/{stm.txt => stm.rst}   |   23 +-
>  ...epoint-analysis.txt => tracepoint-analysis.rst} |   41 +-
>  .../trace/{tracepoints.txt => tracepoints.rst} |   77 +-
>  .../trace/{uprobetracer.txt => uprobetracer.rst}   |   44 +-
>  21 files changed, 4237 insertions(+), 3990 deletions(-)
>  rename Documentation/trace/{events-kmem.txt => events-kmem.rst} (76%)
>  create mode 100644 Documentation/trace/events-msr.rst
>  delete mode 100644 Documentation/trace/events-msr.txt
>  create mode 100644 Documentation/trace/events-nmi.rst
>  delete mode 100644 Documentation/trace/events-nmi.txt
>  rename Documentation/trace/{events-power.txt => events-power.rst} (65%)
>  rename Documentation/trace/{events.txt => events.rst} (82%)
>  rename Documentation/trace/{ftrace-design.txt => ftrace-design.rst} (74%)
>  create mode 100644 Documentation/trace/ftrace.rst
>  delete mode 100644 Documentation/trace/ftrace.txt
>  rename Documentation/trace/{hwlat_detector.txt => hwlat_detector.rst} (83%)
>  create mode 100644 Documentation/trace/index.rst
>  rename Documentation/trace/{intel_th.txt => intel_th.rst} (82%)
>  rename Documentation/trace/{kprobetrace.txt => kprobetrace.rst} (63%)
>  rename Documentation/trace/{mmiotrace.txt => mmiotrace.rst} (78%)
>  rename Documentation/trace/{stm.txt => stm.rst} (91%)
>  rename Documentation/trace/{tracepoint-analysis.txt => 
> tracepoint-analysis.rst} (93%)
>  rename Documentation/trace/{tracepoints.txt => tracepoints.rst} (74%)
>  rename Documentation/trace/{uprobetracer.txt => uprobetracer.rst} (86%)
> 
> -- 
> 2.7.4
> 

-- 
Thanks,
Changbin Du

Re: [PATCH 00/17] Include linux trace docs to Sphinx TOC tree

[Du, Changbin]

Hello Steven and Corbet,
Ten days past, will you accept this serias? Thank you!

On Sat, Feb 17, 2018 at 01:39:33PM +0800, changbin...@intel.com wrote:
> From: Changbin Du 
> 
> Hi All,
> The linux tracers are so useful that I want to make the docs better. The 
> kernel
> now uses Sphinx to generate intelligent and beautiful documentation from
> reStructuredText files. I converted most of the Linux trace docs to rst format
> in this serias.
> 
> For you to preview, please visit below url:
> http://docservice.askxiong.com/linux-kernel/trace/index.html
> 
> Thank you!
> 
> Changbin Du (17):
>   Documentation: add Linux tracing to Sphinx TOC tree
>   trace doc: convert trace/ftrace-design.txt to rst format
>   trace doc: add ftrace-uses.rst to doc tree
>   trace doc: convert trace/tracepoint-analysis.txt to rst format
>   trace doc: convert trace/ftrace.txt to rst format
>   trace doc: convert trace/kprobetrace.txt to rst format
>   trace doc: convert trace/uprobetracer.txt to rst format
>   trace doc: convert trace/tracepoints.txt to rst format
>   trace doc: convert trace/events.txt to rst format
>   trace doc: convert trace/events-kmem.txt to rst format
>   trace doc: convert trace/events-power.txt to rst format
>   trace doc: convert trace/events-nmi.txt to rst format
>   trace doc: convert trace/events-msr.txt to rst format
>   trace doc: convert trace/mmiotrace.txt to rst format
>   trace doc: convert trace/hwlat_detector.txt to rst fromat
>   trace doc: convert trace/intel_th.txt to rst format
>   trace doc: convert trace/stm.txt to rst format
> 
>  Documentation/index.rst|1 +
>  .../trace/{events-kmem.txt => events-kmem.rst} |   50 +-
>  Documentation/trace/events-msr.rst |   40 +
>  Documentation/trace/events-msr.txt |   37 -
>  Documentation/trace/events-nmi.rst |   45 +
>  Documentation/trace/events-nmi.txt |   43 -
>  .../trace/{events-power.txt => events-power.rst}   |   52 +-
>  Documentation/trace/{events.txt => events.rst} |  669 ++--
>  .../trace/{ftrace-design.txt => ftrace-design.rst} |  252 +-
>  Documentation/trace/ftrace-uses.rst|   23 +-
>  Documentation/trace/ftrace.rst | 3332 
> 
>  Documentation/trace/ftrace.txt | 3220 ---
>  .../{hwlat_detector.txt => hwlat_detector.rst} |   26 +-
>  Documentation/trace/index.rst  |   23 +
>  Documentation/trace/{intel_th.txt => intel_th.rst} |   43 +-
>  .../trace/{kprobetrace.txt => kprobetrace.rst} |  100 +-
>  .../trace/{mmiotrace.txt => mmiotrace.rst} |   86 +-
>  Documentation/trace/{stm.txt => stm.rst}   |   23 +-
>  ...epoint-analysis.txt => tracepoint-analysis.rst} |   41 +-
>  .../trace/{tracepoints.txt => tracepoints.rst} |   77 +-
>  .../trace/{uprobetracer.txt => uprobetracer.rst}   |   44 +-
>  21 files changed, 4237 insertions(+), 3990 deletions(-)
>  rename Documentation/trace/{events-kmem.txt => events-kmem.rst} (76%)
>  create mode 100644 Documentation/trace/events-msr.rst
>  delete mode 100644 Documentation/trace/events-msr.txt
>  create mode 100644 Documentation/trace/events-nmi.rst
>  delete mode 100644 Documentation/trace/events-nmi.txt
>  rename Documentation/trace/{events-power.txt => events-power.rst} (65%)
>  rename Documentation/trace/{events.txt => events.rst} (82%)
>  rename Documentation/trace/{ftrace-design.txt => ftrace-design.rst} (74%)
>  create mode 100644 Documentation/trace/ftrace.rst
>  delete mode 100644 Documentation/trace/ftrace.txt
>  rename Documentation/trace/{hwlat_detector.txt => hwlat_detector.rst} (83%)
>  create mode 100644 Documentation/trace/index.rst
>  rename Documentation/trace/{intel_th.txt => intel_th.rst} (82%)
>  rename Documentation/trace/{kprobetrace.txt => kprobetrace.rst} (63%)
>  rename Documentation/trace/{mmiotrace.txt => mmiotrace.rst} (78%)
>  rename Documentation/trace/{stm.txt => stm.rst} (91%)
>  rename Documentation/trace/{tracepoint-analysis.txt => 
> tracepoint-analysis.rst} (93%)
>  rename Documentation/trace/{tracepoints.txt => tracepoints.rst} (74%)
>  rename Documentation/trace/{uprobetracer.txt => uprobetracer.rst} (86%)
> 
> -- 
> 2.7.4
> 

-- 
Thanks,
Changbin Du

[PATCH 00/17] Include linux trace docs to Sphinx TOC tree

[changbin . du]

From: Changbin Du 

Hi All,
The linux tracers are so useful that I want to make the docs better. The kernel
now uses Sphinx to generate intelligent and beautiful documentation from
reStructuredText files. I converted most of the Linux trace docs to rst format
in this serias.

For you to preview, please visit below url:
http://docservice.askxiong.com/linux-kernel/trace/index.html

Thank you!

Changbin Du (17):
  Documentation: add Linux tracing to Sphinx TOC tree
  trace doc: convert trace/ftrace-design.txt to rst format
  trace doc: add ftrace-uses.rst to doc tree
  trace doc: convert trace/tracepoint-analysis.txt to rst format
  trace doc: convert trace/ftrace.txt to rst format
  trace doc: convert trace/kprobetrace.txt to rst format
  trace doc: convert trace/uprobetracer.txt to rst format
  trace doc: convert trace/tracepoints.txt to rst format
  trace doc: convert trace/events.txt to rst format
  trace doc: convert trace/events-kmem.txt to rst format
  trace doc: convert trace/events-power.txt to rst format
  trace doc: convert trace/events-nmi.txt to rst format
  trace doc: convert trace/events-msr.txt to rst format
  trace doc: convert trace/mmiotrace.txt to rst format
  trace doc: convert trace/hwlat_detector.txt to rst fromat
  trace doc: convert trace/intel_th.txt to rst format
  trace doc: convert trace/stm.txt to rst format

 Documentation/index.rst|1 +
 .../trace/{events-kmem.txt => events-kmem.rst} |   50 +-
 Documentation/trace/events-msr.rst |   40 +
 Documentation/trace/events-msr.txt |   37 -
 Documentation/trace/events-nmi.rst |   45 +
 Documentation/trace/events-nmi.txt |   43 -
 .../trace/{events-power.txt => events-power.rst}   |   52 +-
 Documentation/trace/{events.txt => events.rst} |  669 ++--
 .../trace/{ftrace-design.txt => ftrace-design.rst} |  252 +-
 Documentation/trace/ftrace-uses.rst|   23 +-
 Documentation/trace/ftrace.rst | 3332 
 Documentation/trace/ftrace.txt | 3220 ---
 .../{hwlat_detector.txt => hwlat_detector.rst} |   26 +-
 Documentation/trace/index.rst  |   23 +
 Documentation/trace/{intel_th.txt => intel_th.rst} |   43 +-
 .../trace/{kprobetrace.txt => kprobetrace.rst} |  100 +-
 .../trace/{mmiotrace.txt => mmiotrace.rst} |   86 +-
 Documentation/trace/{stm.txt => stm.rst}   |   23 +-
 ...epoint-analysis.txt => tracepoint-analysis.rst} |   41 +-
 .../trace/{tracepoints.txt => tracepoints.rst} |   77 +-
 .../trace/{uprobetracer.txt => uprobetracer.rst}   |   44 +-
 21 files changed, 4237 insertions(+), 3990 deletions(-)
 rename Documentation/trace/{events-kmem.txt => events-kmem.rst} (76%)
 create mode 100644 Documentation/trace/events-msr.rst
 delete mode 100644 Documentation/trace/events-msr.txt
 create mode 100644 Documentation/trace/events-nmi.rst
 delete mode 100644 Documentation/trace/events-nmi.txt
 rename Documentation/trace/{events-power.txt => events-power.rst} (65%)
 rename Documentation/trace/{events.txt => events.rst} (82%)
 rename Documentation/trace/{ftrace-design.txt => ftrace-design.rst} (74%)
 create mode 100644 Documentation/trace/ftrace.rst
 delete mode 100644 Documentation/trace/ftrace.txt
 rename Documentation/trace/{hwlat_detector.txt => hwlat_detector.rst} (83%)
 create mode 100644 Documentation/trace/index.rst
 rename Documentation/trace/{intel_th.txt => intel_th.rst} (82%)
 rename Documentation/trace/{kprobetrace.txt => kprobetrace.rst} (63%)
 rename Documentation/trace/{mmiotrace.txt => mmiotrace.rst} (78%)
 rename Documentation/trace/{stm.txt => stm.rst} (91%)
 rename Documentation/trace/{tracepoint-analysis.txt => 
tracepoint-analysis.rst} (93%)
 rename Documentation/trace/{tracepoints.txt => tracepoints.rst} (74%)
 rename Documentation/trace/{uprobetracer.txt => uprobetracer.rst} (86%)

-- 
2.7.4

[PATCH 00/17] Include linux trace docs to Sphinx TOC tree

[changbin . du]

From: Changbin Du 

Hi All,
The linux tracers are so useful that I want to make the docs better. The kernel
now uses Sphinx to generate intelligent and beautiful documentation from
reStructuredText files. I converted most of the Linux trace docs to rst format
in this serias.

For you to preview, please visit below url:
http://docservice.askxiong.com/linux-kernel/trace/index.html

Thank you!

Changbin Du (17):
  Documentation: add Linux tracing to Sphinx TOC tree
  trace doc: convert trace/ftrace-design.txt to rst format
  trace doc: add ftrace-uses.rst to doc tree
  trace doc: convert trace/tracepoint-analysis.txt to rst format
  trace doc: convert trace/ftrace.txt to rst format
  trace doc: convert trace/kprobetrace.txt to rst format
  trace doc: convert trace/uprobetracer.txt to rst format
  trace doc: convert trace/tracepoints.txt to rst format
  trace doc: convert trace/events.txt to rst format
  trace doc: convert trace/events-kmem.txt to rst format
  trace doc: convert trace/events-power.txt to rst format
  trace doc: convert trace/events-nmi.txt to rst format
  trace doc: convert trace/events-msr.txt to rst format
  trace doc: convert trace/mmiotrace.txt to rst format
  trace doc: convert trace/hwlat_detector.txt to rst fromat
  trace doc: convert trace/intel_th.txt to rst format
  trace doc: convert trace/stm.txt to rst format

 Documentation/index.rst|1 +
 .../trace/{events-kmem.txt => events-kmem.rst} |   50 +-
 Documentation/trace/events-msr.rst |   40 +
 Documentation/trace/events-msr.txt |   37 -
 Documentation/trace/events-nmi.rst |   45 +
 Documentation/trace/events-nmi.txt |   43 -
 .../trace/{events-power.txt => events-power.rst}   |   52 +-
 Documentation/trace/{events.txt => events.rst} |  669 ++--
 .../trace/{ftrace-design.txt => ftrace-design.rst} |  252 +-
 Documentation/trace/ftrace-uses.rst|   23 +-
 Documentation/trace/ftrace.rst | 3332 
 Documentation/trace/ftrace.txt | 3220 ---
 .../{hwlat_detector.txt => hwlat_detector.rst} |   26 +-
 Documentation/trace/index.rst  |   23 +
 Documentation/trace/{intel_th.txt => intel_th.rst} |   43 +-
 .../trace/{kprobetrace.txt => kprobetrace.rst} |  100 +-
 .../trace/{mmiotrace.txt => mmiotrace.rst} |   86 +-
 Documentation/trace/{stm.txt => stm.rst}   |   23 +-
 ...epoint-analysis.txt => tracepoint-analysis.rst} |   41 +-
 .../trace/{tracepoints.txt => tracepoints.rst} |   77 +-
 .../trace/{uprobetracer.txt => uprobetracer.rst}   |   44 +-
 21 files changed, 4237 insertions(+), 3990 deletions(-)
 rename Documentation/trace/{events-kmem.txt => events-kmem.rst} (76%)
 create mode 100644 Documentation/trace/events-msr.rst
 delete mode 100644 Documentation/trace/events-msr.txt
 create mode 100644 Documentation/trace/events-nmi.rst
 delete mode 100644 Documentation/trace/events-nmi.txt
 rename Documentation/trace/{events-power.txt => events-power.rst} (65%)
 rename Documentation/trace/{events.txt => events.rst} (82%)
 rename Documentation/trace/{ftrace-design.txt => ftrace-design.rst} (74%)
 create mode 100644 Documentation/trace/ftrace.rst
 delete mode 100644 Documentation/trace/ftrace.txt
 rename Documentation/trace/{hwlat_detector.txt => hwlat_detector.rst} (83%)
 create mode 100644 Documentation/trace/index.rst
 rename Documentation/trace/{intel_th.txt => intel_th.rst} (82%)
 rename Documentation/trace/{kprobetrace.txt => kprobetrace.rst} (63%)
 rename Documentation/trace/{mmiotrace.txt => mmiotrace.rst} (78%)
 rename Documentation/trace/{stm.txt => stm.rst} (91%)
 rename Documentation/trace/{tracepoint-analysis.txt => 
tracepoint-analysis.rst} (93%)
 rename Documentation/trace/{tracepoints.txt => tracepoints.rst} (74%)
 rename Documentation/trace/{uprobetracer.txt => uprobetracer.rst} (86%)

-- 
2.7.4