~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/xdg_config_spec.txt

• browse files at revision 6603.3.1
• compare with another revision
• download diff
• download tarball
• view history from revision 6603.3.1

• reverse the comparison (6603.3.1 to 5401)
• stop comparing with revision 5401

Show diffs side-by-side

added

removed

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.

• Older »

Loggerhead is a web-based interface for Breezy
Version: 2.0.1