[tor-commits] [stem/master] Discuss tor-prompt's new --run argument in the tutorials

[atagar at torproject.org]

commit 7a1998b3421b7b614bd2e186dd1e7e6cb674dc5c
Author: Damian Johnson <atagar at torproject.org>
Date:   Sat Apr 29 11:57:31 2017 -0700

    Discuss tor-prompt's new --run argument in the tutorials
---
 docs/_static/prompt/run.png             | Bin 0 -> 9968 bytes
 docs/_static/prompt/run_events.png      | Bin 0 -> 22204 bytes
 docs/_static/prompt/run_events_pipe.png | Bin 0 -> 21586 bytes
 docs/tutorials/down_the_rabbit_hole.rst |  19 +++++++++++++++++++
 4 files changed, 19 insertions(+)

diff --git a/docs/_static/prompt/run.png b/docs/_static/prompt/run.png
new file mode 100644
index 0000000..c92351f
Binary files /dev/null and b/docs/_static/prompt/run.png differ
diff --git a/docs/_static/prompt/run_events.png b/docs/_static/prompt/run_events.png
new file mode 100644
index 0000000..e4aef28
Binary files /dev/null and b/docs/_static/prompt/run_events.png differ
diff --git a/docs/_static/prompt/run_events_pipe.png b/docs/_static/prompt/run_events_pipe.png
new file mode 100644
index 0000000..605df64
Binary files /dev/null and b/docs/_static/prompt/run_events_pipe.png differ
diff --git a/docs/tutorials/down_the_rabbit_hole.rst b/docs/tutorials/down_the_rabbit_hole.rst
index 709f596..7dac01c 100644
--- a/docs/tutorials/down_the_rabbit_hole.rst
+++ b/docs/tutorials/down_the_rabbit_hole.rst
@@ -113,3 +113,22 @@ receive events of those types (for instance, **events('BW', 'DEBUG')**).
 To stop receiving events run **SETEVENTS** without any event types, and to
 clear the backlog of events we've received run **/events clear**.
 
+.. _running-individual-commands:
+
+Running individual commands
+---------------------------
+
+With its **--run** argument tor-prompt can also be used to run individual
+commands...
+
+.. image:: /_static/prompt/run.png
+
+... listen to a space separated list of events with **--run 'SETEVENTS
+[event_types]'**...
+
+.. image:: /_static/prompt/run_events.png
+
+... and pipe its output to other locations...
+
+.. image:: /_static/prompt/run_events_pipe.png
+