====== 'git' Configuration ======

\\
===== Initial Configuration =====

Before ''git'' is used for the first time on a machine, some global configuration settings for the git user should be made:

==== Configure The Default User Name And Email ====

<codedoc code>
git config ~~codedoc:clean:--~~global user.name  ~~codedoc:<em>"Martin Burnicki"</em>~~
git config ~~codedoc:clean:--~~global user.email ~~codedoc:<em>"martin.burnicki@burnicki.net"</em>~~
</codedoc>

\\
If a different email address is preferred for commits in a specific project,
the local configuration can be modfied to override the global default setting, e.g.
by running a command like this inside the project directory:

<codedoc code>
git config ~~codedoc:clean:--~~local user.email ~~codedoc:<em>"martin.burnicki@meinberg.de"</em>~~
</codedoc>


Alternatively, [[git_environment_and_overriding_settings#Using Environment Variables To Specify Author And Committer|environment variables can be used]]
to specify the author and committer name and email address.


\\
==== Configure The Preferred Visual Diff/Merge Tool ====

Also disable prompting when the diff/merge tool is called.

<codedoc code>
git config ~~codedoc:clean:--~~global merge.tool ~~codedoc:<em>meld</em>~~
git config ~~codedoc:clean:--~~global diff.tool ~~codedoc:<em>meld</em>~~
git config ~~codedoc:clean:--~~global ~~codedoc:clean:--~~add difftool.prompt false
</codedoc>

----

 --- //Martin Burnicki [[martin.burnicki@burnicki.net]], last updated 2021-07-29//