commit 4bc9928e18ee06daded08806eccbb880de085f9f
parent 10c296e94ef2d1c5947cc11ac46f9aeb8a653bb6
Author: Thien-Thi Nguyen <ttn@gnuvola.org>
Date: Fri, 15 Jan 2021 21:25:26 -0500
taler-exchange-offline(1): document ‘show -’; add example variant
This is the result of email discussion 2021-01-05.
Diffstat:
1 file changed, 9 insertions(+), 0 deletions(-)
diff --git 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)
-------------------------------------------------
