BZ915247: remove i18n stub support from python dtrace.in script

* Makefile.am (update-po): Drop dtrace.in from POTFILES.in.
* Makefile.in, po/*: Regenerate.
* dtrace.in: Remove gettext calls.

Handle an allocation failure in _stp_vsnprintf().

* runtime/vsprintf.c (_stp_vsnprintf): If _stp_reserve_bytes() fails,
  print an error and exit.

Fixed PR14491 by adding a real transport layer for dyninst.

* runtime/dyninst/transport.c: New file.
* runtime/dyninst/transport.h: New file.
* translate.cxx (c_unparser::emit_module_init): Emit a call to
  stp_session_init_finished() before probe registrations.
  (c_unparser::emit_module_exit): In dyninst mode, delay
  releasing the context.
* tapsets.cxx (common_probe_entryfn_epilogue): In dyninst mode, delay
  releasing the context.
* runtime/dyninst/stapdyn.h: Add stp_dyninst_session_init_finished()
  prototype.
* runtime/dyninst/shm.c (_stp_shm_destroy): Right before unmapping the
  shared memory, tear down the contexts.
* runtime/dyninst/runtime_context.h (__stp_runtime_contexts_free): New
  function.
* runtime/dyninst/runtime.h (stp_pthread_rwlock_init_shared): New function.
  (stp_dyninst_shm_connect): Initialize the transport by calling
  _stp_dyninst_transport_init().
  (stp_dyninst_session_init): Ditto.
  (stp_dyninst_session_init_finished): New function.
  (stp_dyninst_dtor): Shutdown the transport by calling
  _stp_dyninst_transport_shutdown().
* runtime/dyninst/print.c (_stp_print_flush): Now just calls
  _stp_dyninst_transport_write().
  (_stp_reserve_bytes): Now just calls
  _stp_dyninst_transport_reserve_bytes().
  (_stp_unreserve_bytes): Now just calls
  _stp_dyninst_transport_unreserve_bytes().
* runtime/dyninst/common_session_state.h: Add transport data to session
  data structure.
* runtime/common_probe_context.h: Add transport data to context structure.
* runtime/dyninst/io.c (_stp_vlog): New function.
  (_stp_warn): Now uses _stp_vlog().
  (_stp_error): Ditto.
  (_stp_softerror): Ditto.
  (_stp_dbug): Ditto.

Expand the SDT benchmark locations

- Add the loop index as an argument to stap:benchmark.
- Add stap:benchmark-thread-begin/end around each thread.
- Add stap:benchmark-begin/end around the whole thing.

Support "pid" interface of perf (for per-process case)

The interface of perf_event_create_kernel_counter() in kernel versions prior
2.6.37 takes the process id instead of a pointer to the task struct.

Signed-off-by: Torsten Polle <Torsten.Polle@gmx.de>

mutex-contention sample: drop compulsory NNNN argument used for array sizing

PR15363: tweak registration-warning message to print inode-offset

Sadly, virtual address to feed/decode objdump -d is not available.

PR15363 warn but don't error-abort, on inode-uprobes registration error

Fix weekdays in the rpm spec %changelog (per rpmlint)

uretprobes: Update for aarapov's v1 (posted April 3)

The uretprobes handler is now called ".ret_handler", with a new "func"
parameter for the breakpoint vaddr (which we don't use for now).

extend error::pass2 man page

Enable process.plt probes for ARM.

(Confirmed in binutils bfd/elf32-arm.c, elf32_arm_plt0_entry / elf32_arm_plt_entry.)

stapdyn runtime: don't use mktemp to create a file name

* runtime/dyninst/shm.c (_stp_shm_init): Just use a pid-based name; we only
  need mild uniqueness to avoid accidental collision.

BZ855981: Further tweak getcpu compatibility

- Keep using sched_getcpu() where possible - it's sometimes faster.
- Pass the correct parameters to syscall(getcpu).
- Direct the tapset cpu() through this compat code too.

BZ855981/948279, on second thought, use -march=i586 vice i686

BZ855981/948279, work around gcc default -march=i386 __sync_* incapability

* buildrun.cxx (compile_dyninst): Add CFLAGS += -march=i686 for arch=i386.

BZ855981: stapdyn runtime compatibility with RHEL5

Old kernels & old glibcs require some minor compatibility hacks.

* runtime/dyninst/linux_defs.h: Dummy-define CLOCK_MONOTONIC_RAW
  if required.
* runtime/dyninst/runtime.h: Dummy-define BITS_PER_LONG if required.
  _stp_runtime_entryfn_get_context: Use syscall(__NR_gettid) as
  fallback from __NR_getcpu if required.

PR15053: NEWS item and tweaked usage message for stapdyn

PR15315: Filter inode-uprobe processes in the handler

We already had process tracking, mainly for setting semaphores, but this
gives the list needed to check if an incoming uprobe hit is for a
process we care about.  So now stapiu_probe_prehandler will consult this
list before proceeding with the rest of the probe handler.

This also updates locking so that readers of this process list have a
more fine-grained lock, rather than the global stapiu_process_lock.
Code that needs to reserve/free a uprobe slot will both the global lock
and the specific target lock.

eatmydata: fix cut&paste'd description text

eatmydata: don't override $return for non-participating processes

samples: regenerate indexes, tweak keywords

eatmydata: new sample script

PR15306: Guard the stapdyn probe prologue for no shm

* runtime/dyninst/common_session_state.h (GET_SESSION_ATOMIC,
  _stap_hash_seed, probe_alibi, probe_timing, stp_session_context):
  Return NULL if the session (in shm) doesn't exist yet.
* tapsets.cxx (common_probe_entryfn_prologue): Skip the whole probe if
  the session_state isn't available at all (i.e. no shm yet).
  (common_probe_entryfn_epilogue): Close the session_state block.

mutator.cxx:481:42: error: expected primary-expression before '.' token

Signed-off-by: Adrian Negreanu <groleo@gmail.com>
Signed-off-by: Josh Stone <jistone@redhat.com>

Add stap-prep.1 to systemtap.spec

*systemtap.spec: add %{_mandir}/man1/stap-prep.1* to be packaged

man/Makefile.in: regenerate

install stap-prep.1 man page

stap-prep: debian: do not check for linux-kbuild

linux-headers* already depends on the right linux-kbuild* package and
our heuristic for guessing the package name is lacking. For example
with linux-image-3.2.0-0.bpo.4-amd64 version 3.2.35-2~bpo60+1 from
squeeze-backports it predicts "linux-kbuild-3.2.0" while the package
is actually named "linux-kbuild-3.2".

man stap.1: add reference to stap-prep (1)

man: add man page for stap-prep (1)

stap-prep: add support for deb based systems

Prepare stap-prep for support for non-rpm systems

configury: regenerate on fedora-18 with autoconf 2.69 etc.

Fixed PR15114 by adding uid/gid convenience variables to nfsd.proc.*.

* tapset/linux/nfsd.stp: Added uid/gid convenience variables to
  nfsd.proc.* aliases.
* testsuite/buildok/nfsd-detailed.stp: Added compile test for uid/gid
  convenience variables.

stap-report: include dpkg | grep linux on deb/ubuntu platforms

Add a few more ENABLE_NLS checks to be consistent

fixes for ENABLE_NLS=0

v2:
    [Josh Stone]: replace _F(_N(a,b,c),...) with _NF(a,b,c,...)

Signed-off-by: Adrian Marius Negreanu <adrian.m.negreanu@intel.com>
Signed-off-by: Josh Stone <jistone@redhat.com>

PR15053: stapdyn -G global variable setting support (initial patch)

* buildrun.cxx (make_dyninst_run_command): pass module arguments on to stapdyn.
* runtime/dyninst/runtime.h (set_int64_t): new function.
* runtime/dyninst/stapdyn.h (stp_global_setter): function prototype.
* stapdyn/mutator.cxx (mutator::mutator): add modoptions to mutator.
  (mutator::init_modoptions): new function.
  (mutator::run_module_init): call init_modoptions to initialize globals.
* stapdyn/mutator.h (class mutator): add modoptions to mutator.
* stapdyn/stapdyn.cxx (main): collect module arguments from command line.
* translate.cxx (struct c_unparser): new emit_global_init_* functions.
  (c_unparser::emit_global_param): stapdyn no longer calls this function.
  (c_unparser::emit_global_init_setters): new function.
  (c_unparser::emit_global_init): emit default initial values in stapdyn mode.
  (c_unparser::emit_global_init_type): new function.
  (c_unparser::emit_module_init): copy initial values of stapdyn globals
     to shared memory as appropriate.
  (translate_pass): emit static-initialization struct for stapdyn,
     and also emit the setter function to access this struct.
* translate.h (struct c_unparser): document new emit_global_init_* functions.

PR15279: Leave REG_IP alone in 3.9ish uprobes

We had experimental code to use uprobes that passed the IP as an extra
parameter, but that was dropped in favor of modifying pt_regs directly,
before even calling the handlers.  So this restores our handler to never
take an IP, and updates REG_IP only for older versions.

* buildrun.cxx: Don't run autoconf-inode-uprobes-noaddr.c.
* runtime/linux/autoconf-inode-uprobes-noaddr.c: Deleted.
* runtime/linux/uprobes-inode.c: Set STAPIU_NEEDS_REG_IP for older
  uprobes, and consolidate to a single handler function that uses that
  flag to gate IP-setting.
* testsuite/systemtap.context/uprobe_uaddr_mark.*: New test, makes sure
  that uaddr() matches the statement(ADDR) in pp().

PR15290: remove additional uretprobe cruft

PR15290: add support for aarapov's uretprobes

Signed-off-by: Adrian Marius Negreanu <adrian.m.negreanu@intel.com>
Signed-off-by: Josh Stone <jistone@redhat.com>

Remove stapdyn '-std=c++11' compile flag.

* stapdyn/Makefile.am: Remove "-std=c++11" compile flag.
* stapdyn/Makefile.in: Regenerated.
* stapdyn/dynprobe.cxx: Change '__typeof__' back to 'typeof'.
* stapdyn/mutator.cxx: Ditto.
* stapdyn/mutator.h: Ditto.

Include runtime/dyninst/stapdyn.h properly in stapdyn C++ code.

* stapdyn/dynprobe.cxx: Make sure when we include
  runtime/dyninst/stapdyn.h we use 'extern "C"'.
* stapdyn/mutatee.cxx: Ditto.
* stapdyn/mutator.cxx: Ditto.
* stapdyn/mutator.h: Ditto.

Added better process cleanup in 6 testcases.

* testsuite/systemtap.clone/probe_by_pid.exp: Better process cleanup.
* testsuite/systemtap.server/client.exp: Ditto.
* testsuite/systemtap.server/server.exp: Ditto.
* testsuite/systemtap.server/server_args.exp: Ditto.
* testsuite/systemtap.server/server_concurrency.exp: Ditto.
* testsuite/systemtap.server/server_locale.exp: Ditto.

Make sure dyninst stat/map locks are using PTHREAD_PROCESS_SHARED.

* runtime/dyninst/map_runtime.h (_stp_map_initialize_lock): Be sure to set
  'PTHREAD_PROCESS_SHARED' on mutexes by calling
  stp_pthread_mutex_init_shared().
* runtime/dyninst/stat_runtime.h: Ditto.
* runtime/dyninst/runtime.h: Add forward declaration of
  stp_pthread_mutex_init_shared().

Make sure macro chain tokens are available for error reporting.

Found by a combination of zzuf and valgrind. When reporting the chain
token we need a real copy, because the existing (junk) token might have
been discarded.

Another parse error found by zzuf. Don't crash when we find early EOF.

Example crasher: stap -e 'probe begin { for (i = 0; i++;'

Parse errors found by zzuf. Don't crash when we find early EOF.

Add cvs add && cvs commit operations for the tapset/ directory

*scripts/update-docs: add missing cvs operations for tapset files

run-staprun: Preserve the user PATH and HOME

Just for convenience, keeps PATH and HOME as the user's to make sure
-c CMD has a normal non-root environment.

Add options to help benchmark SDT

These are secret, undocumented, for developer use only.  Use stap
inception-style as the -c CMD of a stap which probes the SDT mark
process.provider("stap").mark("benchmark").

  --benchmark-sdt-loops=N
        Loop over the SDT probe point N times.

  --benchmark-sdt-threads=N
        Run the loop simultaneously in N threads.

stapdyn: fix the context->data_index

This regressed in commit c08bf9de, which lost the initialization of that
field.  Thus there was a data race in pmaps, stats, etc. in writing to
data_index 0, rather than the true index of the currently-owned context.

Do module cleanup in testsuite/systemtap.base/pr10854.exp.

Better process cleanup in testsuite/systemtap.server/client.exp.

Merge branch 'master' of git://sourceware.org/git/systemtap

Change directories regardless if the patch was applied or or not

*scripts/spine-rawhide: if the patch wasn't applied, then we wouldn't
change directories, breaking the rest of the script

Better process/module cleanup in rename_module.exp.

Fix sed command and some whitespace

*scripts/spin-rawhide: sed command fix and whitespace

docs: adapt to publican 3.0's more picky revnumber rules

* doc/SystemTap_Beginners_Guide/en-US/Revision_History.xml
  Add a couple of -1's, just because.

Avoid tcl errors on systems without uprobes in labels.exp.

Backport some spec file changes from fedora-git

*systemtap.spec: some architecture specific conditions would be clobbered in
 fedora with the spin-rawhide script was run, lets avoid that

Allow spin-rawhide to update systemtap.spec with upstream changes

*scripts/spin-rawhide: add diff between spec files and prompt if
       there are changes and if the user would like
       to patch the sytemtap.spec file.  Alter
       changelog entry accordingly

Tweak the hash_add_buildid.exp/perf.exp testcases to avoid zombie processes.

systemtap.spec: move some -server install scripting to %post

Specifically, the creation of the ~stap-server/.systemtap/rc file
should be attempted only after the files/directories have been created
and the stap-server account made.  Also, rpm-visibly create the
~stap-server/.systemtap subdirectory.

testsuite: impose stap --rlimit-cpu=300 throughout

Use the testsuite/.systemtap-*/rc file to impose cpu limits on stap
processes, considering PR15144 (which results in a spinning/hung
stapdyn child process).

