← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/xdg_config_spec.txt

  • Committer: Vincent Ladeuil
  • Date: 2017-01-17 13:48:10 UTC
  • mfrom: (6615.3.6 merges)
  • mto: This revision was merged to the branch mainline in revision 6620.
  • Revision ID: v.ladeuil+lp@free.fr-20170117134810-j9p3lidfy6pfyfsc
Merge 2.7, resolving conflicts

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/xdg_config_spec.txt
 
1
Transitioning Unix installs to the XDG Base Directory Specification
 
2
===================================================================
 
3
 
 
4
Currently, Bazaar stores its configuration files and plugins under the
 
5
directory ~/.bazaar on unix installs. On Windows, this is %APPDATA%/Bazaar/2.0.
 
6
With the XDG Base Directory specification
 
7
(http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html), many
 
8
Linux and Unix platforms have tried to centralize configuration files under a
 
9
specific directory referred to as $XDG_CONFIG_HOME.  This has a default value
 
10
of ~/.config.
 
11
 
 
12
Bazaar would like to be a good Unix citizen by using these standard locations
 
13
for configuration files.  As such, we should support that location, but not
 
14
require it.  Note that the following descriptions do not apply
 
15
to Windows which should use their own native configuration
 
16
locations.  (On Windows, we currently do this by working under %APPDATA%.
 
17
 
 
18
* If $XDG_CONFIG_HOME/bazaar exists, use the files there for configuration,
 
19
  noting in the log that we are doing so.  This allows individuals who would
 
20
  like to use the XDG specification to do so.
 
21
* Due to a lack of consensus on where plugins should live under the XDG Base
 
22
  Directory spec, continue to look for plugins in ~/.bazaar/plugins.  To
 
23
  change this directory to something not under ~/.bazaar, use the environment
 
24
  variable $BZR_PLUGIN_PATH.