[PATCH 1/8] man stap.1: escape minus sign properly

[PATCH 1/8] man stap.1: escape minus sign properly

[Timo Juhani Lindfors]

---
 man/stap.1 |    2 +-
 1 files changed, 1 insertions(+), 1 deletions(-)

diff --git a/man/stap.1 b/man/stap.1
index 5beb481..fcf86c0 100644
--- a/man/stap.1
+++ b/man/stap.1
@@ -97,7 +97,7 @@ there and interpreted first.  ($SYSTEMTAP_DIR defaults to $HOME/.systemtap if un
 .TP
 .B \-
 Use standard input instead of a given FILENAME as probe language input,
-unless -e SCRIPT is given.
+unless \-e SCRIPT is given.
 .TP
 .B \-h \-\-help
 Show help message.
-- 
1.7.2.5

[PATCH 3/8] man stapprobes.3stap: escape minus sign properly

[Timo Juhani Lindfors]

---
 man/stapprobes.3stap |    8 ++++----
 1 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/man/stapprobes.3stap b/man/stapprobes.3stap
index 19d4c61..47715a0 100644
--- a/man/stapprobes.3stap
+++ b/man/stapprobes.3stap
@@ -283,7 +283,7 @@ before any rounding occurs.
 Profiling timers are also available to provide probes that execute on
 all CPUs at the rate of the system tick (CONFIG_HZ).  This probe takes
 no parameters.  On some kernels, this is a one-concurrent-user-only or
-disabled facility, resulting in error -16 (EBUSY) during probe
+disabled facility, resulting in error \-16 (EBUSY) during probe
 registration.
 
 .SAMPLE
@@ -540,7 +540,7 @@ returns may be outstanding.  The default is a relatively small number,
 on the order of a few times the number of physical CPUs.  If many
 different threads concurrently call the same blocking function, such
 as futex(2) or read(2), this limit could be exceeded, and skipped
-"kretprobes" would be reported by "stap -t".  To work around this,
+"kretprobes" would be reported by "stap \-t".  To work around this,
 specify a
 .SAMPLE
 probe FOO.return.maxactive(NNN)
@@ -548,7 +548,7 @@ probe FOO.return.maxactive(NNN)
 suffix, with a large enough NNN to cover all expected concurrently blocked
 threads.  Alternately, use the
 .SAMPLE
-stap -DKRETACTIVE=NNNN
+stap \-DKRETACTIVE=NNNN
 .ESAMPLE
 stap command line macro setting to override the default for all
 ".return" probes.
@@ -1152,7 +1152,7 @@ not sanity-check the values: it merely passes them through to
 the kernel for error- and safety-checking.  By default the perf event
 probe is systemwide unless .process is specified, which will bind the
 probe to a specific task.  If the name is omitted then it
-is inferred from the stap -c argument.   A perf event can be read on
+is inferred from the stap \-c argument.   A perf event can be read on
 demand using .counter.  The body of the perf probe handler will not be
 invoked for a .counter probe; instead, the counter is read in a user
 space probe via:
-- 
1.7.2.5

[PATCH 6/8] man stappaths.7: properly escape dot in the beginning of the line

[Timo Juhani Lindfors]

The zero-width control character ensures that the dot is not treated
as a control character. This fixes the following Debian lintian
warning:

W: systemtap-doc: manpage-has-errors-from-man usr/share/man/man7/stappaths.7.gz 61: warning: macro `Elfutils' not defined
---
 man/stappaths.7.in |    4 ++--
 1 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/man/stappaths.7.in b/man/stappaths.7.in
index baa6d91..c275ff1 100644
--- a/man/stappaths.7.in
+++ b/man/stappaths.7.in
@@ -57,8 +57,8 @@ The location of kernel debugging information when packaged into the
 RPM, unless overridden by the
 .I SYSTEMTAP_DEBUGINFO_PATH
 environment variable.  The default value for this variable is
-.I \+:.debug:/usr/lib/debug:build 
-.  Elfutils searches vmlinux in this path and it interprets the path as a base
+.I \+:.debug:/usr/lib/debug:build
+\&. Elfutils searches vmlinux in this path and it interprets the path as a base
 directory of which various subdirectories will be searched for finding debuginfo
 for the kernel, kernel modules, and user-space binaries.
 By default, systemtap will also look for vmlinux in these locations:
-- 
1.7.2.5

[PATCH 2/8] man stap.1: fix typo

[Timo Juhani Lindfors]

---
 man/stap.1 |    2 +-
 1 files changed, 1 insertions(+), 1 deletions(-)

diff --git a/man/stap.1 b/man/stap.1
index fcf86c0..be0aafd 100644
--- a/man/stap.1
+++ b/man/stap.1
@@ -436,7 +436,7 @@ Note that
 .IR \-\-list\-servers
 uses the
 .IR avahi\-daemon
-service to detect online servers. If this service is not avaiable, then
+service to detect online servers. If this service is not available, then
 .IR \-\-list\-servers
 will fail to detect any
 .IR online
-- 
1.7.2.5

[PATCH 4/8] remove executable bit from stapgames tapset

[Timo Juhani Lindfors]

Files in a tapset can not be executed so the bit serves no purpose.
---
 0 files changed, 0 insertions(+), 0 deletions(-)
 mode change 100755 => 100644 testsuite/systemtap.examples/stapgames/tapset/audio.stp
 mode change 100755 => 100644 testsuite/systemtap.examples/stapgames/tapset/cursor.stp
 mode change 100755 => 100644 testsuite/systemtap.examples/stapgames/tapset/game.stp
 mode change 100755 => 100644 testsuite/systemtap.examples/stapgames/tapset/gmtty.stp
 mode change 100755 => 100644 testsuite/systemtap.examples/stapgames/tapset/input.stp

diff --git a/testsuite/systemtap.examples/stapgames/tapset/audio.stp b/testsuite/systemtap.examples/stapgames/tapset/audio.stp
old mode 100755
new mode 100644
diff --git a/testsuite/systemtap.examples/stapgames/tapset/cursor.stp b/testsuite/systemtap.examples/stapgames/tapset/cursor.stp
old mode 100755
new mode 100644
diff --git a/testsuite/systemtap.examples/stapgames/tapset/game.stp b/testsuite/systemtap.examples/stapgames/tapset/game.stp
old mode 100755
new mode 100644
diff --git a/testsuite/systemtap.examples/stapgames/tapset/gmtty.stp b/testsuite/systemtap.examples/stapgames/tapset/gmtty.stp
old mode 100755
new mode 100644
diff --git a/testsuite/systemtap.examples/stapgames/tapset/input.stp b/testsuite/systemtap.examples/stapgames/tapset/input.stp
old mode 100755
new mode 100644
-- 
1.7.2.5

[PATCH 7/8] Add missing executable bit to example scripts

[Timo Juhani Lindfors]

---
 0 files changed, 0 insertions(+), 0 deletions(-)
 mode change 100644 => 100755 testsuite/systemtap.examples/general/alias_suffixes.stp
 mode change 100644 => 100755 testsuite/systemtap.examples/general/regex.stp
 mode change 100644 => 100755 testsuite/systemtap.examples/network/netfilter_drop.stp
 mode change 100644 => 100755 testsuite/systemtap.examples/process/mutex-contention.stp
 mode change 100644 => 100755 testsuite/systemtap.examples/process/threadstacks.stp
 mode change 100644 => 100755 testsuite/systemtap.examples/profiling/perf.stp

diff --git a/testsuite/systemtap.examples/general/alias_suffixes.stp b/testsuite/systemtap.examples/general/alias_suffixes.stp
old mode 100644
new mode 100755
diff --git a/testsuite/systemtap.examples/general/regex.stp b/testsuite/systemtap.examples/general/regex.stp
old mode 100644
new mode 100755
diff --git a/testsuite/systemtap.examples/network/netfilter_drop.stp b/testsuite/systemtap.examples/network/netfilter_drop.stp
old mode 100644
new mode 100755
diff --git a/testsuite/systemtap.examples/process/mutex-contention.stp b/testsuite/systemtap.examples/process/mutex-contention.stp
old mode 100644
new mode 100755
diff --git a/testsuite/systemtap.examples/process/threadstacks.stp b/testsuite/systemtap.examples/process/threadstacks.stp
old mode 100644
new mode 100755
diff --git a/testsuite/systemtap.examples/profiling/perf.stp b/testsuite/systemtap.examples/profiling/perf.stp
old mode 100644
new mode 100755
-- 
1.7.2.5

[PATCH 8/8] man: escape quote properly in header

[Timo Juhani Lindfors]

Without this patch

LC_ALL=en_US.UTF-8 MANROFFSEQ='' MANWIDTH=80 man --warnings -E UTF-8 -l -Tutf8 -Z /usr/share/man/man3/tapset::ansi.3stap.gz >/dev/null

prints

<standard input>:1: warning: macro `"' not defined
---
 doc/SystemTap_Tapset_Reference/manpager |    2 +-
 1 files changed, 1 insertions(+), 1 deletions(-)

diff --git a/doc/SystemTap_Tapset_Reference/manpager b/doc/SystemTap_Tapset_Reference/manpager
index 30e9571..a250162 100755
--- a/doc/SystemTap_Tapset_Reference/manpager
+++ b/doc/SystemTap_Tapset_Reference/manpager
@@ -60,7 +60,7 @@ done ;
 
 # create man page headers
 for i in `ls | grep -v .stp | grep -v tapsetdescription` ; do
-  echo ".\" -*- nroff -*-" >> $i.template ;
+  echo ".\\\" -*- nroff -*-" >> $i.template ;
   echo ".TH tapset::"$i" 3stap --- IBM" >> $i.template ;
   echo ".SH NAME" >> $i.template ;
   echo "tapset::"`cat $i.stp`" \- systemtap "`cat $i.stp`" tapset" >> $i.template ;
-- 
1.7.2.5

[PATCH 5/8] Add missing "#!/usr/bin/env stap" to some examples

[Timo Juhani Lindfors]

---
 .../process/mutex-contention.stp                   |    1 +
 testsuite/systemtap.examples/profiling/perf.stp    |    1 +
 2 files changed, 2 insertions(+), 0 deletions(-)

diff --git a/testsuite/systemtap.examples/process/mutex-contention.stp b/testsuite/systemtap.examples/process/mutex-contention.stp
index 78233ad..87d5a25 100644
--- a/testsuite/systemtap.examples/process/mutex-contention.stp
+++ b/testsuite/systemtap.examples/process/mutex-contention.stp
@@ -1,3 +1,4 @@
+#! /usr/bin/env stap
 // NOTE: a popup mutex is one that is seen in contention but the init of it was not detected
 // not sure why there are popups - static mutex init?
 
diff --git a/testsuite/systemtap.examples/profiling/perf.stp b/testsuite/systemtap.examples/profiling/perf.stp
index 49bc3f3..feac2d3 100644
--- a/testsuite/systemtap.examples/profiling/perf.stp
+++ b/testsuite/systemtap.examples/profiling/perf.stp
@@ -1,3 +1,4 @@
+#! /usr/bin/env stap
 global cycles_per_insn
 global branch_per_insn
 global cacheref_per_insn
-- 
1.7.2.5