Introduction for SystemTap Beginner's Guide edits

Correct the limitations section of the introduction. And do some minor edits
to the introduction.

diff --git a/doc/SystemTap_Beginners_Guide/en-US/Introduction.xml b/doc/SystemTap_Beginners_Guide/en-US/Introduction.xml
index aa0678eacf8e423f6e14019f87ea0923e36fd240..33c71f6a30360ef899758ebc85cdc190cba95aab 100644 (file)
--- a/doc/SystemTap_Beginners_Guide/en-US/Introduction.xml
+++ b/doc/SystemTap_Beginners_Guide/en-US/Introduction.xml
@@ -16,7 +16,15 @@
 <!-- next 2 indexterms for documentation goals -->
 
        <para>
-               SystemTap is a tracing and probing tool that allows users to study and monitor the activities of the operating system (particularly, the kernel) in fine detail. It provides information similar to the output of tools like <command>netstat</command>, <command>ps</command>, <command>top</command>, and <command>iostat</command>; however, SystemTap is designed to provide more filtering and analysis options for collected information.
+               SystemTap is a tracing and probing tool that allows
+               users to study and monitor the activities of the
+               computer system (particularly, the kernel) in fine
+               detail. It provides information similar to the output
+               of tools like <command>netstat</command>,
+               <command>ps</command>, <command>top</command>, and
+               <command>iostat</command>; however, SystemTap is
+               designed to provide more filtering and analysis
+               options for collected information.
        </para>
 
        <para condition="RedHat">
@@ -70,7 +78,9 @@
        <para>In line with that, the main goals of the <citetitle>SystemTap Beginner's Guide</citetitle> are as follows:</para>
        -->
        <itemizedlist>
-               <listitem><para>To introduce users to SystemTap, familiarize them with its architecture, and provide setup instructions for all kernel types.</para></listitem>
+               <listitem><para>To introduce users to SystemTap, familiarize
+               them with its architecture, and provide setup
+               instructions.</para></listitem>
 
                <listitem><para>To provide pre-written SystemTap scripts for monitoring detailed activity in different components of the system, along with instructions on how to run them and analyze their output.</para></listitem>
        </itemizedlist>
@@ -146,9 +156,15 @@
 </indexterm>
 
 
-<formalpara>
-       <title>Limitations</title>
-       <para>The current iteration of SystemTap allows for a multitude of options when probing kernel-space events. However, SystemTap's ability to probe user-space events is quite limited. At present, the developmental efforts of the SystemTap community are geared towards improving SystemTap's user-space probing capabilities.</para>
+<formalpara> <title>Limitations</title>
+<para>The current iteration of SystemTap allows for a multitude of
+options when probing kernel-space events for a wide range of kernels.
+However, SystemTap's ability to probe user-space events is dependent
+on kernel support (the Utrace mechanism) that is unavailable in many kernels.
+Thus, only some kernel versions support user-space probing.
+At present, the developmental efforts of the SystemTap community
+are geared towards improving SystemTap's user-space probing
+capabilities.</para>
 </formalpara>