[PATCH] Add XDG_STATE_HOME

piegames piegames at darmstadt.ccc.de
Mon Aug 19 22:48:10 UTC 2019


A few years ago, there was a discussion about an `XDG_STATE_HOME`
folder. I also found a patch that adds `XDG_BIN_HOME` deep in the
mailing list's archive (which, by the way, is still not merged
@maintainer).

I've made a patch similar to the one adding the `bin` directory based
on the discussion mentioned above.

Regard,
piegames


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

diff --git a/basedir/basedir-spec.xml b/basedir/basedir-spec.xml
index 8e6fff6..951c493 100644
--- a/basedir/basedir-spec.xml
+++ b/basedir/basedir-spec.xml
@@ -66,6 +66,13 @@
             environment variable <literal>$XDG_CONFIG_HOME</literal>.
           </para>
         </listitem>
+        <listitem>
+          <para>
+            There is a single base directory relative to which user-
specific
+            state data should be written. This directory is defined by
the
+            environment variable <literal>$XDG_STATE_HOME</literal>.
+          </para>
+        </listitem>
         <listitem>
           <para>
             There is a set of preference ordered base directories
relative to
@@ -121,6 +128,17 @@
       <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_STATE_HOME</literal> defines the base directory
relative to
+      which user-specific state files should be stored. If
+      <literal>$XDG_STATE_HOME</literal> is either not set or empty, a
default equal to
+      <literal>$HOME</literal>/.local/state should be used.
+    </para>
+    <para>
+      The <literal>$XDG_STATE_HOME</literal> fits right between config
and cache. It contains
+      convenience data that should be preserved between sessions of a
program like logs, history, 
+      last opened view etc.
+    </para>
     <para>
       <literal>$XDG_DATA_DIRS</literal> defines the preference-ordered 
set of
       base directories to search for data files in addition to the
-- 
2.22.0




More information about the xdg mailing list