[taler-docs] branch master updated: fix #7013

[gnunet]

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

grothoff pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new 92103b6  fix #7013
92103b6 is described below

commit 92103b665325185133719a5cc5017940baa7df2c
Author: Christian Grothoff <grothoff@gnunet.org>
AuthorDate: Tue Apr 18 18:32:17 2023 +0200

    fix #7013
---
 frags/common-conf-syntax.rst | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/frags/common-conf-syntax.rst b/frags/common-conf-syntax.rst
index 3d83717..2740b16 100644
--- a/frags/common-conf-syntax.rst
+++ b/frags/common-conf-syntax.rst
@@ -30,3 +30,33 @@ of one or more ``NUMBER UNIT`` pairs, e.g. ``60 s``, ``4 
weeks 1 day``,
 Values that represent an amount are in the usual amount syntax:
 ``CURRENCY:VALUE.FRACTION``, e.g. ``EUR:1.50``.
 The ``FRACTION`` portion may extend up to 8 places.
+
+
+The “[PATHS]” section is special in that it contains paths that can be
+referenced using “$” in other configuration values that specify
+*filenames*. Note that configuration options that are not specifically
+retrieved by the application as *filenames* will not see “$”-expressions
+expanded. To expand “$”-expressions when using ``taler-config``, you must pass
+the ``-f`` command-line option.
+
+The system automatically pre-populates the “[PATHS]” section with a few values
+at run-time in addition to the values that are in the actual configuration
+file.  These automatically generated values refer to installation properties
+from `GNU autoconf
+<https://www.gnu.org/prep/standards/html_node/Directory-Variables.html>`_. The
+values are usually dependent on an ``INSTALL_PREFIX`` which is determined by
+the ``--prefix`` option given to configure.  The canonical values are:
+
+  * LIBEXECDIR = $INSTALL_PREFIX/taler/libexec/
+  * DOCDIR = $INSTALL_PREFIX/share/doc/taler/
+  * ICONDIR = $INSTALL_PREFIX/share/icons/
+  * LOCALEDIR = $INSTALL_PREFIX/share/locale/
+  * PREFIX = $INSTALL_PREFIX/
+  * BINDIR = $INSTALL_PREFIX/bin/
+  * LIBDIR = $INSTALL_PREFIX/lib/taler/
+  * DATADIR = $INSTALL_PREFIX/share/taler/
+
+Note that on some platforms, the given paths may differ depending
+on how the system was compiled or installed, the above are just the
+canonical locations of the various resources.
+

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