source: gnome/platform/gnome-session.xml@ 4c24eb0

10.1 11.0 qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 4c24eb0 was 4c24eb0, checked in by Pierre Labastie <pieere@…>, 7 months ago

Remove period at the end of short descriptions.
In the process, some attributes in single quotes have been changed to double
quotes, and a few attribute lists have been written on one line instead of
several lines.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24236 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.5 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-minor-38;/gnome-session-&gnome-session-version;.tar.xz">
9 <!ENTITY gnome-session-download-ftp
10 "&gnome-download-ftp;/gnome-session/&gnome-minor-38;/gnome-session-&gnome-session-version;.tar.xz">
11 <!ENTITY gnome-session-md5sum "736024b46e2542b9b68adaa43f754f49">
12 <!ENTITY gnome-session-size "472 KB">
13 <!ENTITY gnome-session-buildsize "15 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 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>gnome-session-&gnome-session-version;</title>
26
27 <indexterm zone="gnome-session">
28 <primary sortas="a-gnome-session">gnome-session</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to GNOME Session</title>
33
34 <para>
35 The <application>GNOME Session</application> package contains
36 the <application>GNOME</application> session manager.
37 </para>
38
39 &lfs10_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&gnome-session-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&gnome-session-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &gnome-session-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &gnome-session-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &gnome-session-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &gnome-session-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">GNOME Session Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Required</bridgehead>
78 <para role="required">
79 <xref linkend="dbus-glib"/>,
80 <phrase revision="sysv"><xref role="runtime" linkend="elogind"/>,</phrase>
81 <xref linkend="gnome-desktop"/>,
82 <xref linkend="json-glib"/>,
83 <xref linkend="mesa"/>,
84 <phrase revision="systemd"><xref role="runtime" linkend="systemd"/>,</phrase>
85 and <xref linkend="upower"/>
86 </para>
87
88 <bridgehead renderas="sect4">Optional</bridgehead>
89 <para role="optional">
90 <xref linkend="GConf"/>,
91 <xref linkend="xmlto"/>, and
92 <xref linkend="libxslt"/> with
93 <xref linkend="DocBook"/> and
94 <xref linkend="docbook-xsl"/> (to build the documentation)
95 </para>
96
97 <para condition="html" role="usernotes">User Notes:
98 <ulink url="&blfs-wiki;/gnome-session"/>
99 </para>
100 </sect2>
101
102 <sect2 role="installation">
103 <title>Installation of GNOME Session</title>
104
105 <para>
106 When running GNOME under <xref linkend="wayland"/>, environment settings
107 are not imported for the user using the system profile. The Wayland
108 developers are currently undecided on a standard method to provide system
109 environment settings for user sessions. To work around this limitation,
110 execute the following command to make
111 <command>gnome-session</command> use a login shell:
112 </para>
113
114<screen><userinput>sed 's@/bin/sh@/bin/sh -l@' -i gnome-session/gnome-session.in</userinput></screen>
115
116 <para revision="systemd">
117 Adapt gnome-session to changes in systemd-247:
118 </para>
119
120<screen revision="systemd"><userinput remap="pre">echo 'Slice=-.slice' >> data/gnome-session-restart-dbus.service.in</userinput></screen>
121
122 <para revision="sysv">
123 Adapt meson.build so that gnome-session can build without systemd:
124 </para>
125
126<screen revision="sysv"><userinput remap="pre">sed -i "/ systemd_dep/,+3d;/if enable_systemd/a \ systemd_userunitdir = '/tmp\'" meson.build</userinput></screen>
127
128 <para>
129 Install <application>GNOME Session</application> by
130 running the following commands:
131 </para>
132
133<screen revision="sysv"><userinput>mkdir build &amp;&amp;
134cd build &amp;&amp;
135
136meson --prefix=/usr \
137 -Dsystemd_journal=false \
138 .. &amp;&amp;
139ninja</userinput></screen>
140
141<screen revision="systemd"><userinput>mkdir build &amp;&amp;
142cd build &amp;&amp;
143
144meson --prefix=/usr .. &amp;&amp;
145ninja</userinput></screen>
146
147 <para>
148 This package does not come with a test suite.
149 </para>
150
151 <para>
152 Now, as the <systemitem class="username">root</systemitem> user:
153 </para>
154
155<screen role="root"><userinput>ninja install</userinput></screen>
156<!-- For some reason, there are I/O errors with the DTD @ freedesktop
157 that causes error messages to flood stdin. -->
158
159 <para revision="sysv">
160 Now, as the <systemitem class="username">root</systemitem> user,
161 remove systemd units that are useless on SysV systems:
162 </para>
163
164<screen role="root" revision="sysv"><userinput>rm -rv /tmp/{*.d,*.target,*.service}</userinput></screen>
165
166 </sect2>
167
168 <sect2 role="content">
169 <title>Contents</title>
170
171 <segmentedlist>
172 <segtitle>Installed Programs</segtitle>
173 <segtitle>Installed Libraries</segtitle>
174 <segtitle>Installed Directories</segtitle>
175
176 <seglistitem>
177 <seg>
178 gnome-session, gnome-session-custom-session, gnome-session-inhibit,
179 and gnome-session-quit
180 </seg>
181 <seg>
182 None
183 </seg>
184 <seg>
185 /usr/share/doc/gnome-session-&gnome-session-version; and
186 /usr/share/gnome-session
187 </seg>
188 </seglistitem>
189 </segmentedlist>
190
191 <variablelist>
192 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
193 <?dbfo list-presentation="list"?>
194 <?dbhtml list-presentation="table"?>
195
196 <varlistentry id="gnome-session-prog">
197 <term><command>gnome-session</command></term>
198 <listitem>
199 <para>
200 is used to start up the <application>GNOME</application>
201 Desktop environment
202 </para>
203 <indexterm zone="gnome-session gnome-session-prog">
204 <primary sortas="b-gnome-session">gnome-session</primary>
205 </indexterm>
206 </listitem>
207 </varlistentry>
208
209 <varlistentry id="gnome-session-inhibit">
210 <term><command>gnome-session-inhibit</command></term>
211 <listitem>
212 <para>
213 is used to inhibit certain <application>GNOME</application>
214 Session functionality while executing the given command
215 </para>
216 <indexterm zone="gnome-session gnome-session-inhibit">
217 <primary sortas="b-gnome-session-inhibit">gnome-session-inhibit</primary>
218 </indexterm>
219 </listitem>
220 </varlistentry>
221
222 <varlistentry id="gnome-session-quit">
223 <term><command>gnome-session-quit</command></term>
224 <listitem>
225 <para>
226 is used to end the <application>GNOME</application> Session
227 </para>
228 <indexterm zone="gnome-session gnome-session-quit">
229 <primary sortas="b-gnome-session-quit">gnome-session-quit</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 </variablelist>
235
236 </sect2>
237
238</sect1>
Note: See TracBrowser for help on using the repository browser.