[PATCH 2/2] basedir: Add XDG_BIN_HOME and XDG_BIN_DIRS

[Johannes Löthberg]

---
 basedir/basedir-spec.xml | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/basedir/basedir-spec.xml b/basedir/basedir-spec.xml
index eefbe2b..e44e020 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 at kyriasis.com</email>
+          </address>
+        </affiliation>
+      </author>
     </authorgroup>
   </articleinfo>
 
@@ -66,6 +75,20 @@
             environment variable <literal>$XDG_CONFIG_HOME</literal>.
           </para>
         </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
@@ -122,6 +145,12 @@
       <literal>$XDG_CONFIG_HOME</literal> is either not set or empty, a default equal to
       <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
@@ -144,6 +173,17 @@
       If <literal>$XDG_CONFIG_DIRS</literal> is either not set or empty, a value equal to
       /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
-- 
2.14.1