basedir: Add XDG_BIN_HOME and XDG_BIN_DIRS

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