path: root/manpages
diff options
authorThien-Thi Nguyen <>2021-01-15 21:25:26 -0500
committerThien-Thi Nguyen <>2021-01-15 21:28:46 -0500
commit4bc9928e18ee06daded08806eccbb880de085f9f (patch)
tree8772a9c8a659fbc609ad1c60c240d9a1eedf6d8c /manpages
parent10c296e94ef2d1c5947cc11ac46f9aeb8a653bb6 (diff)
taler-exchange-offline(1): document ‘show -’; add example variant
This is the result of email discussion 2021-01-05.
Diffstat (limited to 'manpages')
1 files changed, 9 insertions, 0 deletions
diff --git a/manpages/taler-exchange-offline.1.rst b/manpages/taler-exchange-offline.1.rst
index 793a00f..1c901b8 100644
--- a/manpages/taler-exchange-offline.1.rst
+++ b/manpages/taler-exchange-offline.1.rst
@@ -116,6 +116,9 @@ other parameters.
It consumes the output of the ``download`` subcommand, either from ``stdin`` or
+However, if given arg ``-`` (hyphen), this input is not consumed,
+but instead is passed to the next command. This functions like the
+tee(1) command.
Its output always goes to ``stdout`` for human consumption (not in JSON). It
is usually a bad idea (but possible) to combine ``show`` with other subcommands,
@@ -323,6 +326,12 @@ Note that doing this is only recommended in non-production deployments.
$ taler-exchange-offline download sign upload
+Here is a variant that shows the output of ``download``, but does not consume it,
+so that ``sign`` can see it as input, as in the variant without ``show``.
+.. code-block:: console
+ $ taler-exchange-offline download show - sign upload
Create signature to enable bank account (offline)