diff options
author | Daniel <quite@hack.org> | 2012-03-15 12:46:41 +0100 |
---|---|---|
committer | Daniel <quite@hack.org> | 2012-03-15 12:46:41 +0100 |
commit | a49a5f7fcfbd46d2fa67fd31a21f4f03d6312a30 (patch) | |
tree | 5698e34f7218a87d5d90327d25a1dea8e10d3a09 | |
parent | 6629cc5de2a633898d3f1ec34ee8788597002e24 (diff) |
Some docs and refs
-rw-r--r-- | alot/defaults/config.stub | 5 | ||||
-rw-r--r-- | alot/settings/__init__.py | 1 | ||||
-rw-r--r-- | docs/source/configuration/index.rst | 5 |
3 files changed, 9 insertions, 2 deletions
diff --git a/alot/defaults/config.stub b/alot/defaults/config.stub index c6619897..17889780 100644 --- a/alot/defaults/config.stub +++ b/alot/defaults/config.stub @@ -1,9 +1,12 @@ +# For a complete list and description of options, please refer to: +# http://alot.readthedocs.org/en/latest/configuration/index.html#config-options +# or the file: defaults/alot.rc.spec in your alot installation. + # editor command # if unset, alot will first try the EDITOR env variable, then file /usr/bin/editor #editor_cmd = nano - #[accounts] # your main email address # address = me@example.com diff --git a/alot/settings/__init__.py b/alot/settings/__init__.py index 38847951..210fb5f4 100644 --- a/alot/settings/__init__.py +++ b/alot/settings/__init__.py @@ -87,6 +87,7 @@ class SettingsManager(object): self._accountmap = self._account_table(self._accounts) def write_default_config(self, path): + """write out defaults/config.stub to path""" (dir, file) = os.path.split(path) try: os.makedirs(dir) diff --git a/docs/source/configuration/index.rst b/docs/source/configuration/index.rst index ef8d1686..89595bd2 100644 --- a/docs/source/configuration/index.rst +++ b/docs/source/configuration/index.rst @@ -7,7 +7,10 @@ Configuration Alot reads a config file in "INI" syntax: It consists of key-value pairs that use "=" as separator and '#' is comment-prefixes. Sections and subsections are defined using square brackets. -The default location for the config file is :file:`~/.config/alot/config`. + +The default location for the config file is :file:`~/.config/alot/config`. If +upon startup this file is not found, a small default configuration (containing +mostly standard key bindings) will be copied in its place. Config options ============== |