added options for extensions and age restriction

1 files changed, 46 insertions, 0 deletions

diff --git a/manpages/taler.conf.5.rst b/manpages/taler.conf.5.rst
index f447ddec..8ab5f93a 100644
--- a/manpages/taler.conf.5.rst
+++ b/manpages/taler.conf.5.rst
@@ -265,6 +265,47 @@ WEBHOOK_AUTH_TOKEN
   Authentication token Persona must supply to our webhook. This is an optional setting.
 
 
+EXCHANGE EXTENSIONS OPTIONS
+---------------------------
+
+The functionality of the exchange can be extended by extensions.  Those are
+shared libraries which implement the extension-API of the exchange and are
+located under ``$LIBDIR``, starting with prefix ``libtaler_extension_``. Each
+extension can be enabled by adding a dedicated section
+"[exchange-extension-<extensionname>]" and the following option:
+
+ENABLED
+  If set to ``YES`` the extension ``<extensionsname>`` is enabled.  Extension-specific
+  options might be set in the same section.
+
+
+EXCHANGE EXTENSION FOR AGE RESTRICTION
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The extension for age restriction support can be enabled by adding a section
+"[exchange-extension-age_restriction]" with the following options:
+
+ENABLE
+  Must be set to ``YES`` in order to activate the extension.
+
+AGE_GROUPS
+  A colon-seperated string of increasing non-negative integers, defining the
+  buckets of age groups supported by the exchange.  Each integer marks the
+  beginning of the next age group.  The zero'th age group implicitely starts
+  with 0.  For example, the string "10:18" would define three age groups:
+
+    1. Group 0: ages 0 through 9 (including)
+    2. Group 1: ages 10 through 17 (including)
+    3. Group 2: ages 18 and above
+
+  If not provided, the default value is "8:10:12:14:16:18:21".
+
+**Note**: Age restriction is bound to specific denominations and must be
+enabled for each selected denomination in the corresponding section by adding
+the option ``AGE_RESTRICTED = YES``, see `EXCHANGE COIN OPTIONS`_. However, the
+age groups are defined globally for all denominations.
+
+
 
 EXCHANGE OFFLINE SIGNING OPTIONS
 --------------------------------
@@ -508,6 +549,11 @@ CIPHER
 RSA_KEYSIZE
    What is the RSA keysize modulos (in bits)?  Only used if "CIPHER=RSA".
 
+AGE_RESTRICTED
+   Setting this option to ``YES`` marks the denomination as age restricted
+   (default is ``NO``).  For this option to be accepted the extension for age
+   restriction MUST be enabled (see `EXCHANGE EXTENSION FOR AGE RESTRICTION`_).
+
 
 MERCHANT OPTIONS
 ----------------