diff --git a/docs/basics/101-122-config.rst b/docs/basics/101-122-config.rst index 433553276..1bcace10a 100644 --- a/docs/basics/101-122-config.rst +++ b/docs/basics/101-122-config.rst @@ -295,6 +295,21 @@ remaining sections in that file, and the :ref:`that dissects this config file fu Lastly, the ``annex-ignore = false`` configuration allows git-annex to query the remote when it tries to retrieve data from annexed content. +.. index:: + pair: configuration; DataLad command + pair: set configuration; with DataLad + +The ``datalad configuration`` command +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Although this section put a focus on the ``git config`` command, it is important to mention that there also is a :dlcmd:`configuration` command. +It is not identical to ``git config``, but while it lacks some feature of ``git config``, such as the ability to set system-wide configuration, it has additional features. +Beyond the ``local`` and ``global`` scopes, it also supports :term:`branch` specific configurations in the ``.datalad/config`` file (further discussed in the next section), setting configurations recursively through dataset hierarchies, and multi-configuration queries (such as ``datalad configuration get user.name user.email``). +By default, ``datalad configuration`` will ``dump`` (list) the effective configuration including relevant ``DATALAD_*`` :term:`environment variable`\s, and also annotate the purpose of many common configuration items. +The subcommands ``datalad configuration get`` or ``datalad configuration set`` perform queries or set configurations. +You can find out more information on this command in the command documentation. + + ``.git/config`` versus other (configuration) files ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^