docs: document service manager options for UIs

Signed-off-by: Aster Boese <asterboese@mailbox.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8545>
This commit is contained in:
Aster Boese
2026-08-15 18:58:26 +02:00
parent 6eebfb80fd
commit 3522ba4279
+16 -1
View File
@@ -39,6 +39,18 @@ https://wiki.postmarketos.org/wiki/Category:Interface
- Adding this to the `options` variable will mark the UI as requiring DRM
support to function, hiding it from devices that do not support DRM on
`pmbootstrap init`.
- **pmb:default-systemd**
- Adding this to the `options` variable will declare systemd as the default
service manager for the UI.
- **pmb:support-systemd**
- Adding this to the `options` variable will allow selecting the UI with
systemd during `pmbootstrap init`. Requires a `pmb:default-*` option.
- **pmb:default-openrc**
- Adding this to the `options` variable will declare OpenRC as the default
service manager for the UI.
- **pmb:support-openrc**
- Adding this to the `options` variable will allow selecting the UI with
OpenRC during `pmbootstrap init`. Requires a `pmb:default-*` option.
- **pkgdesc**
- The same as a normal APKBUILD's `pkgdesc`, but it is also shown during
`pmbootstrap init` beside the UI's name.
@@ -47,7 +59,10 @@ https://wiki.postmarketos.org/wiki/Category:Interface
- UIs are not required to support both OpenRC and systemd. While it is
recommended to support both to allow user choice, it is up to the UI
maintainers whether they support a service manager or not.
maintainers whether they support a service manager or not. Service managers
can be declared using the `pmb:support-systemd` and `pmb:support-openrc`
options in the `options` variable. These always need to be paired with a
`pmb:default-*` variable, even if only one service manager is supported.
- UIs shall work out-of-the-box on first initialization, meaning that they
should not require user intervention to start or require external
configuration.