summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThien-Thi Nguyen <ttn@gnuvola.org>2021-01-15 21:25:26 -0500
committerThien-Thi Nguyen <ttn@gnuvola.org>2021-01-15 21:28:46 -0500
commit4bc9928e18ee06daded08806eccbb880de085f9f (patch)
tree8772a9c8a659fbc609ad1c60c240d9a1eedf6d8c
parent10c296e94ef2d1c5947cc11ac46f9aeb8a653bb6 (diff)
downloaddocs-4bc9928e18ee06daded08806eccbb880de085f9f.tar.gz
docs-4bc9928e18ee06daded08806eccbb880de085f9f.tar.bz2
docs-4bc9928e18ee06daded08806eccbb880de085f9f.zip
taler-exchange-offline(1): document ‘show -’; add example variant
This is the result of email discussion 2021-01-05.
-rw-r--r--manpages/taler-exchange-offline.1.rst9
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
directly.
+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)
-------------------------------------------------