Improve internal variable handling in mail. Implement envelope and variable commands.

* NEWS: Update.
* doc/texinfo/programs.texi: Document new variables and commands.
* mail/envelope.c: New file.
* mail/mailvar.c: New file.
* mail/Makefile.am (mail_SOURCES): Add envelope.c and mailvar.c.

* mail/mail.h (EF_HIDDEN): New constant
(mail_env_data_t, mail_env_entry, mail_env_entry_is_set)
(mail_env_entry, util_getenv, util_printenv, util_setenv)
(var_iterator_t, var_iterate_next, var_iterate_first)
(var_iterate_end, var_compl): Removed.

(union mailvar_value, struct mailvar_variable
(mail_variable, mail_envelope, print_envelope)
(mailvar_find_variable, mailvar_get, mailvar_print)
(mailvar_variable_format, mailvar_set, mailvar_set_compl): Add prototypes.
(MOPTF_OVERWRITE, MOPTF_QUIET)

* mail/table.c: List new commands: envelope, setq, variable.
Implement completion for `set'.
* mail/testsuite/mail/if.exp: Use setq to set a read-only variable.

mail/alias.c, mail/decode.c, mail/delete.c, mail/escape.c
mail/file.c, mail/folders.c, mail/from.c, mail/if.c,
mail/mail.c, mail/mailline.c, mail/msgset.y, mail/pipe.c,
mail/print.c, mail/quit.c, mail/reply.c, mail/send.c,
mail/set.c, mail/shell.c, mail/top.c, mail/unset.c,
mail/util.c: Use mailvar functions.

1 files changed, 39 insertions, 1 deletions

diff --git a/NEWS b/NEWS
index 8cd6cdaec..29bb08a02 100644
--- a/NEWS
+++ b/NEWS
@@ -1,4 +1,4 @@
-GNU mailutils NEWS -- history of user-visible changes. 2009-07-08
+GNU mailutils NEWS -- history of user-visible changes. 2009-07-11
 Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 
 2008, 2009 Free Software Foundation, Inc.
 See the end of file for copying conditions.
@@ -27,6 +27,44 @@ exists in the destination mailbox.
 The `--verbose' command line option enables outputting additional
 information.
 
+* Mail
+
+** envelope command
+
+The env[elope] command displays the SMTP envelopes of the messages
+given as its arguments.
+
+** variable command
+
+The va[riable] command describes the known internal mail variables.
+When used with arguments, only variables named in the command line are
+described.
+
+For each variable, this command prints its name, data type, current
+value and a short description.
+
+** showenvelope variable
+
+If the `showenvelope' variable is set, print command will include the
+SMTP envelope in its output.
+
+** fromfield variable
+
+The `fromenvelope' boolean variable, if set, instructs mail to obtain
+the sender address from the `From:' header.  This is the default.
+If unset, the sender address is obtained from the SMTP envelope.
+
+** variable-strict variable
+
+Setting this variable enables strict control over variable
+settings. In this mode, mail prints warning if a user is trying to
+set an unknown variable and refuses to set read-only variables.
+
+** variable-pretty-print variable
+
+If this variable is set, the `set' listing prints short
+descriptions before each variable.
+
 * API
 
 * Wicket/Ticket functions