refactor(column): define and use maximum 'statuscolumn' width

Problem:  The maximum 'statuscolumn' width and grow behavior is undocumented.
Solution: Define, use and document the maximum 'statuscolumn' width and grow behavior.

1 files changed, 7 insertions, 3 deletions

diff --git a/src/nvim/options.lua b/src/nvim/options.lua
index a997a41b77..74808485ba 100644
--- a/src/nvim/options.lua
+++ b/src/nvim/options.lua
@@ -8021,9 +8021,13 @@ return {
         %s	sign column for currently drawn line
         %C	fold column for currently drawn line
 
-        NOTE: To draw the sign and fold columns, their items must be included in
-        'statuscolumn'. Even when they are not included, the status column width
-        will adapt to the 'signcolumn' and 'foldcolumn' width.
+        The 'statuscolumn' width follows that of the default columns and
+        adapts to the |'numberwidth'|, |'signcolumn'| and |'foldcolumn'| option
+        values (regardless of whether the sign and fold items are present).
+        Aditionally, the 'statuscolumn' grows with the size of the evaluated
+        format string, up to a point (following the maximum size of the default
+        fold, sign and number columns). Shrinking only happens when the number
+        of lines in a buffer changes, or the 'statuscolumn' option is set.
 
         The |v:lnum|    variable holds the line number to be drawn.
         The |v:relnum|  variable holds the relative line number to be drawn.