taler-docs

commit 160792e02e8450e5dabb3bbdd3b5b7267e254a6c
parent cd8a3898fdd4e77b7da69f4563f9f64545505e47
Author: Thien-Thi Nguyen <ttn@gnuvola.org>
Date:   Wed,  9 Dec 2020 03:52:55 -0500

document ‘@INLINE@’ as it pertains to taler.conf(5)

Diffstat:
M
manpages/taler.conf.5.rst
 | 
9
+++++----

1 file changed, 5 insertions(+), 4 deletions(-)
diff --git a/manpages/taler.conf.5.rst b/manpages/taler.conf.5.rst
@@ -34,10 +34,6 @@ This can be simple, such as ``$TMPDIR/foo``, or complex,
 such as ``${TMPDIR:-${TMP:-/tmp}}/foo``.
 See ``[PATHS]`` (below).
 
-.. 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 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``.
 
@@ -49,6 +45,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
 --------------