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

12.0 12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since c71450c was c71450c, checked in by Douglas R. Reno <renodr@…>, 9 months ago

Tag the GNOME Desktop section

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