2 Commits

Author	SHA1	Message	Date
Zbigniew Jędrzejewski-Szmek	572eb058cf	Add SPDX license identifiers to man pages	2017-11-19 19:08:15 +01:00
Alan Jenkins	1c97e2ebf4	man: de-emphasize *_get_session() ... Explanation: "Please note the login session may be limited to a stub process or two. User processes may instead be started from their systemd user manager, e.g. GUI applications started using DBus activation, as well as service processes which are shared between multiple logins of the same user." The most glaring example being when you run commands from gnome-terminal, or as you see nowadays, "gnome-terminal-server". *_get_session() is still currently used (directly or indirectly) by Xorg, Weston etc. running within the session scope. That setup is perfectly functional, although code will be more generally useful if it is able to run outside the session scope.[1] [1] https://wiki.archlinux.org/index.php/Systemd/User#Xorg_as_a_systemd_user_service Re-order the man pages a bit at the same time. This is to avoid having the first and titular entry introduce the session concept, and then immediately try and persuade you not to use it :).	2017-10-18 09:47:10 +01:00