Skip to content

Conversation

@alex-huff
Copy link
Contributor

Currently, the documentation for smart_borders claims that when smart_borders is set to 'no_gaps', borders will only be enabled when the workspace has more than one visible child and gaps are equal to zero. However, the real behavior of 'no_gaps' is that borders are enabled when:

  • The workspace has more than one visible child.

or,

  • There are non-zero gaps between any of the workspace's edges and the corresponding edge of the output.

This commit adjusts the wording of the smart_borders documentation to reflect the true behavior of the option.

Currently, the documentation for smart_borders claims that when
smart_borders is set to 'no_gaps', borders will only be enabled when the
workspace has more than one visible child and gaps are equal to zero.
However, the real behavior of 'no_gaps' is that borders are enabled
when:
- The workspace has more than one visible child.
or,
- There are non-zero gaps between any of the workspace's edges and the
  corresponding edge of the output.
This commit adjusts the wording of the smart_borders documentation to
reflect the true behavior of the option.
@kennylevinsen
Copy link
Member

Notes:

  1. i3 apparently dropped the option in early 2024 (smart_borders: Deprecate option i3/i3#5889)
  2. The documentation for hidge_edge_borders smart seems wrong, referencing smart_borders smart (which does not exist)...

@alex-huff
Copy link
Contributor Author

2. The documentation for hidge_edge_borders smart seems wrong, referencing smart_borders smart (which does not exist)...

Yes the documentation regarding all the smart features was very confusing (and sometimes wrong) when I was first reading it. I had to resort to looking at the code to see what it did.

@alex-huff
Copy link
Contributor Author

alex-huff commented May 19, 2025

After not looking at this for months and re-reading the changes I made to the documentation, I am not sure that my changes make the docs any less confusing. It might even make things more confusing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants