labwc/docs
tokyo4j 06505d24c8
Some checks failed
labwc.github.io / notify (push) Has been cancelled
rcxml: discourage empty strings in rc.xml configuration
Background:
I rewrote the config parser in 9462457..2f414a4, but it broke certain
configurations by changing how empty strings are handled: they were mostly
just ignored before my parser rewrite, but after that, they are
interpreted as just empty strings (output="" is considered as 'output named ""').

Though that was unintentional, I believe ignoring empty strings was not a
good idea in the first place, as we already allow empty strings for
certain configurations (e.g. `<desktop prefix="">`), which makes the
parser's behavior inconsistent.

Change:
So let's clarify that we intend to read empty strings as empty strings.
As a preparation, this commit adds warnings for empty strings we are
currently ignoring, so that users can be informed that we intend to just
read empty strings (e.g. `<theme name="">`) as empty strings in the future.
I removed existing empty strings in `rc.xml.all` to avoid warnings when
reading it.
2025-12-04 05:02:26 +09:00
..
autostart documentation: s/view/window/ 2025-05-25 01:31:40 +09:00
environment docs/environment: remove example MOZ_ENABLE_WAYLAND=1 2024-12-12 20:13:10 +00:00
labnag.1.scd labnag: add --keyboard-focus option 2025-10-13 19:03:43 +01:00
labwc-actions.5.scd Add directional options to Resize action: 2025-12-04 03:01:27 +09:00
labwc-config.5.scd cycle: update config to <osd output="all|cursor|focused"> 2025-12-02 17:09:54 +01:00
labwc-menu.5.scd documentation: s/view/window/ 2025-05-25 01:31:40 +09:00
labwc-theme.5.scd osd-classic: add theme options for selected window item 2025-10-13 01:46:43 +09:00
labwc.1.scd menu: refactor parser 2025-08-04 21:41:14 +01:00
menu.xml docs/: remove XML declarations in .xml files 2025-10-21 12:30:32 +09:00
meson.build Add labnag 2025-08-09 10:44:03 +01:00
rc.xml docs/: remove XML declarations in .xml files 2025-10-21 12:30:32 +09:00
rc.xml.all rcxml: discourage empty strings in rc.xml configuration 2025-12-04 05:02:26 +09:00
README xwayland: support xinitrc scripts to configure server on launch (#1963) 2024-07-20 09:40:11 +01:00
shutdown docs: add example shutdown file 2024-06-01 23:53:34 +02:00
themerc osd-classic: add theme options for selected window item 2025-10-13 01:46:43 +09:00
xinitrc xwayland: support xinitrc scripts to configure server on launch (#1963) 2024-07-20 09:40:11 +01:00

Config layout for ~/.config/labwc/
- autostart
- environment
- menu.xml
- rc.xml
- shutdown
- themerc-override
- xinitrc

See `man labwc-config and `man labwc-theme` for further details.