← 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: Patch Queue Manager
  • Date: 2013-06-24 13:05:33 UTC
  • mfrom: (6578.1.1 2.6-merges-2.5)
  • Revision ID: pqm@pqm.ubuntu.com-20130624130533-51c8htekjd8mix3u
(jameinel) Merge bzr/2.5 into trunk,
 including the fix for bug #855155 (John A Meinel)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/xdg_config_spec.txt
2
2
===================================================================
3
3
 
4
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
 
5
directory ~/.bazaar on unix installs.  On Windows, this is
 
6
%APPDATA%/Bazaar/2.0 and on Mac OS X, the directory is ~/.bazaar.  With the
 
7
XDG Base Directory specification
7
8
(http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html), many
8
9
Linux and Unix platforms have tried to centralize configuration files under a
9
10
specific directory referred to as $XDG_CONFIG_HOME.  This has a default value
12
13
Bazaar would like to be a good Unix citizen by using these standard locations
13
14
for configuration files.  As such, we should support that location, but not
14
15
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%.
 
16
to Windows or Mac OS X which should use their own native configuration
 
17
locations.  (On Windows, we currently do this by working under %APPDATA%.  The
 
18
Mac OS X equivalent would be ~/Library/Application Support/Bazaar but there is
 
19
also cultural support for ~/.bazaar on that platform.)
17
20
 
18
21
* If $XDG_CONFIG_HOME/bazaar exists, use the files there for configuration,
19
22
  noting in the log that we are doing so.  This allows individuals who would