[docs] [issue28472] SystemTap usage examples in docs are incorrect

[Roman Podoliaka]

New submission from Roman Podoliaka:

There are a couple of errors in SystemTap examples from "Instrumenting CPython with DTrace and SystemTap" page (https://docs.python.org/dev/howto/instrumentation.html):

1) in SystemTap double quotes are used to denote string literals. As is examples fail with:

    parse error: expected literal string or number
            saw: operator ''' at show_call.stp:1:15
         source: probe process('python').mark("function__entry") {

2) stap -c option expects a command as a single string argument, not as a list of strings. As is the following example:

$ stap \
  show-call-hierarchy.stp \
  -c ./python test.py

will not run a test.py script, but instead ./python without any args, thus it will print a
prompt (i.e. >>>) and wait for user input.

----------
assignee: docs at python
components: Documentation
files: patch.diff
keywords: patch
messages: 278944
nosy: docs at python, rpodolyaka
priority: normal
severity: normal
status: open
title: SystemTap usage examples in docs are incorrect
versions: Python 3.6
Added file: http://bugs.python.org/file45138/patch.diff

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28472>
_______________________________________