[taler-docs] branch master updated (6297507 -> ba6ff4d)

[gnunet]

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

ttn pushed a change to branch master
in repository docs.

    from 6297507  upcase ‘Global Options’
     new c5b6729  give "can include whitespace" as reason for quoting
     new cd8a389  document /bin/sh-like variable reference in filenames
     new 160792e  document ‘@INLINE@’ as it pertains to taler.conf(5)
     new ba6ff4d  add comment re escaping mechanism (PTAL)

The 4 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 manpages/taler.conf.5.rst | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/manpages/taler.conf.5.rst b/manpages/taler.conf.5.rst
index 2c86ca2..8a65349 100644
--- a/manpages/taler.conf.5.rst
+++ b/manpages/taler.conf.5.rst
@@ -25,11 +25,16 @@ Section names and options are *case-insensitive*.
 
 The values, however, are *case-sensitive*.
 In particular, boolean values are one of ``YES`` or ``NO``.
-Values can be quoted by surrounding them with ``"`` (double quote).
+Values can include whitespace by surrounding
+the entire value with ``"`` (double quote).
+.. From reading source, IIUC there is no escaping mechanism.
+   What am i missing?  --ttn
 
-.. The @INLINE@ feature should remain undocumented since in practice, using
-   it (even correctly) elicits a warning and does not actually include the
-   specified file.  Maybe this will change in the future?  --ttn
+Values that represent filenames can begin with a ``/bin/sh``-like
+variable reference.
+This can be simple, such as ``$TMPDIR/foo``, or complex,
+such as ``${TMPDIR:-${TMP:-/tmp}}/foo``.
+See ``[PATHS]`` (below).
 
 Values that represent a time duration are represented as a series of one or
 more ``NUMBER UNIT`` pairs, e.g. ``60 s``, ``4 weeks 1 day``, ``5 years 2 
minutes``.
@@ -42,6 +47,11 @@ are installed under ``$TALER_PREFIX/share/taler/config.d/``.
 The configuration file given with **-c** to Taler binaries
 overrides these defaults.
 
+A configuration file may include another, by using the ``@INLINE@`` directive,
+for example, in ``main.conf``, you could write ``@INLINE@ sub.conf`` to
+include the entirety of ``sub.conf`` at that point in ``main.conf``.
+.. TODO: Document ‘taler-config -V’ in light of ‘@INLINE@’ in taler-config(1).
+
 GLOBAL OPTIONS
 --------------
 

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