From 5e95d487982b9362b544139b98d1da55fa6ef78c Mon Sep 17 00:00:00 2001 From: PS Date: Sat, 7 Feb 2026 10:20:30 +0100 Subject: Add doc --- doc/source/user/bundle/audio.html | 31 +++++++++++++ doc/source/user/bundle/compositor.html | 33 ++++++++++++++ doc/source/user/bundle/default.html | 39 +++++++++++++++++ doc/source/user/bundle/session-bus.html | 34 +++++++++++++++ doc/source/user/other/dbus-daemon.html | 44 +++++++++++++++++++ doc/source/user/xdg/xdg-runtime-dir.html | 75 ++++++++++++++++++++++++++++++++ 6 files changed, 256 insertions(+) create mode 100644 doc/source/user/bundle/audio.html create mode 100644 doc/source/user/bundle/compositor.html create mode 100644 doc/source/user/bundle/default.html create mode 100644 doc/source/user/bundle/session-bus.html create mode 100644 doc/source/user/other/dbus-daemon.html create mode 100644 doc/source/user/xdg/xdg-runtime-dir.html (limited to 'doc/source/user') diff --git a/doc/source/user/bundle/audio.html b/doc/source/user/bundle/audio.html new file mode 100644 index 0000000..687926e --- /dev/null +++ b/doc/source/user/bundle/audio.html @@ -0,0 +1,31 @@ + + + + + + + audio user bundle + + + +
+

+ goetia-base +
+ goetia +
+ Software +
+ 0x53.net +

+
+ +

The audio user bundle

+

+ This bundle abstracts over the different + autio daemon implementations, + so services requiring a running audion daemon + can depend on this. +

+ + diff --git a/doc/source/user/bundle/compositor.html b/doc/source/user/bundle/compositor.html new file mode 100644 index 0000000..9d10e89 --- /dev/null +++ b/doc/source/user/bundle/compositor.html @@ -0,0 +1,33 @@ + + + + + + + compositor user bundle + + + +
+

+ goetia-base +
+ goetia +
+ Software +
+ 0x53.net +

+
+ +

The compositor user bundle

+

+ This bundle shall contain the service corresponding to the + main compositing program, e.g. the + Wayland + compositor or + X11. + instance. +

+ + diff --git a/doc/source/user/bundle/default.html b/doc/source/user/bundle/default.html new file mode 100644 index 0000000..2192a15 --- /dev/null +++ b/doc/source/user/bundle/default.html @@ -0,0 +1,39 @@ + + + + + + + default user bundle + + + +
+

+ goetia-base +
+ goetia +
+ Software +
+ 0x53.net +

+
+ +

The default user bundle

+

+ This bundle is started when the + user supervision tree + is started and everything that is + desired to be autostarted should be part of it. + Minimize the amount of services in this bundle. + s6-rc + will automatically start (and stop) all dependencies. + Add only what should be unconditionally there. + An example of this would be a service + starting a wallpaper daemon, no other service + will probably depend on this but the user + wants the wallpaper to be there. +

+ + diff --git a/doc/source/user/bundle/session-bus.html b/doc/source/user/bundle/session-bus.html new file mode 100644 index 0000000..8984b80 --- /dev/null +++ b/doc/source/user/bundle/session-bus.html @@ -0,0 +1,34 @@ + + + + + + + session-bus user bundle + + + +
+

+ goetia-base +
+ goetia +
+ Software +
+ 0x53.net +

+
+ +

The session-bus user bundle

+

+ Some software requires a session-bus + - usually implementing the dbus interface. + The only currently available implementation + of this interface is + dbus-daemon. + The source directory is part of + goetia-base. +

+ + diff --git a/doc/source/user/other/dbus-daemon.html b/doc/source/user/other/dbus-daemon.html new file mode 100644 index 0000000..f5290c8 --- /dev/null +++ b/doc/source/user/other/dbus-daemon.html @@ -0,0 +1,44 @@ + + + + + + + dbus-daemon + + + +
+

+ goetia-base +
+ goetia +
+ Software +
+ 0x53.net +

+
+ +

The dbus-daemon service

+

+ This service starts a session + dbus-daemon. + It is important to set the environment variable + DBUS_SESSION_BUS_ADDRESS, + so other services depending on dbus-daemon can find it. +

+

+ The DBUS_SESSION_BUS_ADDRESS environment variable + should be set at + ${HOME}/@userconfdir@/@USERTREE@/env/DBUS_SESSION_BUS_ADDRESS, + by writing the address into this file + (see configuration directory). + It is recomended to set + ${HOME}/@userconfdir@/@USERTREE@/env/DBUS_SESSION_BUS_ADDRESS, + to + @tmpusdir@/@usrrundir@/@USER@/@USERTREE@/session-bus + (see runtime directory). +

+ + diff --git a/doc/source/user/xdg/xdg-runtime-dir.html b/doc/source/user/xdg/xdg-runtime-dir.html new file mode 100644 index 0000000..3b17d8b --- /dev/null +++ b/doc/source/user/xdg/xdg-runtime-dir.html @@ -0,0 +1,75 @@ + + + + + + + xdg-runtime-dir + + + +
+

+ goetia-base +
+ goetia +
+ Software +
+ 0x53.net +

+
+ +

The xdg-runtime-dir service

+

+ This service dynamically creates the directory + specified in the environment variable + XDG_RUNTIME_DIR. +

+

+ Starting this service creates the directory + and sets the proper permissions, + stopping it deletes it. +

+

+ It is recommended to set + XDG_RUNTIME_DIR + to the + @USER@/@USERTREE@/xdg-runtime-dir + subdirectory of the + user runtime directory. + This allows to follow the + XDG Base Directory Specification. +

+

+ If more than one + user supervision tree + per user is used to have multiple + sessions + with a distinct UI server, audio server, etc. + It makes sense for each session to have its own, + distinct xdg-runtime-dir, + since it is often used for sockets and temporary files + of said UI server, audio server, etc. + Setting + XDG_RUNTIME_DIR + as described above, allows for this. + Note, however, that this deviates from the + XDG Base Directory Specification. +

+

+ All user services writing to or reading from + XDG_RUNTIME_DIR + should depend on this service. +

+

See also

+ + + -- cgit v1.2.3