source: gnome/platform/gnome-shell.xml@ 966374a

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/soup3 xry111/xf86-video-removal
Last change on this file since 966374a was 966374a, checked in by Xi Ruoyao <xry111@…>, 20 months ago

gnome-shell: list libgweather as runtime dependency

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