[taler-docs] branch master updated: document ‘connections’; reorder its subcommands to be roughly in "order of use"

[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 690853e  document ‘connections’; reorder its subcommands to be roughly 
in "order of use"
690853e is described below

commit 690853e82d9576b37d69bf4376f729cd6ff26614
Author: Thien-Thi Nguyen <ttn@gnuvola.org>
AuthorDate: Thu Feb 24 06:26:10 2022 -0500

    document ‘connections’; reorder its subcommands to be roughly in "order of 
use"
---
 manpages/libeufin-cli.1.rst | 72 ++++++++++++++++++++++++++++++---------------
 1 file changed, 48 insertions(+), 24 deletions(-)

diff --git a/manpages/libeufin-cli.1.rst b/manpages/libeufin-cli.1.rst
index 44d8552..894d9ae 100644
--- a/manpages/libeufin-cli.1.rst
+++ b/manpages/libeufin-cli.1.rst
@@ -543,60 +543,84 @@ Note that ``--bank-account jrluser`` is the same as in the
 connections
 -----------
 
-WRITEME
-
-connections download-bank-accounts
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+The ``connections`` set of commands handle connections between
+the bank(s) and Nexus.
+It has several subcommands:
+new-ebics-connection,
+list-connections,
+show-connection,
+delete-connection,
+export-backup,
+restore-backup,
+get-key-letter,
+connect,
+list-offered-bank-accounts,
+download-bank-accounts,
+import-bank-account.
+
+Generally, you will create a connection, save its critical key information
+to a safe location, then use the connection to find and import a bank
+account, for further use.
+
+Several commands take a ``CONNECTION_NAME`` argument.
+In the following examples, we use ``conn01`` for that.
+Also, for demonstration purposes, we use the sandbox EBICS services,
+so the ``EBICS_URL`` follows the previous examples in the ``sandbox``
+command, as the value of environment variable ``LIBEUFIN_SANDBOX_URL``
+suffixed with ``/ebicsweb``, i.e., ``http://localhost:5016/ebicsweb``.
+
+new-ebics-connection
+^^^^^^^^^^^^^^^^^^^^
 
 WRITEME
 
-connections delete-connection
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+list-connections
+^^^^^^^^^^^^^^^^
 
 WRITEME
 
-connections connect
-^^^^^^^^^^^^^^^^^^^
+show-connection
+^^^^^^^^^^^^^^^
 
 WRITEME
 
-connections export-backup
-^^^^^^^^^^^^^^^^^^^^^^^^^
+delete-connection
+^^^^^^^^^^^^^^^^^
 
 WRITEME
 
-connections get-key-letter
-^^^^^^^^^^^^^^^^^^^^^^^^^^
+export-backup
+^^^^^^^^^^^^^
 
 WRITEME
 
-connections import-bank-account
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+restore-backup
+^^^^^^^^^^^^^^
 
 WRITEME
 
-connections list-connections
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+get-key-letter
+^^^^^^^^^^^^^^
 
 WRITEME
 
-connections list-offered-bank-accounts
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+connect
+^^^^^^^
 
 WRITEME
 
-connections new-ebics-connection
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+list-offered-bank-accounts
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 WRITEME
 
-connections restore-backup
-^^^^^^^^^^^^^^^^^^^^^^^^^^
+download-bank-accounts
+^^^^^^^^^^^^^^^^^^^^^^
 
 WRITEME
 
-connections show-connection
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
+import-bank-account
+^^^^^^^^^^^^^^^^^^^
 
 WRITEME
 

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