stapdyn: Use the notification FD with Dyninst 8.1

BZ863832 systemtap.spec, for useradd stap-server, don't use -m

The spec file now contains the %dir for %{_localstatedir}/stap-server,
so useradd need not attempt the mkdir at all.

PR15237: adapt to hlist_* changes in linux 3.9

* runtime/linux/autoconf-hlist-4args.c: New test.
* buildrun.cxx (compile_pass): Run it to set STAPCONF_HLIST_4ARGS.
* runtime/linux/runtime.h: Use it to define stap_hlist_* the old way
  or the new.
* runtime/*: Adapt by going through new stap_hlist* iterators.
* runtime/uprobes*/*: Don't bother adapting this old-kernel-only code base.

regex testcase: run only if installtest_p

Add '-std=c++11' compile flag to stapdyn, required by latest dyninst.

* stapdyn/Makefile.am: Added '-std=c++11' compile flag, required by dyninst.
* stapdyn/Makefile.in: Regenerated.
* stapdyn/dynsdt.cxx: C++11 mode requires spaces between concatenated
  strings.
* stapdyn/dynprobe.cxx: Change 'typeof' to '__typeof__', since 'typeof'
  doesn't exist in '-std=c++11' mode.
* stapdyn/mutator.cxx: Ditto.
* stapdyn/mutator.h: Ditto.
* testsuite/configure: Regenerated.

