summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authordsmith <dsmith>2008-03-04 22:04:42 +0000
committerdsmith <dsmith>2008-03-04 22:04:42 +0000
commite523ec99f2243055c688041ee2adbf5bb661333b (patch)
tree09b1bc81fdb36eabdd310f2570bae5272b2c3d22
parentb0be9bdb8c6972d847cad50a1e699f1fa806ad99 (diff)
downloadsystemtap-steved-e523ec99f2243055c688041ee2adbf5bb661333b.tar.gz
systemtap-steved-e523ec99f2243055c688041ee2adbf5bb661333b.tar.xz
systemtap-steved-e523ec99f2243055c688041ee2adbf5bb661333b.zip
2008-03-04 David Smith <dsmith@redhat.com>
* tutorial.tex: Made minor changes to remove warnings.
-rw-r--r--doc/ChangeLog4
-rw-r--r--doc/tutorial.tex29
2 files changed, 18 insertions, 15 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 35ee8cbb..902e1d1e 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2008-03-04 David Smith <dsmith@redhat.com>
+
+ * tutorial.tex: Made minor changes to remove warnings.
+
2008-03-03 Frank Ch. Eigler <fche@elastic.org>
From Masami Hiramatsu <mhiramat@redhat.com>
diff --git a/doc/tutorial.tex b/doc/tutorial.tex
index d465bf0b..ee7d37da 100644
--- a/doc/tutorial.tex
+++ b/doc/tutorial.tex
@@ -40,7 +40,6 @@
\hfill \begin{minipage}{2.5in}
% contributors please add your names to the list
Frank Ch. Eigler {\tt \small <fche@redhat.com>} \\
-
\hfill \today
\end{minipage}
@@ -82,7 +81,7 @@ Eventually, the session stops, the hooks are disconnected, and the
module removed. This entire process is driven from a single
command-line program, \verb+stap+.
-\begin{figure}[h!]
+\begin{figure}[!ht]
\begin{boxedminipage}{4.5in}
\begin{verbatim}
# cat hello-world.stp
@@ -106,7 +105,7 @@ can run the scripts such as the simple one in
Figure~\ref{fig:hello-world}. Log on as \verb+root+, or even better,
as a user authorized to \verb+sudo+, before running systemtap.
-\begin{figure}[h]
+\begin{figure}[ht]
\begin{boxedminipage}{4.5in}
\begin{verbatim}
# cat strace-open.stp
@@ -251,7 +250,7 @@ long they took. Figure~\ref{fig:socket-trace} shows the finished
script. It lacks a call to the \verb+exit()+ function, so you need to
interrupt it with \verb+^C+ when you want the tracing to stop.
-\begin{figure}[h!]
+\begin{figure}[!ht]
\begin{boxedminipage}{4.5in}
\begin{verbatim}
# cat socket-trace.stp
@@ -384,7 +383,7 @@ probe handlers and functions executed during a systemtap session.}
protect global variables against concurrent modification and/or
access.}
-\begin{figure}[h!]
+\begin{figure}[!ht]
\begin{boxedminipage}{4.5in}
\begin{verbatim}
# cat timer-jiffies.stp
@@ -436,7 +435,7 @@ example also demonstrates pasting numeric command-line arguments
(\verb+$1+ etc.) into scripts.
%$
-\begin{figure}[h!]
+\begin{figure}[!ht]
\begin{boxedminipage}{4.5in}
\begin{verbatim}
# cat inode-watch.stp
@@ -489,7 +488,7 @@ is possible, up to a nesting depth limit. Figure~\ref{fig:functions}
displays function syntax.
-\begin{figure}[h!]
+\begin{figure}[!ht]
\begin{boxedminipage}{4.5in}
\begin{verbatim}
# Red Hat convention
@@ -580,7 +579,7 @@ expression is one way. For simplicity, systemtap forbids any {\em
modification} of an array while it is being iterated using a
\verb+foreach+.
-\begin{tabular}{rl}
+\begin{tabular}{rp{0.4\textwidth}}
\verb|foreach ([a,b] in foo) { fuss_with(foo[a,b]) }| & simple loop in arbitrary sequence \\
\verb|foreach ([a,b] in foo+ limit 5) { }| & loop in increasing sequence of value, stop after 5 \\
\verb|foreach ([a-,b] in foo) { }| & loop in decreasing sequence of first key \\
@@ -625,12 +624,12 @@ using {\tt foreach} shortly.} only be printed.
\nomenclature{extractor}{A function-like expression in a script that
computes a single statistic for a given aggregate.}
-\begin{tabular}{rl}
+\begin{tabular}{rp{0.5\textwidth}}
\verb+@avg(a)+ & the average of all the values accumulated
into \verb+a+ \\
\verb+print(@hist_linear(a,0,100,10))+ & print an ``ascii art'' linear
- histogram of the same data stream, \\
- & bounds $0 \ldots 100$, bucket width is $10$ \\
+ histogram of the same data stream,
+ bounds $0 \ldots 100$, bucket width is $10$ \\
\verb|@count(writes["zsh"])| & the number of times ``zsh''
ran the probe handler \\
\verb+print(@hist_log(writes["zsh"]))+ & print an ``ascii art'' logarithmic
@@ -738,7 +737,7 @@ specific to general, as shown in Figure~\ref{fig:tapset-search}.
systemtap for tapset scripts, allowing specialization by version
architecture.}
-\begin{figure}[h!]
+\begin{figure}[!ht]
\begin{boxedminipage}{6in}
\begin{verbatim}
# stap -p1 -vv -e 'probe begin { }' > /dev/null
@@ -779,7 +778,7 @@ use. It should have a default, but should not require additional
run-time checks to let a user choose another.
Figure~\ref{fig:tapset-default} shows a way.
-\begin{figure}[h!]
+\begin{figure}[!ht]
\begin{boxedminipage}{6in}
\begin{verbatim}
# cat tapset/time-common.stp
@@ -845,7 +844,7 @@ point alias can expand to multiple probe points, even to other
aliases. It also includes probe point wildcarding. These functions
are designed to compose sensibly.
-\begin{figure}[h!]
+\begin{figure}[!ht]
\begin{boxedminipage}{4.5in}
\begin{verbatim}
# cat probe-alias.stp
@@ -942,7 +941,7 @@ locks.
give up, do not block.
\end{enumerate}
-\begin{figure}[h!]
+\begin{figure}[!ht]
\begin{boxedminipage}{4.5in}
\begin{verbatim}
# cat embedded-C.stp