Extend --config-help output. Each configuration parameter

has a docstring which is displayed as a comment before it.
A docstring is also added to the configuration group structure,
for use in future.

* include/mailutils/cfg.h (struct mu_cfg_param): New members
`docstring' and `argname'.
(struct mu_cfg_section): New member `docstring'.
(mu_cfg_format_docstring): New function.
* include/mailutils/libargp.h (mu_help_config_mode): New
declaration.
* libargp/cmdline.h (mu_help_config_mode): Remove.
* libargp/muinit.c (mu_app_init): Better format the initial
comment.
* mailbox/cfg_format.c (mu_cfg_data_type_string): Use NLS.
(mu_cfg_format_docstring): New function.
(format_param,format_section): Use mu_cfg_format_docstring.
* mailbox/cfg_lexer.c (mu_config_create_container): Initialize
allocated memory chunk with zeros.
(dup_container): Duplicate docstring.
(mu_build_container): Document include statement.

* dotlock/dotlock.c, imap4d/imap4d.c, libargp/tls.c,
libcfg/auth.c, libcfg/common.c, libcfg/gsasl.c, libcfg/ldap.c,
libcfg/pam.c, libcfg/radius.c, libcfg/sieve.c, libcfg/sql.c,
libcfg/tls.c, libcfg/virtdomain.c, maidag/maidag.c,
mail.local/main.c, mail.remote/mail.remote.c, mimeview/mimeview.c,
movemail/movemail.c, pop3d/pop3d.c, readmsg/readmsg.c,
sieve/sieve.c: Document configuration file statements.

* pop3d/pop3d.h (expire): Change type to unsigned int.

* po/POTFILES.in: Add missing files.

1 files changed, 10 insertions, 4 deletions

diff --git a/mail.remote/mail.remote.c b/mail.remote/mail.remote.c
index 0e1f7f5cd..8578b78cb 100644
--- a/mail.remote/mail.remote.c
+++ b/mail.remote/mail.remote.c
@@ -136,10 +136,16 @@ static struct argp argp = {
 
 
 struct mu_cfg_param mail_remote_cfg_param[] = {
-  { "from", mu_cfg_string, &optfrom },
-  { "read-recipients", mu_cfg_string, &read_recipients },
-  { "debug", mu_cfg_int, &optdebug },
-  { NULL}
+  { "from", mu_cfg_string, &optfrom, NULL,
+    N_("Set sender email address."),
+    N_("email") },
+  { "read-recipients", mu_cfg_string, &read_recipients, NULL,
+    N_("Read recipient addresses from the message.") },
+  { "debug", mu_cfg_int, &optdebug, NULL,
+    N_("Set debug verbosity level.  Level 1 prints envelope commands in "
+       "the SMTP protocol transaction.  Levels 2 and above print the data "
+       "part of the transaction as well.") },
+  { NULL }
 };