blacklist more unsafe functions

These were found empirically. Some of the functions look innocent but
they are called from functions marked with __kprobes so they still
cause crashes. Further analysis is available at
https://lkml.org/lkml/2013/2/27/82 ("kprobing "hash_64.constprop.26"
crashes the system, recursion through get_kprobe?").

manpager: fix warnings by adding breaks between SEE ALSO references

This patch fixes the following warnings from man:

usr/share/man/man3/tapset::ansi.3stap.gz 99: warning [p 2, 1.8i]: cannot adjust line
usr/share/man/man3/tapset::context-unwind.3stap.gz 48: warning [p 1, 7.0i]: cannot adjust line
usr/share/man/man3/tapset::conversions-guru.3stap.gz 67: warning [p 1, 8.8i]: cannot adjust line
usr/share/man/man3/tapset::conversions.3stap.gz 109: warning [p 2, 3.5i]: cannot adjust line
usr/share/man/man3/tapset::inet_sock.3stap.gz 27: warning [p 1, 3.8i]: cannot adjust line
usr/share/man/man3/tapset::ioblock.3stap.gz 53: warning [p 1, 7.3i]: cannot adjust line
usr/share/man/man3/tapset::ioscheduler.3stap.gz 118: warning [p 2, 4.8i]: cannot adjust line
usr/share/man/man3/tapset::ipmib.3stap.gz 139: warning [p 2, 6.8i]: cannot adjust line
usr/share/man/man3/tapset::irq.3stap.gz 77: warning [p 1, 10.0i]: cannot adjust line
usr/share/man/man3/tapset::kprocess.3stap.gz 64: warning [p 1, 9.0i]: cannot adjust line
usr/share/man/man3/tapset::linuxmib.3stap.gz 43: warning [p 1, 5.8i]: cannot adjust line
usr/share/man/man3/tapset::memory.3stap.gz 142: warning [p 2, 7.7i]: cannot adjust line
usr/share/man/man3/tapset::netfilter.3stap.gz 75: warning [p 1, 10.7i]: cannot adjust line
usr/share/man/man3/tapset::networking.3stap.gz 134: warning [p 2, 6.2i]: cannot adjust line
usr/share/man/man3/tapset::nfs.3stap.gz 191: warning [p 3, 1.8i]: cannot adjust line
usr/share/man/man3/tapset::nfs_proc.3stap.gz 143: warning [p 2, 7.2i]: cannot adjust line
usr/share/man/man3/tapset::proc_mem.3stap.gz 139: warning [p 2, 7.3i]: cannot adjust line
usr/share/man/man3/tapset::queue_stats.3stap.gz 105: warning [p 2, 2.3i]: cannot adjust line
usr/share/man/man3/tapset::rpc.3stap.gz 163: warning [p 2, 9.8i]: cannot adjust line
usr/share/man/man3/tapset::scheduler.3stap.gz 143: warning [p 2, 7.2i]: cannot adjust line
usr/share/man/man3/tapset::signal.3stap.gz 290: warning [p 4, 4.2i]: cannot adjust line
usr/share/man/man3/tapset::socket.3stap.gz 206: warning [p 3, 5.2i]: cannot adjust line
usr/share/man/man3/tapset::stap_staticmarkers.3stap.gz 243: warning [p 3, 8.2i]: cannot adjust line
usr/share/man/man3/tapset::stopwatch.3stap.gz 67: warning [p 1, 8.8i]: cannot adjust line
usr/share/man/man3/tapset::target_set.3stap.gz 27: warning [p 1, 3.8i]: cannot adjust line
usr/share/man/man3/tapset::task.3stap.gz 161: warning [p 2, 9.0i]: cannot adjust line
usr/share/man/man3/tapset::task_time.3stap.gz 98: warning [p 2, 2.2i]: cannot adjust line
usr/share/man/man3/tapset::tcp.3stap.gz 90: warning [p 2, 0.8i]: cannot adjust line
usr/share/man/man3/tapset::tcpmib.3stap.gz 123: warning [p 2, 4.8i]: cannot adjust line
usr/share/man/man3/tapset::timestamp_gtod.3stap.gz 43: warning [p 1, 5.8i]: cannot adjust line
usr/share/man/man3/tapset::timestamp_monotonic.3stap.gz 79: warning [p 1, 10.2i]: cannot adjust line
usr/share/man/man3/tapset::ucontext-unwind.3stap.gz 35: warning [p 1, 5.0i]: cannot adjust line
usr/share/man/man3/tapset::uconversions.3stap.gz 253: warning [p 3, 10.7i]: cannot adjust line
usr/share/man/man3/tapset::udp.3stap.gz 66: warning [p 1, 9.3i]: cannot adjust line

