summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--alot/defaults/alot.rc.spec4
-rw-r--r--docs/source/configuration/alotrc_table4
-rw-r--r--docs/source/configuration/theming.rst3
3 files changed, 8 insertions, 3 deletions
diff --git a/alot/defaults/alot.rc.spec b/alot/defaults/alot.rc.spec
index e13c93d1..cfecb123 100644
--- a/alot/defaults/alot.rc.spec
+++ b/alot/defaults/alot.rc.spec
@@ -31,9 +31,11 @@ tabwidth = integer(default=8)
# templates directory that contains your message templates.
# It will be used if you give `compose --template` a filename without a path prefix.
+# The default path is `$XDG_CONFIG_HOME/alot/temmplates`.
template_dir = string(default=None)
-# directory containing theme files
+# directory containing theme files.
+# The default path is `$XDG_CONFIG_HOME/alot/themes`.
themes_dir = string(default=None)
# name of the theme to use
diff --git a/docs/source/configuration/alotrc_table b/docs/source/configuration/alotrc_table
index a7bc5ec6..0299d406 100644
--- a/docs/source/configuration/alotrc_table
+++ b/docs/source/configuration/alotrc_table
@@ -576,6 +576,7 @@
templates directory that contains your message templates.
It will be used if you give `compose --template` a filename without a path prefix.
+ The default path is `$XDG_CONFIG_HOME/alot/temmplates`.
:type: string
:default: None
@@ -605,7 +606,8 @@
.. describe:: themes_dir
- directory containing theme files
+ directory containing theme files.
+ The default path is `$XDG_CONFIG_HOME/alot/themes`.
:type: string
:default: None
diff --git a/docs/source/configuration/theming.rst b/docs/source/configuration/theming.rst
index caf14047..ea04d7c8 100644
--- a/docs/source/configuration/theming.rst
+++ b/docs/source/configuration/theming.rst
@@ -11,7 +11,8 @@ To make it easier to switch between or share different such themes, they are def
files (see below for the exact format).
To specify the theme to use, set the :ref:`theme <theme>` config option to the name of a theme-file.
A file by that name will be looked up in the path given by the :ref:`themes_dir <themes-dir>` config setting
-which defaults to :file:`~/.config/alot/themes/`. If the themes_dir is not
+which defaults to $XDG_CONFIG_HOME/alot/themes, and :file:`~/.config/alot/themes/`,
+if XDG_CONFIG_HOME is empty or not set. If the themes_dir is not
present then the contents of $XDG_DATA_DIRS/alot/themes will be tried in order.
This defaults to :file:`/usr/local/share/alot/themes` and :file:`/usr/share/alot/themes`, in that order.
These locations are meant to be used by distro packages to put themes in.