I3: Improve distinction between config directives and commands

Created on 20 Mar 2019 · 4Comments · Source: i3/i3

I'm submitting a…

[ ] Bug
[] Feature Request
[x] Documentation Request
[ ] Other (Please describe in detail)

Current Behavior

In our support channels I see a frequent confusion of config directives and commands, specifically when it comes to for_window and match criteria. We should make clear what the difference between config / commands are, and that a user can only run commands at runtime but not change config.

i3 4.16

4.16 accepted documentation enhancement good first issue

Source

Airblader

Most helpful comment

Okay, I will get to it the. Thanks.

jeffhuxen on 21 Mar 2019

👍2

All 4 comments

I would be willing to do this. Would this be as simple as a text file, or would I edit the documentation file?

jeffhuxen on 20 Mar 2019

We should update the userguide for this (docs/userguide). It itself is already separated into config and commands, but I think the distinction isn't clear enough to users. Relevant sections are

Particularly in the latter one an explicit hint that config directives listed under https://i3wm.org/docs/userguide.html#configuring cannot be changed at runtime unless they happen to have a command equivalent would be extremely useful I think.

Airblader on 21 Mar 2019

Okay, I will get to it the. Thanks.

jeffhuxen on 21 Mar 2019

👍2

I agree, the for_window section starts out with