Makefile.in: regenerate

Makefile.am: don't install html *.tmpl files

The files

/usr/share/doc/systemtap-client-2.2/examples/html/html_header.tmpl
/usr/share/doc/systemtap-client-2.2/examples/html/html_footer.tmpl

are completely unnecessary to the end-user.

stapdyn: add LDADD=-lpthread

It seems some stapdyn-* objects make mysterious refs to pthreads
(due to __GTHREADS coming to be defined in std::string<> somehow).

PR 15193: assigned_user_credentials = pr_stapdev

Assign a privilege level of pr_all (was pr_stapdev) to the user
when loading a module from /lib/modules/`uname -r`/systemtap.

Fix PR15211 by updating the testsuite for kernel 3.8.

* testsuite/systemtap.syscall/openclose.c: Handle 'creat()' being mapped
  to 'creat()' or 'open(FILE, O_CREAT)' in the kernel.
* testsuite/systemtap.syscall/stat.c: Ditto.
* testsuite/systemtap.syscall/test.tcl: Map '!!!!' to '|'.
* testsuite/systemtap.syscall/README: Document the new '!!!!' substitute
  for '|'.

doc/tutorial.tex: Use ppfunc() instead of probefunc() in examples.

adieu runtime/bench2

This was a runtime performance benchmarking suite, not needed/used in years.

