debian/notmuch
1
0
Fork 0
mirror of https://git.notmuchmail.org/git/notmuch synced 2024-11-25 12:28:09 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

notmuch setup: Add some comments when creating a .notmuch-config file.

Browse source 
The "notmuch setup" command is nice and all, but we also want to allow
users to conveniently edit the configuration file directly.
This commit is contained in:
Carl Worth 2009-11-11 17:25:42 -08:00
parent 305e76bc0a
commit c884c30c30
1 changed files with 44 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

44
notmuch-config.c
View file

@ -23,6 +23,36 @@
#include <pwd.h> #include <pwd.h>
#include <netdb.h> #include <netdb.h>
static const char toplevel_config_comment[] =
" .notmuch-config - Configuration file for the notmuch mail system\n"
"\n"
" For more information about notmuch, see http://notmuchmail.org";
static const char database_config_comment[] =
" Database configuration\n"
"\n"
" The only value supported here is 'path' which should be the top-level\n"
" directory where your mail currently exists and to where mail will be\n"
" delivered in the future. Files should be individual email messages.\n"
" Notmuch will store its database within a sub-directory of the path\n"
" configured here named \".notmuch\".\n";
static const char user_config_comment[] =
" User configuration\n"
"\n"
" Here is where you can let notmuch know how you would like to be\n"
" addressed. Valid settings are\n"
"\n"
"\tname Your full name.\n"
"\tprimary_email Your primary email address.\n"
"\tother_email A list (separated by ';') of other email addresses\n"
"\t at which you receive email.\n"
"\n"
" Notmuch will use the various email addresses configured here when\n"
" formatting replies. It will avoid including your own addresses in the\n"
" recipient list of replies, and will set the From address based on the\n"
" address to which the original email was addressed.\n";
struct _notmuch_config { struct _notmuch_config {
char *filename; char *filename;
GKeyFile *key_file; GKeyFile *key_file;
@ -118,6 +148,7 @@ notmuch_config_t *
notmuch_config_open (void *ctx, const char *filename) notmuch_config_open (void *ctx, const char *filename)
{ {
GError *error = NULL; GError *error = NULL;
int config_file_is_new = 0;
notmuch_config_t *config = talloc (ctx, notmuch_config_t); notmuch_config_t *config = talloc (ctx, notmuch_config_t);
if (config == NULL) { if (config == NULL) {
@ -156,6 +187,8 @@ notmuch_config_open (void *ctx, const char *filename)
talloc_free (config); talloc_free (config);
return NULL; return NULL;
} }
config_file_is_new = 1;
} }
if (notmuch_config_get_database_path (config) == NULL) { if (notmuch_config_get_database_path (config) == NULL) {
@ -201,6 +234,17 @@ notmuch_config_open (void *ctx, const char *filename)
} }
} }
/* When we create a new configuration file here, we add some
* comments to help the user understand what can be done. */
if (config_file_is_new) {
g_key_file_set_comment (config->key_file, NULL, NULL,
toplevel_config_comment, NULL);
g_key_file_set_comment (config->key_file, "database", NULL,
database_config_comment, NULL);
g_key_file_set_comment (config->key_file, "user", NULL,
user_config_comment, NULL);
}
return config; return config;
} }