source: gnome/platform/gnome-session.xml@ b4079e2

12.1 ken/TL2024 lazarus trunk xry111/llvm18
Last change on this file since b4079e2 was 80f781e, checked in by Douglas R. Reno <renodr@…>, 2 months ago

Tag GNOME Desktop

Off to Apps next...
  • Property mode set to 100644
File size: 10.0 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY gnome-session-download-http
8 "&gnome-download-http;/gnome-session/&gnome-45;/gnome-session-&gnome-session-version;.tar.xz">
9 <!ENTITY gnome-session-download-ftp " ">
10 <!ENTITY gnome-session-md5sum "6702feed0873bb1ded999970ffddd096">
11 <!ENTITY gnome-session-size "476 KB">
12 <!ENTITY gnome-session-buildsize "14 MB">
13 <!ENTITY gnome-session-time "0.2 SBU">
14]>
15
16<sect1 id="gnome-session" xreflabel="gnome-session-&gnome-session-version;">
17 <?dbhtml filename="gnome-session.html"?>
18
19
20 <title>gnome-session-&gnome-session-version;</title>
21
22 <indexterm zone="gnome-session">
23 <primary sortas="a-gnome-session">gnome-session</primary>
24 </indexterm>
25
26 <sect2 role="package">
27 <title>Introduction to GNOME Session</title>
28
29 <para>
30 The <application>GNOME Session</application> package contains
31 the <application>GNOME</application> session manager.
32 </para>
33
34 &lfs121_checked;
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>
40 Download (HTTP): <ulink url="&gnome-session-download-http;"/>
41 </para>
42 </listitem>
43 <listitem>
44 <para>
45 Download (FTP): <ulink url="&gnome-session-download-ftp;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download MD5 sum: &gnome-session-md5sum;
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download size: &gnome-session-size;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Estimated disk space required: &gnome-session-buildsize;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated build time: &gnome-session-time;
66 </para>
67 </listitem>
68 </itemizedlist>
69
70 <bridgehead renderas="sect3">GNOME Session Dependencies</bridgehead>
71
72 <bridgehead renderas="sect4">Required</bridgehead>
73 <para role="required">
74 <phrase revision="sysv"><xref linkend="elogind"/>,</phrase>
75 <xref linkend="gnome-desktop"/>,
76 <xref linkend="json-glib"/>,
77 <xref linkend="mesa"/>,
78 <phrase revision="systemd"><xref role="runtime" linkend="systemd"/>
79 (runtime),</phrase>
80 and <xref linkend="upower"/>
81 </para>
82
83 <bridgehead renderas="sect4">Optional</bridgehead>
84 <para role="optional">
85 <xref linkend="xmlto"/>, and
86 <xref linkend="libxslt"/> with
87 <xref linkend="DocBook"/> and
88 <xref linkend="docbook-xsl"/> (to build the documentation)
89 </para>
90
91 </sect2>
92
93 <sect2 role="installation">
94 <title>Installation of GNOME Session</title>
95
96 <para>
97 When running GNOME under <xref linkend="wayland"/>, environment settings
98 are not imported for the user using the system profile. The Wayland
99 developers are currently undecided on a standard method to provide system
100 environment settings for user sessions. To work around this limitation,
101 execute the following command to make
102 <command>gnome-session</command> use a login shell:
103 </para>
104
105<screen><userinput>sed 's@/bin/sh@/bin/sh -l@' -i gnome-session/gnome-session.in</userinput></screen>
106
107<!--
108 <para revision="sysv">
109 Adapt meson.build so that gnome-session can build without systemd:
110 </para>
111
112<screen revision="sysv"><userinput remap="pre">sed -i "/ systemd_dep/,+3d;/if enable_systemd/a \ systemd_userunitdir = '/tmp\'" meson.build</userinput></screen>
113-->
114 <para>
115 Install <application>GNOME Session</application> by
116 running the following commands:
117 </para>
118
119<screen revision="sysv"><userinput>mkdir build &amp;&amp;
120cd build &amp;&amp;
121
122meson setup --prefix=/usr \
123 --buildtype=release \
124 -Dsystemd_journal=false \
125 -Dsystemduserunitdir=/tmp \
126 .. &amp;&amp;
127ninja</userinput></screen>
128
129<screen revision="systemd"><userinput>mkdir build &amp;&amp;
130cd build &amp;&amp;
131
132meson setup --prefix=/usr --buildtype=release .. &amp;&amp;
133ninja</userinput></screen>
134
135 <para>
136 This package does not come with a test suite.
137 </para>
138
139 <para>
140 Now, as the <systemitem class="username">root</systemitem> user:
141 </para>
142
143<screen role="root"><userinput>ninja install</userinput></screen>
144<!-- For some reason, there are I/O errors with the DTD @ freedesktop
145 that causes error messages to flood stdin. -->
146
147 <para>
148 Move the documentation to a versioned directory:
149 </para>
150
151<screen role="root"><userinput>mv -v /usr/share/doc/gnome-session{,-&gnome-session-version;}</userinput></screen>
152
153
154 <para>
155 This package creates two Xorg based <filename>.desktop</filename> files
156 in the <filename class="directory">/usr/share/xsessions/</filename>
157 directory, and two Wayland based <filename>.desktop</filename> files in
158 the <filename class="directory">/usr/share/wayland-sessions/</filename>
159 directory. Only one is needed in each directory on a BLFS system, so
160 prevent the extra files showing up as options in a display manager. As
161 the &root; user:
162 </para>
163
164<screen role="root"><userinput>rm -v /usr/share/xsessions/gnome.desktop &amp;&amp;
165rm -v /usr/share/wayland-sessions/gnome.desktop</userinput></screen>
166
167 <para revision="sysv">
168 Now, as the <systemitem class="username">root</systemitem> user,
169 remove systemd units that are useless on SysV systems:
170 </para>
171
172<screen role="root" revision="sysv"><userinput>rm -rv /tmp/{*.d,*.target,*.service}</userinput></screen>
173
174<!-- this part is not needed on systemd, since the dbus session is created
175by systemd-user.-->
176 <para revision="sysv">
177 The startup sequence of gnome-wayland needs to create a dbus session.
178 On SysV, this has to be added to the shipped
179 <filename>gnome-wayland.desktop</filename> file, which is written for
180 systemd. As the &root; user:
181 </para>
182
183<screen role="root" revision="sysv"><userinput>sed -e 's@^Exec=@&amp;/usr/bin/dbus-run-session @' \
184 -i /usr/share/wayland-sessions/gnome-wayland.desktop</userinput></screen>
185
186 </sect2>
187
188 <sect2 role="commands">
189 <title>Command Explanations</title>
190
191 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
192 href="../../xincludes/meson-buildtype-release.xml"/>
193
194 <para revision="sysv">
195 <parameter>-Dsystemd_journal=false</parameter>
196 and <parameter>-Dsystemduserunitdir=/tmp</parameter>: Allow building
197 with elogind support on a SysV based system.
198 </para>
199
200 </sect2>
201
202 <sect2 role="starting">
203 <title>Starting GNOME</title>
204
205 <para>
206 The easiest way to start GNOME is to use a display manager.
207 <xref linkend="gdm"/> is the recommended display manager.
208 </para>
209
210 <para>
211 It is also possible to start <application>GNOME</application> from the
212 command line. However, you must still have <xref linkend="gdm"/> installed
213 for some portions of the desktop to work. One reason to start from the
214 command line is if you want Wayland support on a system that has the
215 proprietary NVIDIA driver installed, since GDM will not show the Wayland
216 session type on such a system.
217 </para>
218
219 <para>
220 To start <application>GNOME</application> using
221 <xref role="nodep" linkend="xinit"/>, run the following commands:
222 </para>
223
224<screen role="nodump"><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
225<literal>dbus-run-session gnome-session</literal>
226EOF
227
228startx</userinput></screen>
229
230 <para>
231 Alternatively, to start <application>GNOME</application> with Wayland
232 support, run the following command:
233 </para>
234
235<screen role="nodump"><userinput>XDG_SESSION_TYPE=wayland dbus-run-session gnome-session</userinput></screen>
236
237 </sect2>
238
239 <sect2 role="content">
240 <title>Contents</title>
241
242 <segmentedlist>
243 <segtitle>Installed Programs</segtitle>
244 <segtitle>Installed Libraries</segtitle>
245 <segtitle>Installed Directories</segtitle>
246
247 <seglistitem>
248 <seg>
249 gnome-session, gnome-session-inhibit, and gnome-session-quit
250 </seg>
251 <seg>
252 None
253 </seg>
254 <seg>
255 /usr/share/doc/gnome-session-&gnome-session-version; and
256 /usr/share/gnome-session
257 </seg>
258 </seglistitem>
259 </segmentedlist>
260
261 <variablelist>
262 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
263 <?dbfo list-presentation="list"?>
264 <?dbhtml list-presentation="table"?>
265
266 <varlistentry id="gnome-session-prog">
267 <term><command>gnome-session</command></term>
268 <listitem>
269 <para>
270 is used to start up the <application>GNOME</application>
271 Desktop environment
272 </para>
273 <indexterm zone="gnome-session gnome-session-prog">
274 <primary sortas="b-gnome-session">gnome-session</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="gnome-session-inhibit">
280 <term><command>gnome-session-inhibit</command></term>
281 <listitem>
282 <para>
283 is used to inhibit certain <application>GNOME</application>
284 Session functionality while executing the given command
285 </para>
286 <indexterm zone="gnome-session gnome-session-inhibit">
287 <primary sortas="b-gnome-session-inhibit">gnome-session-inhibit</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 <varlistentry id="gnome-session-quit">
293 <term><command>gnome-session-quit</command></term>
294 <listitem>
295 <para>
296 is used to end the <application>GNOME</application> Session
297 </para>
298 <indexterm zone="gnome-session gnome-session-quit">
299 <primary sortas="b-gnome-session-quit">gnome-session-quit</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 </variablelist>
305
306 </sect2>
307
308</sect1>
Note: See TracBrowser for help on using the repository browser.