tapset/test, adieu

This was a very old testsuite, not needed nor used in years.

stap-report: also look for vmlinux under /lib/modules/.../build

Fix PR15197 by updating syscall.fork/nd_syscall.fork to handle the 3.8 kernel.

* tapset/linux/syscalls.stp: Handle removal of the 'regs' argument to
  do_fork() in kernel 3.8.0. Deprecate the 'regs' variable.
* tapset/linux/nd_syscalls.stp: Ditto.
* testsuite/buildok/syscalls-detailed.stp: Handle 'regs' variable deprecation.
* testsuite/buildok/nd_syscalls-detailed.stp: Ditto.
* NEWS: Mention deprecations.

PR15177 fix:  RHEL4 doesn't define SEEK_{SET,CUR,END} in kernel headers.

* tapset/linux/aux_syscalls.stp: Define SEEK_{SET,CUR,END} if not defined.

configure/Makefile: regenerate

Makefile.am: remove temporary symlinks in distclean

configure.ac: remove temporary file after test

Fix PR15198 by handling new kernel option CONFIG_GENERIC_SIGALTSTACK.

* tapset/linux/syscalls2.stp: Added generic 'sigaltstack' probe alias for
  when CONFIG_GENERIC_SIGALTSTACK is set.
* tapset/linux/nd_syscalls2.stp: Ditto.
* tapset/linux/s390/nd_syscalls.stp: Added 'nd_syscall.sigaltstack',
  'nd_syscall.sigaltstack.return', 'nd_syscall.sys32_sigaltstack', and
  'nd_syscall.sys32_sigaltstack.return' probe aliases.
