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

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/xf86-video-removal
Last change on this file since c248601 was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 18 months ago

Remove sect1info tags

They only contain a date tag that is nowhere used.
  • 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
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 &lfs112_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 <!--
84 <bridgehead renderas="sect3" revision="sysv">Additional Downloads</bridgehead>
85 <itemizedlist spacing="compact" revision="sysv">
86 <listitem>
87 <para>
88 Required patch:
89 <ulink url="&patch-root;/gnome-shell-&gnome-shell-version;-fix_xwayland-1.patch"/>
90 </para>
91 </listitem>
92 </itemizedlist>
93 -->
94
95 <bridgehead renderas="sect3">GNOME Shell Dependencies</bridgehead>
96
97 <bridgehead renderas="sect4">Required</bridgehead>
98 <para role="required">
99 <xref linkend="evolution-data-server"/>,
100 <xref linkend="gjs"/>,
101 <xref linkend="gnome-autoar"/>,
102 <xref linkend="gnome-control-center"/>,
103 <xref linkend="gtk4"/>,
104 <xref role="runtime" linkend="libgweather"/> (runtime),
105 <xref linkend="mutter"/>,
106 <xref linkend="sassc"/>,
107 <xref linkend="startup-notification"/>, and
108 <phrase revision="sysv"><xref linkend="elogind"/></phrase>
109 <phrase revision="systemd"><xref linkend="systemd"/></phrase>
110 </para>
111
112 <bridgehead renderas="sect4">Recommended</bridgehead>
113 <para role="recommended">
114 <xref linkend="desktop-file-utils"/>,
115 <xref linkend="gnome-bluetooth"/>,
116 <xref linkend="gst10-plugins-base"/>, and
117 <xref linkend="NetworkManager"/>
118 </para>
119
120 <bridgehead renderas="sect4"
121 revision="sysv">Recommended (Runtime)</bridgehead>
122 <para role="recommended" revision="sysv">
123 <xref linkend="blocaled" role="runtime"/>
124 </para>
125
126 <bridgehead renderas="sect4">Optional</bridgehead>
127 <para role="optional">
128 <xref linkend="gtk-doc"/> and
129 <ulink url="https://github.com/scop/bash-completion">bash-completion</ulink>
130 </para>
131
132 <bridgehead renderas="sect4">Runtime Dependencies</bridgehead>
133 <para role="required">
134 <xref role="runtime" linkend="adwaita-icon-theme"/>,
135 <xref role="runtime" linkend="dconf"/>,
136 <xref role="runtime" linkend="gdm"/>,
137 <xref role="runtime" linkend="gnome-backgrounds"/>, and
138 <xref role="runtime" linkend="telepathy-mission-control"/>
139 </para>
140
141 <para condition="html" role="usernotes">User Notes:
142 <ulink url="&blfs-wiki;/gnome-shell"/>
143 </para>
144 </sect2>
145
146 <sect2 role="installation">
147 <title>Installation of GNOME Shell</title>
148
149 <para>
150 Install <application>GNOME Shell</application> by running the
151 following commands:
152 </para>
153
154<screen revision="sysv"><userinput>mkdir build &amp;&amp;
155cd build &amp;&amp;
156
157meson --prefix=/usr \
158 --buildtype=release \
159 -Dsystemd=false \
160 -Dtests=false \
161 .. &amp;&amp;
162ninja</userinput></screen>
163
164<screen revision="systemd"><userinput>mkdir build &amp;&amp;
165cd build &amp;&amp;
166
167meson --prefix=/usr --buildtype=release -Dtests=false .. &amp;&amp;
168ninja</userinput></screen>
169
170 <para revision='sysv'>
171 This package does not come with a working test suite in a
172 SystemV environment.
173 </para>
174
175 <para revision='systemd'>
176 To test the results, you need to remove the
177 <parameter>-Dtests=false</parameter> switch, and to have <xref
178 linkend="mutter"/> compiled and installed with tests also.
179
180 To run the tests, issue: <command>ninja test</command>. You must be
181 running an X session to run the tests. Some will fail if <xref
182 linkend="gdm"/> is not installed.
183 </para>
184
185 <para>
186 Now, as the <systemitem class="username">root</systemitem> user:
187 </para>
188
189<screen role="root"><userinput>ninja install</userinput></screen>
190
191 </sect2>
192
193 <sect2 role="commands">
194 <title>Command Explanations</title>
195
196 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
197 href="../../xincludes/meson-buildtype-release.xml"/>
198
199 <para revision="sysv">
200 <command>patch ...</command>: This patch fixes a bug when trying to
201 start an xwayland application on non systemd.
202 </para>
203
204 <para revision="sysv">
205 <parameter>-Dsystemd=false</parameter>: Prevents installing systemd
206 files, which are not needed in this version of BLFS.
207 </para>
208
209 <para>
210 <parameter>-Dtests=false</parameter>: Remove this switch if you want
211 to build the tests. But then <command>meson</command> will fail if
212 <xref linkend="mutter"/> tests are not installed.
213 </para>
214
215 </sect2>
216
217 <sect2 role="content">
218 <title>Contents</title>
219
220 <segmentedlist>
221 <segtitle>Installed Programs</segtitle>
222 <segtitle>Installed Libraries</segtitle>
223 <segtitle>Installed Directories</segtitle>
224
225 <seglistitem>
226 <seg>
227 gnome-extensions, gnome-extensions-app, gnome-shell,
228 gnome-shell-extension-prefs, gnome-shell-extension-tool,
229 and gnome-shell-perf-tool
230 </seg>
231 <seg>
232 None
233 </seg>
234 <seg>
235 /usr/lib/gnome-shell,
236 /usr/share/gnome-shell,
237 /usr/share/gtk-doc/html/{shell,st} (optional), and
238 /usr/share/xdg-desktop-portal/
239 </seg>
240 </seglistitem>
241 </segmentedlist>
242
243 <variablelist>
244 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
245 <?dbfo list-presentation="list"?>
246 <?dbhtml list-presentation="table"?>
247
248 <varlistentry id="gnome-shell-prog">
249 <term><command>gnome-shell</command></term>
250 <listitem>
251 <para>
252 provides the core user interface functions for the
253 <application>GNOME</application> 3 Desktop
254 </para>
255 <indexterm zone="gnome-shell gnome-shell-prog">
256 <primary sortas="b-gnome-shell">gnome-shell</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260
261 </variablelist>
262
263 </sect2>
264
265</sect1>
Note: See TracBrowser for help on using the repository browser.