aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorRobin Jarry <robin@jarry.cc>2024-02-19 22:09:34 +0100
committerRobin Jarry <robin@jarry.cc>2024-02-22 21:47:04 +0100
commit6e6a8678531c17a9a3599b86d63b8d24bfc7f7c0 (patch)
treeda95092ab3671a87d714b977d95fea7402217dc2 /doc
parent3c01fd0fcd030b8bbe68f0208c8b4467dcd1ed89 (diff)
downloadaerc-6e6a8678531c17a9a3599b86d63b8d24bfc7f7c0.tar.gz
msglist: allow configuring default split
Add a new setting to configure the default split layout for message list tabs. The syntax is a bit different from the :split and :vsplit commands since it needs to convey the direction in the value as well. I didn't reuse split/vsplit since they are a bit confusing when used in a configuration file. The syntax is as follows: message-list-split = [<direction>] <size> The direction is optional and defaults to horizontal. The size is the number of terminal cells that will be used to display the message list. All these examples are equivalent: message-list-split = horiz 12 message-list-split = h 12 message-list-split = 12 Same idea for vertical splits: message-list-split = vertical 120 message-list-split = vert 120 message-list-split = v 120 Both :split and :vsplit commands remain usable as before. The configuration options only affect the initial layout at startup. Add config.SPLIT_* constants and sanitize AccountView.{Split,Vsplit} methods. Changelog-added: Configure default message list `:split` or `:vsplit` on startup with `message-list-split` in `aerc.conf`. Signed-off-by: Robin Jarry <robin@jarry.cc> Tested-by: Tim Culverhouse <tim@timculverhouse.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/aerc-config.5.scd12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/aerc-config.5.scd b/doc/aerc-config.5.scd
index b13d6e89..ea931675 100644
--- a/doc/aerc-config.5.scd
+++ b/doc/aerc-config.5.scd
@@ -179,6 +179,18 @@ These options are configured in the *[ui]* section of _aerc.conf_.
Default: _22_
+*message-list-split* = _[<direction>] <size>_
+ The default split layout for message list tabs.
+
+ _<direction>_ is optional and defaults to _horizontal_. It can take one
+ of the following values: _h_, _horiz_, _horizontal_, _v_, _vert_,
+ _vertical_.
+
+ _<size>_ is a positive integer representing the size (in terminal cells)
+ of the message list window.
+
+ See *:split* in *aerc*(1) for more details.
+
*empty-message* = _<string>_
Message to display when viewing an empty folder.