* tapset/linux/i386/syscalls.stp: Only use arch-specific 'sigaltstack'
  probe alias if CONFIG_GENERIC_SIGALTSTACK isn't set. Deprecate 'regs'
  variable.
* tapset/linux/ia64/syscalls.stp: Ditto.
* tapset/linux/powerpc/nd_syscalls.stp: Ditto.
* tapset/linux/powerpc/syscalls.stp: Ditto.
* tapset/linux/s390/syscalls.stp: Ditto.
* tapset/linux/x86_64/nd_syscalls.stp: Ditto.
* tapset/linux/x86_64/syscalls.stp: Ditto.
* tapset/linux/i386/nd_syscalls.stp: Only use arch-specific 'sigaltstack'
  probe alias if CONFIG_GENERIC_SIGALTSTACK isn't set.
* tapset/linux/ia64/nd_syscalls.stp: Ditto.
* testsuite/buildok/syscalls-arch-detailed.stp: Only test
  the arch-specific 'sigaltstack' probe alias if
  CONFIG_GENERIC_SIGALTSTACK is not set. Handle 'regs' deprecation.
* testsuite/buildok/syscalls-arch-detailed.stp: Ditto.
* testsuite/buildok/syscalls2-detailed.stp: Added generic 'sigaltstack'
  probe alias test for when CONFIG_GENERIC_SIGALTSTACK is set.
* testsuite/buildok/nd_syscalls2-detailed.stp: Ditto.
* NEWS: Mention 'regs' deprecation.

Fix cp option in update-docs

*scripts/update-docs - cp -R not cp -r

Fix PR15177 by handling new 'whence' values SEEK_DATA and SEEK_HOLE.

* tapset/linux/aux_syscalls.stp (_seek_whence_str): Updated to handle
  SEEK_DATA and SEEK_HOLE.
* tapset/linux/nfs.stp (nfs.fop.llseek): Changed comment to remove
  description of individual 'whence' values.

loc2c-test - prepending '@' before a function name returns breakpoint entry

*loc2c-test.c - check for '@' character, and alter which entry point address
        is used.

stappaths.7: eschew spaced-out period

Add missing "#!/usr/bin/env stap" to some examples

man stappaths.7: properly escape dot in the beginning of the line

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

Add missing executable bit to example scripts

man: escape quote properly in header

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

man stapprobes.3stap: escape minus sign properly

remove executable bit from stapgames tapset

Files in a tapset can not be executed so the bit serves no purpose.

man stap.1: fix typo

man stap.1: escape minus sign properly