Skip to content

Commit

Permalink
configuration_manual/config_file: Explain setting names with same as …
Browse files Browse the repository at this point in the history
…prefix as named filters
  • Loading branch information
sirainen committed Jan 2, 2024
1 parent 01c90db commit 1e8268c
Showing 1 changed file with 21 additions and 0 deletions.
21 changes: 21 additions & 0 deletions source/configuration_manual/config_file/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,27 @@ looked up using the named filter called ``mail_attribute``. Note that named
filters cannot have a name before the ``{``, i.e. ``mail_attribute foo {``
will result in an error.

Setting names that begin with the same prefix as a named filter will be
treated as if they belong inside the named filter. For example all these
settings are equivalent and modify the exact same setting:

.. code-block:: none
auth_policy_server_url = example.com
auth_policy {
server_url = example.com
auth_policy_server_url = example.com
}
Regardless of which method is used in ``dovecot.conf``, the ``doveconf``
output will be:

.. code-block:: none
auth_policy {
server_url = example.com
}
Named list filters are similar to named filters, except there can be many of
them, each with a unique name. For example:

Expand Down

0 comments on commit 1e8268c

Please sign in to comment.