From 4bc9928e18ee06daded08806eccbb880de085f9f Mon Sep 17 00:00:00 2001 From: Thien-Thi Nguyen Date: Fri, 15 Jan 2021 21:25:26 -0500 Subject: taler-exchange-offline(1): document ‘show -’; add example variant MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This is the result of email discussion 2021-01-05. --- manpages/taler-exchange-offline.1.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/manpages/taler-exchange-offline.1.rst b/manpages/taler-exchange-offline.1.rst index 793a00fc..1c901b8c 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) ------------------------------------------------- -- cgit v1.2.3