commit 2572d286b3fb3d35b340b4d1b251adfcf8cc6795
from: Stefan Sperling <stsp@stsp.name>
date: Tue Jul 12 16:13:39 2022 UTC

tog man page: tweak documentation of vertical/horizontal split for clarity

commit - c5d51f20832122bdce117ecbbe7dd460627531cf
commit + 2572d286b3fb3d35b340b4d1b251adfcf8cc6795
blob - fb2fc4d627cc55c63bde40a0633365df3bfa641c
blob + 225f0e28a0c36ad91c51a64496f460d0f9f423cf
--- tog/tog.1
+++ tog/tog.1
@@ -81,11 +81,10 @@ Toggle fullscreen mode for a split-screen view.
 will automatically use split-screen views if the size of the terminal
 window is sufficiently large.
 .It Cm S
-Switch the current split mode.
-.Nm
-will also render the view in the new split mode.
-If the terminal is not wide enough when switching to a vertical split, the
-view will render in fullscreen.
+Switch the current split-screen layout, and render all active views in
+this new layout.
+If the terminal is not wide enough when switching to a vertical split,
+views will render in fullscreen.
 .It Cm -
 When in a split-screen view, decrease the size of the focussed split
 N increments (default: 1).
@@ -615,14 +614,18 @@ and
 .Dq myers .
 If unset, the Myers diff algorithm will be used by default.
 .It Ev TOG_VIEW_SPLIT_MODE
-Determines whether
-.Nm
-will use vertical or horizontal split for split-screen views.
+Determines the default layout of split-screen views.
 If set to
 .Dq h
-then split-screen views will be split horizontally.
-Otherwise, split-screen views will be split vertically.
-Splits can be manipulated in-session as documented above.
+or
+.Dq H ,
+.Nm
+will use horizontal split by default.
+Otherwise, vertical split will be used.
+The
+.Cm S
+key can be used to switch between vertical and horizontal split layout
+at run-time.
 .It Ev TOG_COLORS
 .Nm
 shows colorized output if this variable is set to a non-empty value.