will now include all keys and values of the "dark" theme.
will now include all keys and values of the "dark" theme.
.sp
.Pp
.Dlmeliprint-loaded-themes
.Dlmeliprint-loaded-themes
.sp
.Pp
will print all loaded themes with the links resolved.
will print all loaded themes with the links resolved.
.ShVALIDATTRIBUTEVALUES
.ShVALIDATTRIBUTEVALUES
Case-sensitive.
Case-sensitive.
.Bl-bullet-compact
.Bl-dash-compact
.It
.It
"Default"
"Default"
.It
.It
@ -133,7 +138,7 @@ Any combo of the above separated by a bitwise XOR "\&|" eg "Dim | Italics"
.El
.El
.ShVALIDCOLORVALUES
.ShVALIDCOLORVALUES
Color values are of type String with the following valid contents:
Color values are of type String with the following valid contents:
.Bl-bullet-compact
.Bl-dash-compact
.It
.It
"Default" is the terminal default. (Case-sensitive)
"Default" is the terminal default. (Case-sensitive)
.It
.It
@ -146,8 +151,10 @@ Three character shorthand is also valid, e.g. #09c → #0099cc (Case-insensitive
name but with some modifications (for a full table see COLOR NAMES addendum) (Case-sensitive)
name but with some modifications (for a full table see COLOR NAMES addendum) (Case-sensitive)
.El
.El
.ShNOCOLOR
.ShNOCOLOR
To completely disable ANSI colors, there are two options:
To completely disable
.Bl-bullet-compact
.TnANSI
colors, there are two options:
.Bl-dash-compact
.It
.It
Set the
Set the
.Icuse_color
.Icuse_color
@ -157,17 +164,22 @@ option (section
.It
.It
The
The
.EvNO_COLOR
.EvNO_COLOR
environmental variable, when present (regardless of its value), prevents the addition of ANSI color.
environmental variable, when present (regardless of its value), prevents the addition of
.TnANSI
color.
When the configuration value
When the configuration value
.Icuse_color
.Icuse_color
is explicitly set to true by the user,
is explicitly set to true by the user,
.EvNO_COLOR
.EvNO_COLOR
is ignored.
is ignored.
.El
.El
.sp
.Pp
In this mode, cursor locations (i.e., currently selected entries/items) will use the "reverse video" ANSI attribute to invert the terminal's default foreground/background colors.
In this mode, cursor locations (i.e., currently selected entries/items) will use the
.Qlreversevideo
.TnANSI
attribute to invert the terminal's default foreground/background colors.
.\" You should have received a copy of the GNU General Public License
.\" You should have received a copy of the GNU General Public License
.\" along with meli. If not, see <http://www.gnu.org/licenses/>.
.\" along with meli. If not, see <http://www.gnu.org/licenses/>.
.\"
.\"
.deHorizontalRule
.\"\l'\n(.l\(ru1.25'
.sp
..
.deShortcut
.deShortcut
.Sm
.Sm
.Aq\\$1
.Aq\\$1
@ -40,12 +44,13 @@
.Ed
.Ed
.sp
.sp
..
..
.DdNovember11,2022
.\".Dd November 11, 2022
.DdMarch10,2024
.DtMELI1
.DtMELI1
.Os
.Os
.ShNAME
.ShNAME
.Nmmeli
.Nmmeli
.Ndterminale-mail client
.Ndterminale\-mail client
.Emμέλι
.Emμέλι
is the Greek word for honey
is the Greek word for honey
.ShSYNOPSIS
.ShSYNOPSIS
@ -71,7 +76,7 @@ Test a configuration file for syntax issues or missing options.
Print documentation page and exit (Piping to a pager is recommended).
Print documentation page and exit (Piping to a pager is recommended).
.ItCminstall-manOpArpath
.ItCminstall-manOpArpath
Install manual pages to the first location provided by
Install manual pages to the first location provided by
.ArMANPATH
.EvMANPATH
or
or
.Xrmanpath1,
.Xrmanpath1,
unless you specify the directory as an argument.
unless you specify the directory as an argument.
@ -87,8 +92,8 @@ or
Prints help information or the help of the given subcommand(s).
Prints help information or the help of the given subcommand(s).
.ItCmprint-app-directories
.ItCmprint-app-directories
Print all directories that
Print all directories that
.Nm Ns
.Ns Nm
creates and uses.
creates and uses.
.ItCmprint-config-path
.ItCmprint-config-path
Print location of configuration file that will be loaded on normal app startup.
Print location of configuration file that will be loaded on normal app startup.
.ItCmprint-default-theme
.ItCmprint-default-theme
@ -102,7 +107,7 @@ View mail from input file.
.El
.El
.ShDESCRIPTION
.ShDESCRIPTION
.Nm
.Nm
is a terminal mail client aiming for extensive and user-frendly configurability.
is a terminal mail client aiming for extensive and user-friendly configurability.
.Bd-literal
.Bd-literal
^^ .-=-=-=-. ^^
^^ .-=-=-=-. ^^
^^ (`-=-=-=-=-`) ^^
^^ (`-=-=-=-=-`) ^^
@ -136,11 +141,28 @@ At any time, you may press
for a searchable list of all available actions and shortcuts, along with every possible setting and command that your version supports.
for a searchable list of all available actions and shortcuts, along with every possible setting and command that your version supports.
.Pp
.Pp
The main visual navigation tool, the left-side sidebar may be toggled with
The main visual navigation tool, the left-side sidebar may be toggled with
.ShortcutPeriod`listingtoggle_menu_visibility
.ShortcutPeriod\(galistingtoggle_menu_visibility
\&.
\&.
.Pp
.Pp
Each mailbox may be viewed in 4 modes:
Each mailbox may be viewed in 4 modes:
Plain views each mail individually, Threaded shows their thread relationship visually, Conversations collapses each thread of emails into a single entry, Compact shows one row per thread.
.Bl-dash-compact
.It
.Tgindex-style-plain
.EmPlain
views each mail individually,
.It
.Tgindex-style-threaded
.EmThreaded
shows their thread relationship visually,
.It
.Tgindex-style-conversations
.EmConversations
collapses each thread of e\-mails into a single entry,
.It
.Tgindex-style-compact
.EmCompact
shows one row per thread.
.El
.Pp
.Pp
If you're using a light color palette in your terminal, you should set
If you're using a light color palette in your terminal, you should set
.Emtheme="light"
.Emtheme="light"
@ -156,6 +178,10 @@ See
for a more detailed tutorial on using
for a more detailed tutorial on using
.NmNs
.NmNs
\&.
\&.
.ShSHORTCUTS
See
.Xrmeli.conf5SHORTCUTS
for shortcuts and their default values.
.ShVIEWINGMAIL
.ShVIEWINGMAIL
Open attachments by typing their index in the attachments list and then
Open attachments by typing their index in the attachments list and then
.ShortcutPeriodaenvelope_viewopen_attachment
.ShortcutPeriodaenvelope_viewopen_attachment
@ -181,7 +207,7 @@ If the path provided is a directory, the attachment is saved with its filename s
If the 0th index is provided, the entire message is saved.
If the 0th index is provided, the entire message is saved.
If the path provided is a directory, the message is saved as an eml file with its filename set to the messages message-id.
If the path provided is a directory, the message is saved as an eml file with its filename set to the messages message-id.
.ShSEARCH
.ShSEARCH
Each e-mail storage backend has a default search method assigned.
Each e\-mail storage backend has a default search method assigned.
.EmIMAP
.EmIMAP
uses the SEARCH command,
uses the SEARCH command,
.Emnotmuch
.Emnotmuch
@ -230,9 +256,8 @@ alias:
.Pc
.Pc
String keywords with spaces must be quoted.
String keywords with spaces must be quoted.
Quotes should always be escaped.
Quotes should always be escaped.
.sp
.SsImportantNoticeaboutIMAP/JMAP
.SyImportantNoticeaboutIMAP/JMAP
.HorizontalRule
.sp
To prevent downloading all your messages from your IMAP/JMAP server, don't set
To prevent downloading all your messages from your IMAP/JMAP server, don't set
.Emsearch_backend
.Emsearch_backend
to
to
@ -243,7 +268,8 @@ will relay your queries to the IMAP server.
Expect a delay between query and response.
Expect a delay between query and response.
Sqlite3 on the contrary at reasonable mailbox sizes should have a non noticeable delay.
Sqlite3 on the contrary at reasonable mailbox sizes should have a non noticeable delay.