swaywm / sway

i3-compatible Wayland compositor
https://swaywm.org
MIT License
14.73k stars 1.11k forks source link

create_output is undocumented #5553

Open rpigott opened 4 years ago

rpigott commented 4 years ago

Headlining the new features for 1.5 is the new create_output command, but it doesn't appear in sway(5).

Steps to reproduce:

$ swaymsg -t get_version
sway version v1.5-e215557b (Jul 16 2020, branch 'master')
$ MANPAGER=less LESS=+/create_output man 5 sway
Pattern not found

:(

rpigott commented 4 years ago

Also could there maybe be a "docs" issue label? Wasn't sure where to file this.

emersion commented 4 years ago

Ooops. It was originally a developer-only feature, so intentionally undocumented. But now that it can be useful to end-users, it should definitely be documented.

Zocker1999NET commented 4 years ago

Is there somewhere a developer-doc already existing? It could be used as template for the end-user doc and maybe useful for all finding this issue.

For references:

progandy commented 3 years ago

I wonder if it should remain undocumented and the command merged with output, like

output "HL_MY_NAME" create (any name prefixed with HL that does not exist) output "HL_MY_NAME" destroy (output "*" create to create a sequential HEADLESS# name)

thecoder-001 commented 3 years ago

Just posting it here for anyone else who has stumbled here & wants to get things working without looking at the commits to figure things out: Someone at reddit posted their setup here along with an example config.