source: gnome/platform/gnome-shell.xml@ 2c9b77a7

12.0 12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 2c9b77a7 was 2c9b77a7, checked in by Pierre Labastie <pierre.labastie@…>, 10 months ago

Update to gnome-shell-44.3

Reinstate tests on sysv, too
  • Property mode set to 100644
File size: 7.7 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-shell-download-http
8 "&gnome-download-http;/gnome-shell/&gnome-44;/gnome-shell-&gnome-shell-version;.tar.xz">
9 <!ENTITY gnome-shell-download-ftp
10 "&gnome-download-ftp;/gnome-shell/&gnome-44;/gnome-shell-&gnome-shell-version;.tar.xz">
11 <!ENTITY gnome-shell-md5sum "a73a7ba82782ad46378127a9a3acdec8">
12 <!ENTITY gnome-shell-size "1.9 MB">
13 <!ENTITY gnome-shell-buildsize "61 MB (with tests)">
14 <!ENTITY gnome-shell-time "0.2 SBU (Using parallelism=4; with tests)">
15]>
16
17<sect1 id="gnome-shell" xreflabel="gnome-shell-&gnome-shell-version;">
18 <?dbhtml filename="gnome-shell.html"?>
19
20
21 <title>gnome-shell-&gnome-shell-version;</title>
22
23 <indexterm zone="gnome-shell">
24 <primary sortas="a-gnome-shell">gnome-shell</primary>
25 </indexterm>
26
27 <sect2 role="package">
28 <title>Introduction to GNOME Shell</title>
29
30 <para>
31 The <application>GNOME Shell</application> is the core user interface of
32 the <application>GNOME</application> Desktop environment.
33 </para>
34
35 &lfs113_checked;
36
37 <bridgehead renderas="sect3">Package Information</bridgehead>
38 <itemizedlist spacing="compact">
39 <listitem>
40 <para>
41 Download (HTTP): <ulink url="&gnome-shell-download-http;"/>
42 </para>
43 </listitem>
44 <listitem>
45 <para>
46 Download (FTP): <ulink url="&gnome-shell-download-ftp;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download MD5 sum: &gnome-shell-md5sum;
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download size: &gnome-shell-size;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Estimated disk space required: &gnome-shell-buildsize;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated build time: &gnome-shell-time;
67 </para>
68 </listitem>
69 </itemizedlist>
70
71 <bridgehead renderas="sect3">GNOME Shell Dependencies</bridgehead>
72
73 <bridgehead renderas="sect4">Required</bridgehead>
74 <para role="required">
75 <xref linkend="evolution-data-server"/>,
76 <xref linkend="gcr4"/>,
77 <xref linkend="gjs"/>,
78 <xref linkend="gnome-desktop"/>,
79 <xref linkend="ibus"/>,
80 <xref linkend="mutter"/>,
81 <xref linkend="polkit"/>,
82 <xref linkend="sassc"/>, and
83 <xref linkend="startup-notification"/>
84 </para>
85
86 <bridgehead renderas="sect4">Recommended</bridgehead>
87 <para role="recommended">
88 <xref linkend="desktop-file-utils"/>,
89 <xref linkend="gnome-autoar"/>,
90 <xref linkend="gnome-bluetooth"/>,
91 <xref linkend="gst10-plugins-base"/>, and
92 <xref linkend="NetworkManager"/>
93 </para>
94
95 <bridgehead renderas="sect4">Optional</bridgehead>
96 <para role="optional">
97 <xref linkend="gtk-doc"/> and
98 <ulink url="https://github.com/scop/bash-completion">bash-completion</ulink>
99 </para>
100
101 <bridgehead renderas="sect4">Required Runtime Dependencies</bridgehead>
102 <para role="required">
103 <xref role="runtime" linkend="adwaita-icon-theme"/>,
104 <xref role="runtime" linkend="dconf"/>,
105 <phrase revision="sysv">
106 <xref role='runtime' linkend="elogind"/>,
107 </phrase>
108 <xref role="runtime" linkend="gdm"/>,
109 <xref role="runtime" linkend="gnome-backgrounds"/>,
110 <xref role="runtime" linkend="gnome-control-center"/>,
111 <xref role="runtime" linkend="libgweather"/>,
112 <phrase revision="sysv">and</phrase>
113 <phrase revision="systemd">
114 <xref role='runtime' linkend="systemd"/>, and
115 </phrase>
116 <xref role="runtime" linkend="telepathy-mission-control"/>
117 </para>
118
119 <bridgehead renderas="sect4"
120 revision="sysv">Recommended Runtime Dependency</bridgehead>
121 <para role="recommended" revision="sysv">
122 <xref linkend="blocaled" role="runtime"/>
123 </para>
124
125 </sect2>
126
127 <sect2 role="installation">
128 <title>Installation of GNOME Shell</title>
129
130 <para>
131 Install <application>GNOME Shell</application> by running the
132 following commands:
133 </para>
134
135<screen revision="sysv"><userinput>mkdir build &amp;&amp;
136cd build &amp;&amp;
137
138meson setup --prefix=/usr \
139 --buildtype=release \
140 -Dsystemd=false \
141 -Dtests=false \
142 .. &amp;&amp;
143ninja</userinput></screen>
144
145<screen revision="systemd"><userinput>mkdir build &amp;&amp;
146cd build &amp;&amp;
147
148meson setup --prefix=/usr \
149 --buildtype=release \
150 -Dtests=false \
151 .. &amp;&amp;
152ninja</userinput></screen>
153
154 <para>
155 To test the results, you need to remove the
156 <parameter>-Dtests=false</parameter> switch, and to have <xref
157 linkend="mutter"/> compiled and installed with tests also.
158
159 To run the tests, issue: <command>ninja test</command>. You must be
160 running an X session to run the tests. Some will fail if <xref
161 linkend="gdm"/> is not installed. <phrase revision="sysv">Several
162 more tests may fail in the Sysv environment.</phrase>
163 </para>
164
165 <para>
166 Now, as the <systemitem class="username">root</systemitem> user:
167 </para>
168
169<screen role="root"><userinput>ninja install</userinput></screen>
170
171 </sect2>
172
173 <sect2 role="commands">
174 <title>Command Explanations</title>
175
176 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
177 href="../../xincludes/meson-buildtype-release.xml"/>
178
179 <para revision="sysv">
180 <command>patch ...</command>: This patch fixes a bug when trying to
181 start an xwayland application on non systemd.
182 </para>
183
184 <para revision="sysv">
185 <parameter>-Dsystemd=false</parameter>: Prevents installing systemd
186 files, which are not needed in this version of BLFS.
187 </para>
188
189 <para>
190 <parameter>-Dtests=false</parameter>: Remove this switch if you want
191 to build the tests. But then <command>meson</command> will fail if
192 <xref linkend="mutter"/> tests are not installed.
193 </para>
194
195 <para>
196 <option>-Dextensions_tool=false</option>: This switch allows building
197 this package without <xref linkend='gnome-autoar'/> installed.
198 </para>
199
200 </sect2>
201
202 <sect2 role="content">
203 <title>Contents</title>
204
205 <segmentedlist>
206 <segtitle>Installed Programs</segtitle>
207 <segtitle>Installed Libraries</segtitle>
208 <segtitle>Installed Directories</segtitle>
209
210 <seglistitem>
211 <seg>
212 gnome-extensions, gnome-extensions-app, gnome-shell,
213 gnome-shell-extension-prefs, gnome-shell-extension-tool,
214 and gnome-shell-perf-tool
215 </seg>
216 <seg>
217 None
218 </seg>
219 <seg>
220 /usr/lib/gnome-shell,
221 /usr/share/gnome-shell,
222 /usr/share/gtk-doc/html/{shell,st} (optional), and
223 /usr/share/xdg-desktop-portal/
224 </seg>
225 </seglistitem>
226 </segmentedlist>
227
228 <variablelist>
229 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
230 <?dbfo list-presentation="list"?>
231 <?dbhtml list-presentation="table"?>
232
233 <varlistentry id="gnome-shell-prog">
234 <term><command>gnome-shell</command></term>
235 <listitem>
236 <para>
237 provides the core user interface functions for the
238 <application>GNOME</application> 3 Desktop
239 </para>
240 <indexterm zone="gnome-shell gnome-shell-prog">
241 <primary sortas="b-gnome-shell">gnome-shell</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 </variablelist>
247
248 </sect2>
249
250</sect1>
Note: See TracBrowser for help on using the repository browser.