Implement per side and per direction outer gaps

This introduces the following command extensions from `i3-gaps`:
* `gaps horizontal|vertical|top|right|bottom|left <amount>`
* `gaps horizontal|vertical|top|right|bottom|left all|current
set|plus|minus <amount>`
* `workspace <ws> gaps horizontal|vertical|top|right|bottom|left
<amount>`

`inner` and `outer` are also still available as options for all three
of the above commands. `outer` now acts as a shorthand to set/alter
all sides.

Additionally, this fixes two bugs with the prevention of invalid gap
configurations for workspace configs:
1. If outer gaps were not set and inner gaps were, the outer gaps
would be snapped to the negation of the inner gaps due to `INT_MIN`
being less than the negation. This took precedence over the default
outer gaps.
2. Similarly, if inner gaps were not set and outer gaps were, inner
gaps would be set to zero, which would take precedence over the
default inner gaps.

Fixing both of the above items also requires checking the gaps again
when creating a workspace since the default outer gaps can be smaller
than the negation of the workspace specific inner gaps.

1 files changed, 12 insertions, 6 deletions

diff --git a/sway/sway.5.scd b/sway/sway.5.scd
index 4a645837..3bf6233d 100644
--- a/sway/sway.5.scd
+++ b/sway/sway.5.scd
@@ -133,9 +133,12 @@ They are expected to be used with *bindsym* or at runtime through *swaymsg*(1).
 *fullscreen*
         Toggles fullscreen for the focused view.
 
-*gaps* inner|outer all|current set|plus|minus <amount>
+*gaps* inner|outer|horizontal|vertical|top|right|bottom|left all|current
+set|plus|minus <amount>
         Changes the _inner_ or _outer_ gaps for either _all_ workspaces or the
-        _current_ workspace.
+        _current_ workspace. _outer_ gaps can be altered per side with _top_,
+        _right_, _bottom_, and _left_ or per direction with _horizontal_ and
+        _vertical_.
 
 *layout* default|splith|splitv|stacking|tabbed
         Sets the layout mode of the focused container.
@@ -429,14 +432,16 @@ The default colors are:
         _focus\_wrapping force_. This is only available for convenience. Please
         use _focus\_wrapping_ instead when possible.
 
-*gaps* inner|outer <amount>
+*gaps* inner|outer|horizontal|vertical|top|right|bottom|left <amount>
         Sets default _amount_ pixels of _inner_ or _outer_ gap, where the inner
         affects spacing around each view and outer affects the spacing around each
         workspace. Outer gaps are in addition to inner gaps. To reduce or remove
-        outer gaps, outer gaps can be set to a negative value.
+        outer gaps, outer gaps can be set to a negative value. _outer_ gaps can
+        also be specified per side with _top_, _right_, _bottom_, and _left_ or
+        per direction with _horizontal_ and _vertical_.
 
         This affects new workspaces only, and is used when the workspace doesn't
-        have its own gaps settings (see: workspace <ws> gaps inner|outer <amount>).
+        have its own gaps settings (see: workspace <ws> gaps ...).
 
 *hide\_edge\_borders* none|vertical|horizontal|both|smart|smart\_no\_gaps
         Hides window borders adjacent to the screen edges. Default is _none_.
@@ -549,7 +554,8 @@ The default colors are:
 *workspace* back\_and\_forth
         Switches to the previously focused workspace.
 
-*workspace* <name> gaps inner|outer <amount>
+*workspace* <name> gaps inner|outer|horizontal|vertical|top|right|bottom|left
+<amount>
         Specifies that workspace _name_ should have the given gaps settings when it
         is created.