# [PATCH v3] Documentation/gitk: Document new config file location

2 messages from 2014-03-20 to 2014-03-20. Participants: Astril Hayato, Junio C Hamano.
Thread: https://gitlist.dev/t/36249

## Astril Hayato, 2014-03-20 13:33

Subject: [PATCH v3] Documentation/gitk: Document new config file location
Message-ID: <1395322429-1501-1-git-send-email-astrilhayato@gmail.com>
URL: https://gitlist.dev/e/1395322429-1501-1-git-send-email-astrilhayato%40gmail.com

```
User config file location now complies with the XDG base directory specification

Signed-off-by: Astril Hayato <astrilhayato@gmail.com>
---
 Documentation/gitk.txt | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/Documentation/gitk.txt b/Documentation/gitk.txt
index 1e9e38a..7e03fcc 100644
--- a/Documentation/gitk.txt
+++ b/Documentation/gitk.txt
@@ -166,8 +166,14 @@ gitk --max-count=100 --all \-- Makefile::
 
 Files
 -----
-Gitk creates the .gitk file in your $HOME directory to store preferences
-such as display options, font, and colors.
+User configuration and preferences are stored at:
+
+* '$XDG_CONFIG_HOME/git/gitk' if it exists, otherwise
+* '$HOME/.gitk' if it exists
+
+If neither of the above exist then '$XDG_CONFIG_HOME/git/gitk' is created and
+used by default. If '$XDG_CONFIG_HOME' is not set it defaults to
+'$HOME/.config' in all cases.
 
 History
 -------
-- 
1.9.0

```

## Junio C Hamano, 2014-03-20 18:01

Subject: Re: [PATCH v3] Documentation/gitk: Document new config file location
Message-ID: <xmqqy504yckj.fsf@gitster.dls.corp.google.com>
URL: https://gitlist.dev/e/xmqqy504yckj.fsf%40gitster.dls.corp.google.com
In-Reply-To: <1395322429-1501-1-git-send-email-astrilhayato@gmail.com>

```
Astril Hayato <astrilhayato@gmail.com> writes:

> User config file location now complies with the XDG base directory specification
>
> Signed-off-by: Astril Hayato <astrilhayato@gmail.com>
> ---
>  Documentation/gitk.txt | 10 ++++++++--
>  1 file changed, 8 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/gitk.txt b/Documentation/gitk.txt
> index 1e9e38a..7e03fcc 100644
> --- a/Documentation/gitk.txt
> +++ b/Documentation/gitk.txt
> @@ -166,8 +166,14 @@ gitk --max-count=100 --all \-- Makefile::
>  
>  Files
>  -----
> -Gitk creates the .gitk file in your $HOME directory to store preferences
> -such as display options, font, and colors.
> +User configuration and preferences are stored at:
> +
> +* '$XDG_CONFIG_HOME/git/gitk' if it exists, otherwise
> +* '$HOME/.gitk' if it exists
> +
> +If neither of the above exist then '$XDG_CONFIG_HOME/git/gitk' is created and
> +used by default. If '$XDG_CONFIG_HOME' is not set it defaults to
> +'$HOME/.config' in all cases.

Thanks; looks good.

```
