source: gnome/platform/gnome-shell.xml@ e917814

12.0 12.1 gimp3 ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/for-12.3 xry111/llvm18 xry111/spidermonkey128
Last change on this file since e917814 was 274ac683, checked in by Xi Ruoyao <xry111@…>, 14 months ago

gnome: Remove non-exist User Notes link

Part of User Notes removal by
​https://www.linuxfromscratch.org/~xry111/remove-nonexist-usernote.sh
  • 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-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 </sect2>
135
136 <sect2 role="installation">
137 <title>Installation of GNOME Shell</title>
138
139 <para>
140 Install <application>GNOME Shell</application> by running the
141 following commands:
142 </para>
143
144<screen revision="sysv"><userinput>mkdir build &amp;&amp;
145cd build &amp;&amp;
146
147meson setup --prefix=/usr \
148 --buildtype=release \
149 -Dsystemd=false \
150 -Dtests=false \
151 .. &amp;&amp;
152ninja</userinput></screen>
153
154<screen revision="systemd"><userinput>mkdir build &amp;&amp;
155cd build &amp;&amp;
156
157meson setup --prefix=/usr \
158 --buildtype=release \
159 -Dtests=false \
160 .. &amp;&amp;
161ninja</userinput></screen>
162
163 <para revision='sysv'>
164 This package does not come with a working test suite in a
165 SystemV environment.
166 </para>
167
168 <para revision='systemd'>
169 To test the results, you need to remove the
170 <parameter>-Dtests=false</parameter> switch, and to have <xref
171 linkend="mutter"/> compiled and installed with tests also.
172
173 To run the tests, issue: <command>ninja test</command>. You must be
174 running an X session to run the tests. Some will fail if <xref
175 linkend="gdm"/> is not installed.
176 </para>
177
178 <para>
179 Now, as the <systemitem class="username">root</systemitem> user:
180 </para>
181
182<screen role="root"><userinput>ninja install</userinput></screen>
183
184 </sect2>
185
186 <sect2 role="commands">
187 <title>Command Explanations</title>
188
189 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
190 href="../../xincludes/meson-buildtype-release.xml"/>
191
192 <para revision="sysv">
193 <command>patch ...</command>: This patch fixes a bug when trying to
194 start an xwayland application on non systemd.
195 </para>
196
197 <para revision="sysv">
198 <parameter>-Dsystemd=false</parameter>: Prevents installing systemd
199 files, which are not needed in this version of BLFS.
200 </para>
201
202 <para>
203 <parameter>-Dtests=false</parameter>: Remove this switch if you want
204 to build the tests. But then <command>meson</command> will fail if
205 <xref linkend="mutter"/> tests are not installed.
206 </para>
207
208 <para>
209 <option>-Dextensions_tool=false</option>: This switch allows building
210 this package without <xref linkend='gnome-autoar'/> installed.
211 </para>
212
213 </sect2>
214
215 <sect2 role="content">
216 <title>Contents</title>
217
218 <segmentedlist>
219 <segtitle>Installed Programs</segtitle>
220 <segtitle>Installed Libraries</segtitle>
221 <segtitle>Installed Directories</segtitle>
222
223 <seglistitem>
224 <seg>
225 gnome-extensions, gnome-extensions-app, gnome-shell,
226 gnome-shell-extension-prefs, gnome-shell-extension-tool,
227 and gnome-shell-perf-tool
228 </seg>
229 <seg>
230 None
231 </seg>
232 <seg>
233 /usr/lib/gnome-shell,
234 /usr/share/gnome-shell,
235 /usr/share/gtk-doc/html/{shell,st} (optional), and
236 /usr/share/xdg-desktop-portal/
237 </seg>
238 </seglistitem>
239 </segmentedlist>
240
241 <variablelist>
242 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
243 <?dbfo list-presentation="list"?>
244 <?dbhtml list-presentation="table"?>
245
246 <varlistentry id="gnome-shell-prog">
247 <term><command>gnome-shell</command></term>
248 <listitem>
249 <para>
250 provides the core user interface functions for the
251 <application>GNOME</application> 3 Desktop
252 </para>
253 <indexterm zone="gnome-shell gnome-shell-prog">
254 <primary sortas="b-gnome-shell">gnome-shell</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 </variablelist>
260
261 </sect2>
262
263</sect1>
Note: See TracBrowser for help on using the repository browser.