summaryrefslogtreecommitdiffstats
path: root/basedir
diff options
context:
space:
mode:
Diffstat (limited to 'basedir')
-rw-r--r--basedir/basedir-spec.xml40
1 files changed, 40 insertions, 0 deletions
diff --git a/basedir/basedir-spec.xml b/basedir/basedir-spec.xml
index a8708e9..79d0cf3 100644
--- a/basedir/basedir-spec.xml
+++ b/basedir/basedir-spec.xml
@@ -34,6 +34,15 @@
</address>
</affiliation>
</author>
+ <author>
+ <firstname>Johannes</firstname>
+ <surname>Löthberg</surname>
+ <affiliation>
+ <address>
+ <email>johannes@kyriasis.com</email>
+ </address>
+ </affiliation>
+ </author>
</authorgroup>
</articleinfo>
@@ -68,6 +77,20 @@
</listitem>
<listitem>
<para>
+ There is a single base directory relative to which user-specific
+ executable files should be written. This directory is defined by the
+ environment variable <literal>$XDG_BIN_HOME</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ There is a set of preference ordered base directories relative to
+ which executable files should be searched. This set of directories
+ is defined by the environment variable <literal>$XDG_BIN_DIRS</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
There is a set of preference ordered base directories relative to
which data files should be searched. This set of directories is defined
by the environment variable <literal>$XDG_DATA_DIRS</literal>.
@@ -123,6 +146,12 @@
<literal>$HOME</literal>/.config should be used.
</para>
<para>
+ <literal>$XDG_BIN_HOME</literal> defines the base directory relative to
+ which user-specific executable files should be stored. If
+ <literal>$XDG_BIN_HOME</literal> is either not set or empty, a default equal to
+ <literal>$HOME</literal>/.local/bin should be used.
+ </para>
+ <para>
<literal>$XDG_DATA_DIRS</literal> defines the preference-ordered set of
base directories to search for data files in addition to the
<literal>$XDG_DATA_HOME</literal> base directory.
@@ -145,6 +174,17 @@
/etc/xdg should be used.
</para>
<para>
+ <literal>$XDG_BIN_DIRS</literal> defines the preference-ordered set of
+ base directories to search for executable files in addition to the
+ <literal>$XDG_BIN_HOME</literal> base directory.
+ The directories in <literal>$XDG_BIN_DIRS</literal> should be seperated
+ with a colon ':'.
+ </para>
+ <para>
+ If <literal>$XDG_BIN_DIRS</literal> is either not set or empty, a value equal to
+ /usr/local/bin:/usr/bin should be used.
+ </para>
+ <para>
The order of base directories denotes their importance; the first
directory listed is the most important. When the same information is
defined in multiple places the information defined relative to the more