[taler-docs] branch master updated: taler-exchange-offline(1): document ‘show -’; add example variant

[gnunet]

This is an automated email from the git hooks/post-receive script.

ttn pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new 4bc9928  taler-exchange-offline(1): document ‘show -’; add example 
variant
4bc9928 is described below

commit 4bc9928e18ee06daded08806eccbb880de085f9f
Author: Thien-Thi Nguyen <ttn@gnuvola.org>
AuthorDate: Fri Jan 15 21:25:26 2021 -0500

    taler-exchange-offline(1): document ‘show -’; add example variant
    
    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 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)
 -------------------------------------------------

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.