[taler-docs] 03/05: add frag: using-taler-config.rst

[gnunet]

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

ttn pushed a commit to branch master
in repository docs.

commit 207adf498816ab5b033b8c1f51c94aeeb6a6d344
Author: Thien-Thi Nguyen <ttn@gnuvola.org>
AuthorDate: Fri Dec 11 00:52:20 2020 -0500

    add frag: using-taler-config.rst
---
 frags/using-taler-config.rst | 53 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/frags/using-taler-config.rst b/frags/using-taler-config.rst
new file mode 100644
index 0000000..d7c28b2
--- /dev/null
+++ b/frags/using-taler-config.rst
@@ -0,0 +1,53 @@
+.. _Using-taler_002dconfig-exchange:
+
+Using taler-config
+------------------
+
+The tool ``taler-config`` can be used to extract or manipulate
+configuration values; however, the configuration use the well-known INI
+file format and can also be edited by hand.
+
+Run
+
+.. code-block:: console
+
+   $ taler-config -s $SECTION
+
+to list all of the configuration values in section ``$SECTION``.
+
+Run
+
+.. code-block:: console
+
+   $ taler-config -s $section -o $option
+
+to extract the respective configuration value for option ``$option`` in
+section ``$section``.
+
+Finally, to change a setting, run
+
+.. code-block:: console
+
+   $ taler-config -s $section -o $option -V $value
+
+to set the respective configuration value to ``$value``. Note that you
+have to manually restart the Taler backend after you change the
+configuration to make the new configuration go into effect.
+
+Some default options will use $-variables, such as ``$DATADIR`` within
+their value. To expand the ``$DATADIR`` or other $-variables in the
+configuration, pass the ``-f`` option to ``taler-config``. For example,
+compare:
+
+.. code-block:: console
+
+   $ taler-config -s ACCOUNT-bank \
+                  -o WIRE_RESPONSE
+   $ taler-config -f -s ACCOUNT-bank \
+                  -o WIRE_RESPONSE
+
+While the configuration file is typically located at
+``$HOME/.config/taler.conf``, an alternative location can be specified
+to ``taler-merchant-httpd`` and ``taler-config`` using the ``-c``
+option.
+

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