summaryrefslogtreecommitdiff
path: root/lisp/xdg.el
diff options
context:
space:
mode:
Diffstat (limited to 'lisp/xdg.el')
-rw-r--r--lisp/xdg.el17
1 files changed, 17 insertions, 0 deletions
diff --git a/lisp/xdg.el b/lisp/xdg.el
index db890f9494b..aee0dcad67f 100644
--- a/lisp/xdg.el
+++ b/lisp/xdg.el
@@ -85,6 +85,23 @@ According to the XDG Base Directory Specification version
should be used.\""
(xdg--dir-home "XDG_DATA_HOME" "~/.local/share"))
+(defun xdg-state-home ()
+ "Return the base directory for user-specific state data.
+
+According to the XDG Base Directory Specification version
+0.8 (8th May 2021):
+
+ \"The $XDG_STATE_HOME contains state data that should persist
+ between (application) restarts, but that is not important or
+ portable enough to the user that it should be stored in
+ $XDG_DATA_HOME. It may contain:
+
+ * actions history (logs, history, recently used files, …)
+
+ * current state of the application that can be reused on a
+ restart (view, layout, open files, undo history, …)\""
+ (xdg--dir-home "XDG_STATE_HOME" "~/.local/state"))
+
(defun xdg-runtime-dir ()
"Return the value of $XDG_RUNTIME_DIR.