From cffa2365be267ca2b243eee0cbb40593c0e01a3d Mon Sep 17 00:00:00 2001 From: Ben Burwell Date: Tue, 2 Jul 2019 23:14:43 -0400 Subject: [PATCH] Document message index format specifiers --- config/aerc.conf.in | 2 +- doc/aerc-config.5.scd | 37 ++++++++++++++++++++++++++++++++++++- 2 files changed, 37 insertions(+), 2 deletions(-) diff --git a/config/aerc.conf.in b/config/aerc.conf.in index a5994a3..f63c15a 100644 --- a/config/aerc.conf.in +++ b/config/aerc.conf.in @@ -4,7 +4,7 @@ [ui] # # Describes the format for each row in a mailbox view. This field is compatible -# with mutt's printf-like syntax. TODO: document properly +# with mutt's printf-like syntax. # # Default: index-format=%D %-17.17n %s diff --git a/doc/aerc-config.5.scd b/doc/aerc-config.5.scd index 8e0e056..db69aff 100644 --- a/doc/aerc-config.5.scd +++ b/doc/aerc-config.5.scd @@ -36,10 +36,45 @@ These options are configured in the *[ui]* section of aerc.conf. *index-format* Describes the format for each row in a mailbox view. This field is - compatible with mutt's printf-like syntax. TODO: document properly + compatible with mutt's printf-like syntax. Default: %D %-17.17n %s +[- *Format specifier* +:[ *Description* +| %% +: literal % +| %a +: sender address +| %A +: reply-to address, or sender address if none +| %C +: message number +| %d +: formatted message timestamp +| %D +: formatted message timestamp converted to local timezone +| %f +: sender name and address +| %F +: sender name, or sender address if none +| %i +: message id +| %n +: same as %F +| %r +: comma-separated list of formatted recipient names and addresses +| %R +: comma-separated list of formatted CC names and addresses +| %s +: subject +| %u +: sender mailbox name (e.g. "smith" in "smith@example.net") +| %v +: sender first name (e.g. "Alex" in "Alex Smith ") +| %Z +: flags (O=old, N=new, r=answered, D=deleted, !=flagged) + *timestamp-format* See time.Time#Format at https://godoc.org/time#Time.Format