source: gnome/platform/gnome-shell.xml@ 700d5cf1

12.0 12.1 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 700d5cf1 was f78423d8, checked in by Xi Ruoyao <xry111@…>, 13 months ago

gnome-shell: Clean up dependencies

gnome-control-center is only required at runtime. But ibus, polkit, and
gnome-desktop are required at build time.

GTK4 is already included by gnome-desktop, so remove it.

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