aboutsummaryrefslogtreecommitdiffstats
path: root/doc/aerc-config.5.scd
diff options
context:
space:
mode:
authorRobin Jarry <robin@jarry.cc>2022-11-22 08:46:29 +0100
committerRobin Jarry <robin@jarry.cc>2022-11-24 19:19:10 +0100
commitfa294ef76fa015c090d1543630b147f2dca0b49a (patch)
treec373c9524df1b93a3c534f62cb2fce55872daa62 /doc/aerc-config.5.scd
parentc8ff23275a0047af487e63f76d8f079c881db713 (diff)
downloadaerc-fa294ef76fa015c090d1543630b147f2dca0b49a.tar.gz
config: sanitize default values
Remove `Default: none` or `Default: ""` statements which may be confusing. If there is no default value, simply do not mention a default value. Comment all settings in aerc.conf so that real default values are used. Adjust man pages. Signed-off-by: Robin Jarry <robin@jarry.cc> Acked-by: Koni Marti <koni.marti@gmail.com>
Diffstat (limited to 'doc/aerc-config.5.scd')
-rw-r--r--doc/aerc-config.5.scd44
1 files changed, 0 insertions, 44 deletions
diff --git a/doc/aerc-config.5.scd b/doc/aerc-config.5.scd
index 7338161d..bdb74bdf 100644
--- a/doc/aerc-config.5.scd
+++ b/doc/aerc-config.5.scd
@@ -51,8 +51,6 @@ These options are configured in the *[general]* section of aerc.conf.
using _>_ shell redirection, this setting is ignored and log messages
are printed to stdout.
- Default: ""
-
*log-level*
Only log messages above the specified level to *log-file*. Supported
levels are: _debug_, _info_, _warn_ and _error_. When redirecting aerc's
@@ -122,44 +120,30 @@ These options are configured in the *[ui]* section of aerc.conf.
Index-only time format for messages that were received/sent today.
If this is not specified, *timestamp-format* is used instead.
- Default: ""
-
*this-week-time-format*
Index-only time format for messages that were received/sent within the
last 7 days. If this is not specified, *timestamp-format* is used
instead.
- Default: ""
-
*this-year-time-format*
Index-only time format for messages that were received/sent this year.
If this is not specified, *timestamp-format* is used instead.
- Default: ""
-
*message-view-timestamp-format*
If set, overrides *timestamp-format* for the message view.
- Default: ""
-
*message-view-this-day-time-format*
If set, overrides *timestamp-format* in the message view for messages
that were received/sent today.
- Default: ""
-
*message-view-this-week-time-format*
If set, overrides *timestamp-format* in the message view for messages
that were recieved/sent within the last 7 days.
- Default: ""
-
*message-view-this-year-time-format*
If set, overrides *timestamp-format* in the message view for messages
that were received/sent this year.
- Default: ""
-
*sidebar-width*
Width of the sidebar, including the border. Set to zero to disable the
sidebar.
@@ -214,8 +198,6 @@ These options are configured in the *[ui]* section of aerc.conf.
Example:
sort = from -r date
- Default: ""
-
*dirlist-format*
Describes the format string to use for the directory list.
@@ -298,8 +280,6 @@ These options are configured in the *[ui]* section of aerc.conf.
/usr/share/aerc/stylesets
```
- Default: ""
-
*styleset-name*
The name of the styleset to be used to style the ui elements. The
stylesets are stored in the 'stylesets' directory in the config
@@ -313,8 +293,6 @@ These options are configured in the *[ui]* section of aerc.conf.
The icon to display for unencrypted mails. The status indicator is only
displayed if an icon is set.
- Default: ""
-
*icon-encrypted*
The icon to display for encrypted mails.
@@ -331,8 +309,6 @@ These options are configured in the *[ui]* section of aerc.conf.
was successfully verified. The combined icon is only used if set,
otherwise the signed and encrypted icons are displayed separately.
- Default: ""
-
*icon-unknown*
The icon to display for signed mails which could not be verified due to
the key being unknown.
@@ -556,8 +532,6 @@ These options are configured in the *[compose]* section of aerc.conf.
Example:
address-book-cmd = khard email --remove-first-line --parsable '%s'
- Default: none
-
*file-picker-cmd*
Specifies the command to be used to select attachments. Any occurence of
'%s' in the file-picker-cmd will be replaced with the argument <arg>
@@ -569,8 +543,6 @@ These options are configured in the *[compose]* section of aerc.conf.
Example:
file-picker-cmd = fzf --multi --query=%s
- Default: none
-
*reply-to-self*
If set to false, do not mail yourself when replying (e.g., if replying
to emails previously sent by yourself, address your replies to the
@@ -681,8 +653,6 @@ They are configured in the *[triggers]* section of aerc.conf.
e.g. new-email=exec notify-send "New email from %n" "%s"
- Default: ""
-
Format specifiers from *index-format* are expanded with respect to the new
message.
@@ -709,8 +679,6 @@ These options are configured in the *[templates]* section of aerc.conf.
/usr/share/aerc/templates
```
- Default: ""
-
*new-message*
The default template to be used for new messages.
@@ -762,8 +730,6 @@ Note that many of these configuration options are written for you, such as
*copy-to*
Specifies a folder to copy sent mails to, usually "Sent".
- Default: none
-
*default*
Specifies the default folder to open in the message list when aerc
configures this account.
@@ -793,21 +759,15 @@ Note that many of these configuration options are written for you, such as
Specifies a comma separated list of folders to be shown at the top of the
list in the provided order. Remaining folders will be sorted alphabetically.
- Default: none
-
*from*
The default value to use for the From header in new emails. This should be
an RFC 5322-compatible string, such as "Your Name <you@example.org>".
- Default: none
-
*aliases*
All aliases of the current account. These will be used to fill in the From:
field. Make sure that your email server accepts this value, or for example
use *aerc-sendmail*(5) in combination with msmtp and --read-envelope-from.
- Default: none
-
*outgoing*
Specifies the transport for sending outgoing emails on this account. It
should be a connection string, and the specific meaning of each component
@@ -820,8 +780,6 @@ Note that many of these configuration options are written for you, such as
Specifies an optional command that is run to get the outgoing account's
password. See each protocol's man page for more details.
- Default: none
-
*outgoing-cred-cmd-cache*
By default, the credentials returned by the command will be cached until
aerc is shut down. If set to false, *outgoing-cred-cmd* will be executed
@@ -866,8 +824,6 @@ Note that many of these configuration options are written for you, such as
- *aerc-maildir*(5)
- *aerc-notmuch*(5)
- Default: none
-
*source-cred-cmd*
Specifies an optional command that is run to get the source account's
password. See each protocol's man page for more details.