Skip to content

Commit

Permalink
Merge pull request #1189 from datalad-handbook/datalad-configuration
Browse files Browse the repository at this point in the history
mention datalad-configuration command
  • Loading branch information
adswa authored Nov 14, 2023
2 parents 8f2eada + a815ff3 commit 07f62d0
Showing 1 changed file with 15 additions and 0 deletions.
15 changes: 15 additions & 0 deletions docs/basics/101-122-config.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Expand Down

0 comments on commit 07f62d0

Please sign in to comment.