Documentation/gitk: document the location of the configulation file
authorAstril Hayato <astrilhayato@gmail.com>
Thu, 20 Mar 2014 13:33:49 +0000 (13:33 +0000)
committerJunio C Hamano <gitster@pobox.com>
Thu, 20 Mar 2014 17:59:55 +0000 (10:59 -0700)
User config file location complies with the XDG base directory
specification while supporting the traditional $HOME/.gitk as a
fallback.

Signed-off-by: Astril Hayato <astrilhayato@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/gitk.txt
index 1e9e38ae40e8396af82c2d6f47d3e8e8508a921d..7e03fcc62d1a388552cdd1e92f75183c0278cf28 100644 (file)
@@ -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
 -------