/* build complete documentation */
-#ifdef _MAKEDOC
-# ifndef USE_LIBESMTP
-# define USE_LIBESMTP
-# endif
-# ifndef USE_NNTP
-# define USE_NNTP
-# endif
-# ifndef USE_HCACHE
-# define USE_HCACHE
-# endif
-# ifndef HAVE_LIBIDN
-# define HAVE_LIBIDN
-# endif
-#endif
-
struct option_t MuttVars[] = {
/*++*/
{"abort_noattach", DT_QUAD, R_NONE, OPT_ATTACH, "no" },
** If \fIset\fP, Madmutt will prompt you for carbon-copy (Cc) recipients before
** editing the body of an outgoing message.
*/
-#ifdef USE_NNTP
- {"nntp_ask_followup_to", DT_BOOL, R_NONE, OPTASKFOLLOWUP, "no" },
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** If \fIset\fP, Madmutt will prompt you for the \fTFollowup-To:\fP header
- ** field before editing the body of an outgoing news article.
- */
-#endif
{"attach_format", DT_STR, R_NONE, UL &AttachFormat, "%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] "},
/*
** .pp
** follow these menus. The option is disabled by default because many
** visual terminals don't permit making the cursor invisible.
*/
-#ifdef USE_NNTP
- {"nntp_catchup", DT_QUAD, R_NONE, OPT_CATCHUP, "ask-yes" },
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** If this variable is \fIset\fP, Madmutt will mark all articles in a newsgroup
- ** as read when you leaving it.
- */
-#endif
{"check_new", DT_BOOL, R_NONE, OPTCHECKNEW, "yes" },
/*
** .pp
** sent to both the list and your address, resulting in two copies
** of the same email for you.
*/
-#ifdef USE_NNTP
- {"nntp_followup_to_poster", DT_QUAD, R_NONE, OPT_FOLLOWUPTOPOSTER, "ask-yes" },
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** If this variable is \fIset\fP and the keyword "\fTposter\fP" is present in
- ** the \fTFollowup-To:\fP header field, a follow-up to the newsgroup is not
- ** permitted. The message will be mailed to the submitter of the
- ** message via mail.
- */
-#endif
{"force_buffy_check", DT_BOOL, R_NONE, OPTFORCEBUFFYCHECK, "no" },
/*
** .pp
** message (when ``$$mime_forward'' is \fIunset\fP) will be quoted using
** ``$$indent_string''.
*/
-#ifdef USE_NNTP
- {"nntp_group_index_format", DT_STR, R_BOTH, UL &GroupFormat, "%4C %M%N %5s %-45.45f %d"},
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** This variable allows you to customize the newsgroup browser display to
- ** your personal taste. This string is similar to ``$index_format'', but
- ** has its own set of \fTprintf(3)\fP-like sequences:
- ** .pp
- ** .ts
- ** %C current newsgroup number
- ** %d description of newsgroup (retrieved from server)
- ** %f newsgroup name
- ** %M ``-'' if newsgroup not allowed for direct post (moderated for example)
- ** %N ``N'' if newsgroup is new, ``u'' if unsubscribed, blank otherwise
- ** %n number of new articles in newsgroup
- ** %s number of unread articles in newsgroup
- ** %>X right justify the rest of the string and pad with character "X"
- ** %|X pad to the end of the line with character "X"
- ** .te
- */
-#endif
- {"hdrs", DT_BOOL, R_NONE, OPTHDRS, "yes" },
- /*
- ** .pp
- ** When \fIunset\fP, the header fields normally added by the ``$my_hdr''
- ** command are not created. This variable \fImust\fP be \fIunset\fP before
- ** composing a new message or replying in order to take effect. If \fIset\fP,
- ** the user defined header fields are added to every new message.
- */
{"header", DT_BOOL, R_NONE, OPTHEADER, "no" },
/*
** .pp
** .pp
** \fBNote:\fP This is a space separated list.
*/
- {"imap_home_namespace", DT_STR, R_NONE, UL &ImapHomeNamespace, "" },
- /*
- ** .pp
- ** You normally want to see your personal folders alongside
- ** your \fTINBOX\fP in the IMAP browser. If you see something else, you may set
- ** this variable to the IMAP path to your folders.
- */
{"imap_keepalive", DT_NUM, R_NONE, UL &ImapKeepalive, "900" },
/*
** .pp
** user/password pairs on Madmutt invocation, or if opening the connection
** is slow.
*/
- {"imap_peek", DT_BOOL, R_NONE, OPTIMAPPEEK, "yes" },
- /*
- ** .pp
- ** If \fIset\fP, Madmutt will avoid implicitly marking your mail as read whenever
- ** you fetch a message from the server. This is generally a good thing,
- ** but can make closing an IMAP folder somewhat slower. This option
- ** exists to appease speed freaks.
- */
{"imap_reconnect", DT_QUAD, R_NONE, OPT_IMAPRECONNECT, "ask-yes" },
/*
** .pp
** Controls whether or not a copy of the message(s) you are replying to
** is included in your reply.
*/
- {"include_onlyfirst", DT_BOOL, R_NONE, OPTINCLUDEONLYFIRST, "no" },
- /*
- ** .pp
- ** Controls whether or not Madmutt includes only the first attachment
- ** of the message you are replying.
- */
{"indent_string", DT_STR, R_NONE, UL &Prefix, "> "},
/*
** .pp
** .pp
** See also: ``$$to_chars''.
*/
-#ifdef USE_NNTP
- {"nntp_inews", DT_PATH, R_NONE, UL &Inews, ""},
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** If \fIset\fP, specifies the program and arguments used to deliver news posted
- ** by Madmutt. Otherwise, Madmutt posts article using current connection.
- ** The following \fTprintf(3)\fP-style sequence is understood:
- ** .pp
- ** .ts
- ** %s newsserver name
- ** .te
- ** .pp
- ** Example: \fTset inews="/usr/local/bin/inews -hS"\fP
- */
-#endif
{"keep_flagged", DT_BOOL, R_NONE, OPTKEEPFLAGGED, "no" },
/*
** .pp
** This variable, when \fIset\fP, makes the thread tree narrower, allowing
** deeper threads to fit on the screen.
*/
-#ifdef USE_NNTP
- {"nntp_cache_dir", DT_PATH, R_NONE, UL &NewsCacheDir, "~/.madmutt"},
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** This variable points to directory where Madmutt will cache news
- ** article headers. If \fIunset\fP, headers will not be saved at all
- ** and will be reloaded each time when you enter a newsgroup.
- ** .pp
- ** As for the header caching in connection with IMAP and/or Maildir,
- ** this drastically increases speed and lowers traffic.
- */
- {"nntp_host", DT_STR, R_NONE, UL &NewsServer, "" },
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** This variable specifies the name (or address) of the NNTP server to be used.
- ** .pp
- ** It
- ** defaults to the value specified via the environment variable
- ** \fT$$$NNTPSERVER\fP or contained in the file \fT/etc/nntpserver\fP.
- ** .pp
- ** You can also
- ** specify a username and an alternative port for each newsserver, e.g.
- ** .pp
- ** \fT[nntp[s]://][username[:password]@]newsserver[:port]\fP
- ** .pp
- ** \fBNote:\fP Using a password as shown and stored in a configuration file
- ** presents a security risk since the superuser of your machine may read it
- ** regardless of the file's permissions.
- */
- {"nntp_newsrc", DT_PATH, R_NONE, UL &NewsRc, "~/.newsrc"},
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** This file contains information about subscribed newsgroup and
- ** articles read so far.
- ** .pp
- ** To ease the use of multiple news servers, the following \fTprintf(3)\fP-style
- ** sequence is understood:
- ** .pp
- ** .ts
- ** %s newsserver name
- ** .te
- */
- {"nntp_context", DT_NUM, R_NONE, UL &NntpContext, "1000" },
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** This variable controls how many news articles to cache per newsgroup
- ** (if caching is enabled, see $$nntp_cache_dir) and how many news articles
- ** to show in the ``index'' menu.
- ** .pp
- ** If there're more articles than defined with $$nntp_context, all older ones
- ** will be removed/not shown in the index.
- */
- {"nntp_load_description", DT_BOOL, R_NONE, OPTLOADDESC, "yes" },
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** This variable controls whether or not descriptions for newsgroups
- ** are to be loaded when subscribing to a newsgroup.
- */
- {"nntp_user", DT_STR, R_NONE, UL &NntpUser, ""},
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** Your login name on the NNTP server. If \fIunset\fP and the server requires
- ** authentification, Madmutt will prompt you for your account name.
- */
- {"nntp_pass", DT_STR, R_NONE, UL &NntpPass, ""},
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** Your password for NNTP account.
- ** .pp
- ** \fBNote:\fP Storing passwords in a configuration file
- ** presents a security risk since the superuser of your machine may read it
- ** regardless of the file's permissions.
- */
- {"nntp_mail_check", DT_NUM, R_NONE, UL &NewsPollTimeout, "60" },
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** The time in seconds until any operations on a newsgroup except posting a new
- ** article will cause a recheck for new news. If set to 0, Madmutt will
- ** recheck on each operation in index (stepping, read article, etc.).
- */
- {"nntp_reconnect", DT_QUAD, R_NONE, OPT_NNTPRECONNECT, "ask-yes" },
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** Controls whether or not Madmutt will try to reconnect to a newsserver when the
- ** was connection lost.
- */
-#endif
{ "net_inc", DT_NUM, R_NONE, UL &NetInc, "10" },
/*
** .pp
** ``reverse-''.
** (PGP only)
*/
- {"pgp_auto_decode", DT_BOOL, R_NONE, OPTPGPAUTODEC, "no" },
- /*
- ** .pp
- ** If \fIset\fP, Madmutt will automatically attempt to decrypt traditional PGP
- ** messages whenever the user performs an operation which ordinarily would
- ** result in the contents of the message being operated on. For example,
- ** if the user displays a pgp-traditional message which has not been manually
- ** checked with the check-traditional-pgp function, Madmutt will automatically
- ** check the message for traditional pgp.
- */
- /* XXX Default values! */
{"forward_decrypt", DT_BOOL, R_NONE, OPTFORWDECRYPT, "yes" },
/*
** .pp
** keyid (the hash-value that OpenSSL generates) to work properly
** (S/MIME only)
*/
-#if defined(USE_LIBESMTP)
- {"smtp_user", DT_STR, R_NONE, UL &SmtpAuthUser, "" },
- /*
- ** .pp
- ** Availability: SMTP
- **
- ** .pp
- ** Defines the username to use with SMTP AUTH. Setting this variable will
- ** cause Madmutt to attempt to use SMTP AUTH when sending.
- */
- {"smtp_pass", DT_STR, R_NONE, UL &SmtpAuthPass, "" },
- /*
- ** .pp
- ** Availability: SMTP
- **
- ** .pp
- ** Defines the password to use with SMTP AUTH. If ``$$smtp_user''
- ** is set, but this variable is not, you will be prompted for a password
- ** when sending.
- ** .pp
- ** \fBNote:\fP Storing passwords in a configuration file
- ** presents a security risk since the superuser of your machine may read it
- ** regardless of the file's permissions.
- */
- {"smtp_host", DT_STR, R_NONE, UL &SmtpHost, "" },
- /*
- ** .pp
- ** Availability: SMTP
- **
- ** .pp
- ** Defines the SMTP host which will be used to deliver mail, as opposed
- ** to invoking the sendmail binary. Setting this variable overrides the
- ** value of ``$$sendmail'', and any associated variables.
- */
- {"smtp_port", DT_NUM, R_NONE, UL &SmtpPort, "25" },
- /*
- ** .pp
- ** Availability: SMTP
- **
- ** .pp
- ** Defines the port that the SMTP host is listening on for mail delivery.
- ** Must be specified as a number.
- ** .pp
- ** Defaults to 25, the standard SMTP port, but RFC 2476-compliant SMTP
- ** servers will probably desire 587, the mail submission port.
- */
- {"smtp_use_tls", DT_STR, R_NONE, UL &SmtpUseTLS, "" },
- /*
- ** .pp
- ** Availability: SMTP
- **
- ** .pp
- ** Defines wether to use STARTTLS. If this option is set to ``\fIrequired\fP''
- ** and the server does not support STARTTLS or there is an error in the
- ** TLS Handshake, the connection will fail. Setting this to ``\fIenabled\fP''
- ** will try to start TLS and continue without TLS in case of an error.
- */
-#endif
{"pipe_split", DT_BOOL, R_NONE, OPTPIPESPLIT, "no" },
/*
** .pp
** presents a security risk since the superuser of your machine may read it
** regardless of the file's permissions.
*/
-#ifdef USE_NNTP
- {"nntp_post_moderated", DT_QUAD, R_NONE, OPT_TOMODERATED, "ask-yes" },
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** If set to \fIyes\fP, Madmutt will post articles to newsgroup that have
- ** not permissions to post (e.g. moderated).
- ** .pp
- ** \fBNote:\fP if the newsserver
- ** does not support posting to that newsgroup or a group is totally read-only, that
- ** posting will not have any effect.
- */
-#endif
{"postpone", DT_QUAD, R_NONE, OPT_POSTPONE, "ask-yes" },
/*
** .pp
** possibly including eventual real names. When it is \fIunset\fP, Madmutt will
** override any such real names with the setting of the $realname variable.
*/
-#ifdef USE_NNTP
- {"nntp_save_unsubscribed", DT_BOOL, R_NONE, OPTSAVEUNSUB, "no" },
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** When \fIset\fP, info about unsubscribed newsgroups will be saved into the
- ** ``newsrc'' file and into the news cache.
- */
-#endif
-#ifdef USE_NNTP
- {"nntp_show_new_news", DT_BOOL, R_NONE, OPTSHOWNEWNEWS, "yes" },
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** If \fIset\fP, the newsserver will be asked for new newsgroups on entering
- ** the browser. Otherwise, it will be done only once for a newsserver.
- ** Also controls whether or not the number of new articles of subscribed
- ** newsgroups will be checked.
- */
- {"nntp_show_only_unread", DT_BOOL, R_NONE, OPTSHOWONLYUNREAD, "no" },
- /*
- ** .pp
- ** Availability: NNTP
- **
- ** .pp
- ** If \fIset\fP, only subscribed newsgroups that contain unread articles
- ** will be displayed in the newsgroup browser.
- */
-#endif
{"sig_dashes", DT_BOOL, R_NONE, OPTSIGDASHES, "yes" },
/*
** .pp
** $$xterm_set_titles has been \fIset\fP. This string is identical in formatting
** to the one used by ``$$status_format''.
*/
+#ifdef USE_NNTP
+ {"nntp_post_moderated", DT_QUAD, R_NONE, OPT_TOMODERATED, "ask-yes" },
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** If set to \fIyes\fP, Madmutt will post articles to newsgroup that have
+ ** not permissions to post (e.g. moderated).
+ ** .pp
+ ** \fBNote:\fP if the newsserver
+ ** does not support posting to that newsgroup or a group is totally read-only, that
+ ** posting will not have any effect.
+ */
+ {"nntp_cache_dir", DT_PATH, R_NONE, UL &NewsCacheDir, "~/.cache/madmutt/"},
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** This variable points to directory where Madmutt will cache news
+ ** article headers. If \fIunset\fP, headers will not be saved at all
+ ** and will be reloaded each time when you enter a newsgroup.
+ ** .pp
+ ** As for the header caching in connection with IMAP and/or Maildir,
+ ** this drastically increases speed and lowers traffic.
+ */
+ {"nntp_host", DT_STR, R_NONE, UL &NewsServer, "" },
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** This variable specifies the name (or address) of the NNTP server to be used.
+ ** .pp
+ ** It
+ ** defaults to the value specified via the environment variable
+ ** \fT$$$NNTPSERVER\fP or contained in the file \fT/etc/nntpserver\fP.
+ ** .pp
+ ** You can also
+ ** specify a username and an alternative port for each newsserver, e.g.
+ ** .pp
+ ** \fT[nntp[s]://][username[:password]@]newsserver[:port]\fP
+ ** .pp
+ ** \fBNote:\fP Using a password as shown and stored in a configuration file
+ ** presents a security risk since the superuser of your machine may read it
+ ** regardless of the file's permissions.
+ */
+ {"nntp_context", DT_NUM, R_NONE, UL &NntpContext, "1000" },
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** This variable controls how many news articles to cache per newsgroup
+ ** (if caching is enabled, see $$nntp_cache_dir) and how many news articles
+ ** to show in the ``index'' menu.
+ ** .pp
+ ** If there're more articles than defined with $$nntp_context, all older ones
+ ** will be removed/not shown in the index.
+ */
+ {"nntp_load_description", DT_BOOL, R_NONE, OPTLOADDESC, "yes" },
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** This variable controls whether or not descriptions for newsgroups
+ ** are to be loaded when subscribing to a newsgroup.
+ */
+ {"nntp_user", DT_STR, R_NONE, UL &NntpUser, ""},
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** Your login name on the NNTP server. If \fIunset\fP and the server requires
+ ** authentification, Madmutt will prompt you for your account name.
+ */
+ {"nntp_pass", DT_STR, R_NONE, UL &NntpPass, ""},
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** Your password for NNTP account.
+ ** .pp
+ ** \fBNote:\fP Storing passwords in a configuration file
+ ** presents a security risk since the superuser of your machine may read it
+ ** regardless of the file's permissions.
+ */
+ {"nntp_mail_check", DT_NUM, R_NONE, UL &NewsPollTimeout, "60" },
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** The time in seconds until any operations on a newsgroup except posting a new
+ ** article will cause a recheck for new news. If set to 0, Madmutt will
+ ** recheck on each operation in index (stepping, read article, etc.).
+ */
+ {"nntp_reconnect", DT_QUAD, R_NONE, OPT_NNTPRECONNECT, "ask-yes" },
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** Controls whether or not Madmutt will try to reconnect to a newsserver when the
+ ** was connection lost.
+ */
+ {"nntp_group_index_format", DT_STR, R_BOTH, UL &GroupFormat, "%4C %M%N %5s %-45.45f %d"},
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** This variable allows you to customize the newsgroup browser display to
+ ** your personal taste. This string is similar to ``$index_format'', but
+ ** has its own set of \fTprintf(3)\fP-like sequences:
+ ** .pp
+ ** .ts
+ ** %C current newsgroup number
+ ** %d description of newsgroup (retrieved from server)
+ ** %f newsgroup name
+ ** %M ``-'' if newsgroup not allowed for direct post (moderated for example)
+ ** %N ``N'' if newsgroup is new, ``u'' if unsubscribed, blank otherwise
+ ** %n number of new articles in newsgroup
+ ** %s number of unread articles in newsgroup
+ ** %>X right justify the rest of the string and pad with character "X"
+ ** %|X pad to the end of the line with character "X"
+ ** .te
+ */
+ {"nntp_followup_to_poster", DT_QUAD, R_NONE, OPT_FOLLOWUPTOPOSTER, "ask-yes" },
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** If this variable is \fIset\fP and the keyword "\fTposter\fP" is present in
+ ** the \fTFollowup-To:\fP header field, a follow-up to the newsgroup is not
+ ** permitted. The message will be mailed to the submitter of the
+ ** message via mail.
+ */
+ {"nntp_catchup", DT_QUAD, R_NONE, OPT_CATCHUP, "ask-yes" },
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** If this variable is \fIset\fP, Madmutt will mark all articles in a newsgroup
+ ** as read when you leaving it.
+ */
+ {"nntp_ask_followup_to", DT_BOOL, R_NONE, OPTASKFOLLOWUP, "no" },
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** If \fIset\fP, Madmutt will prompt you for the \fTFollowup-To:\fP header
+ ** field before editing the body of an outgoing news article.
+ */
+ {"nntp_save_unsubscribed", DT_BOOL, R_NONE, OPTSAVEUNSUB, "no" },
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** When \fIset\fP, info about unsubscribed newsgroups will be saved into the
+ ** ``newsrc'' file and into the news cache.
+ */
+ {"nntp_show_new_news", DT_BOOL, R_NONE, OPTSHOWNEWNEWS, "yes" },
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** If \fIset\fP, the newsserver will be asked for new newsgroups on entering
+ ** the browser. Otherwise, it will be done only once for a newsserver.
+ ** Also controls whether or not the number of new articles of subscribed
+ ** newsgroups will be checked.
+ */
+ {"nntp_show_only_unread", DT_BOOL, R_NONE, OPTSHOWONLYUNREAD, "no" },
+ /*
+ ** .pp
+ ** Availability: NNTP
+ **
+ ** .pp
+ ** If \fIset\fP, only subscribed newsgroups that contain unread articles
+ ** will be displayed in the newsgroup browser.
+ */
+#endif
/*--*/
{ NULL, -1, R_NONE, -1, NULL }
};