source: gnome/platform/gnome-shell.xml

trunk
Last change on this file was 3a0e7d3, checked in by Douglas R. Reno <renodr@…>, 6 days ago

gnome-shell/libreoffice: remove dependencies on telepathy components.

  • Property mode set to 100644
File size: 8.8 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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-46;/gnome-shell-&gnome-shell-version;.tar.xz">
9 <!ENTITY gnome-shell-download-ftp " ">
10 <!ENTITY gnome-shell-md5sum "ebb54596ebd8b65552cb63bb56d3226a">
11 <!ENTITY gnome-shell-size "1.9 MB">
12 <!ENTITY gnome-shell-buildsize "56 MB (with tests)">
13 <!ENTITY gnome-shell-time "0.3 SBU (Using parallelism=4; with tests)">
14]>
15
16<sect1 id="gnome-shell" xreflabel="gnome-shell-&gnome-shell-version;">
17 <?dbhtml filename="gnome-shell.html"?>
18
19
20 <title>gnome-shell-&gnome-shell-version;</title>
21
22 <indexterm zone="gnome-shell">
23 <primary sortas="a-gnome-shell">gnome-shell</primary>
24 </indexterm>
25
26 <sect2 role="package">
27 <title>Introduction to GNOME Shell</title>
28
29 <para>
30 The <application>GNOME Shell</application> is the core user interface of
31 the <application>GNOME</application> Desktop environment.
32 </para>
33
34 &lfs121_checked;
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>
40 Download (HTTP): <ulink url="&gnome-shell-download-http;"/>
41 </para>
42 </listitem>
43 <listitem>
44 <para>
45 Download (FTP): <ulink url="&gnome-shell-download-ftp;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download MD5 sum: &gnome-shell-md5sum;
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download size: &gnome-shell-size;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Estimated disk space required: &gnome-shell-buildsize;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated build time: &gnome-shell-time;
66 </para>
67 </listitem>
68 </itemizedlist>
69
70 <bridgehead renderas="sect3">GNOME Shell Dependencies</bridgehead>
71
72 <bridgehead renderas="sect4">Required</bridgehead>
73 <para role="required">
74 <xref linkend="evolution-data-server"/>,
75 <xref linkend="gcr4"/>,
76 <xref linkend="gjs"/>,
77 <xref linkend="gnome-desktop"/>,
78 <xref linkend="ibus"/>,
79 <xref linkend="mutter"/>,
80 <xref linkend="polkit"/>,
81 <xref linkend="sassc"/>, and
82 <xref linkend="startup-notification"/>
83 </para>
84
85 <bridgehead renderas="sect4">Recommended</bridgehead>
86 <para role="recommended">
87 <xref linkend="desktop-file-utils"/>,
88 <xref linkend="gnome-autoar"/>,
89 <xref linkend="gnome-bluetooth"/>,
90 <xref linkend="gst10-plugins-base"/>,
91 <xref linkend="NetworkManager"/>, and
92 <xref linkend="power-profiles-daemon"/>
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="gnome-menus"/>,
112 <phrase revision="sysv">and</phrase>
113 <xref role="runtime" linkend="libgweather"/>
114 <phrase revision="systemd">, and</phrase>
115 <phrase revision="systemd">
116 <xref role='runtime' linkend="systemd"/>
117 </phrase>
118 </para>
119
120 <bridgehead renderas="sect4"
121 revision="sysv">Recommended Runtime Dependency</bridgehead>
122 <para role="recommended" revision="sysv">
123 <xref linkend="blocaled" role="runtime"/>
124 </para>
125
126 </sect2>
127
128 <sect2 role="installation">
129 <title>Installation of GNOME Shell</title>
130
131<!--
132 <para>
133 First, fix a regression that appears when using glib-2.80.2 or later:
134 </para>
135
136<screen><userinput remap="pre">sed -i 's/gnome.ScreenCast.Stream/gnome.Mutter.Screencast/' \
137 js/dbusServices/screencast/screencastService.js</userinput></screen>
138-->
139
140 <para>
141 Install <application>GNOME Shell</application> by running the
142 following commands:
143 </para>
144
145<screen revision="sysv"><userinput>mkdir build &amp;&amp;
146cd build &amp;&amp;
147
148meson setup --prefix=/usr \
149 --buildtype=release \
150 -Dsystemd=false \
151 -Dtests=false \
152 .. &amp;&amp;
153ninja</userinput></screen>
154
155<screen revision="systemd"><userinput>mkdir build &amp;&amp;
156cd build &amp;&amp;
157
158meson setup --prefix=/usr \
159 --buildtype=release \
160 -Dtests=false \
161 .. &amp;&amp;
162ninja</userinput></screen>
163
164 <para>
165 To test the results, you need to remove the
166 <parameter>-Dtests=false</parameter> switch, and to have <xref
167 linkend="mutter"/> compiled and installed with tests also.
168
169 To run the tests, issue: <command>ninja test</command>. You must be
170 running an X session to run the tests. Some will fail if <xref
171 linkend="gdm"/> is not installed. <phrase revision="sysv">Several
172 more tests may fail in the Sysv environment.</phrase>
173 <!-- "Failed to read monitors config file
174 '/home/xry111/.config/monitors.xml': Logical monitors not
175 adjacent"
176 The same thing happens in mutter but it's worked around with
177 HOME="". We cannot use HOME="" here or more tests will fail.
178 We also cannot tell the users to remove monitors.xml because
179 doing so will purge their monitor settings. Maybe we can
180 use bwrap to run the test with an empty tmpfs mounted on $HOME
181 in a separate namespace, but it's too overkill IMO.
182 DO NOT REMOVE unless you've tested with a "complex multi-monitor
183 configuration" (with mixed scaling settings and "strange"
184 positions of monitors). -->
185 One test named <filename>CSS styling support</filename> is known to
186 fail with some multi-monitor configurations.
187 </para>
188
189 <para>
190 Now, as the <systemitem class="username">root</systemitem> user:
191 </para>
192
193<screen role="root"><userinput>ninja install</userinput></screen>
194
195 </sect2>
196
197 <sect2 role="commands">
198 <title>Command Explanations</title>
199
200 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
201 href="../../xincludes/meson-buildtype-release.xml"/>
202
203<!--
204 <para revision="sysv">
205 <command>patch ...</command>: This patch fixes a bug when trying to
206 start an xwayland application on non systemd.
207 </para>
208-->
209
210 <para revision="sysv">
211 <parameter>-Dsystemd=false</parameter>: Prevents installing systemd
212 files, which are not needed in this version of BLFS.
213 </para>
214
215 <para>
216 <parameter>-Dtests=false</parameter>: Remove this switch if you want
217 to build the tests. But then <command>meson</command> will fail if
218 <xref linkend="mutter"/> tests are not installed.
219 </para>
220
221 <para>
222 <option>-Dextensions_tool=false</option>: This switch allows building
223 this package without <xref linkend='gnome-autoar'/> installed.
224 </para>
225
226 </sect2>
227
228 <sect2 role="content">
229 <title>Contents</title>
230
231 <segmentedlist>
232 <segtitle>Installed Programs</segtitle>
233 <segtitle>Installed Libraries</segtitle>
234 <segtitle>Installed Directories</segtitle>
235
236 <seglistitem>
237 <seg>
238 gnome-extensions, gnome-extensions-app, gnome-shell,
239 gnome-shell-extension-prefs, gnome-shell-extension-tool,
240 and gnome-shell-test-tool
241 </seg>
242 <seg>
243 None
244 </seg>
245 <seg>
246 /usr/lib/gnome-shell,
247 /usr/share/gnome-shell,
248 /usr/share/gtk-doc/html/{shell,st} (optional), and
249 /usr/share/xdg-desktop-portal/
250 </seg>
251 </seglistitem>
252 </segmentedlist>
253
254 <variablelist>
255 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
256 <?dbfo list-presentation="list"?>
257 <?dbhtml list-presentation="table"?>
258
259 <varlistentry id="gnome-shell-prog">
260 <term><command>gnome-shell</command></term>
261 <listitem>
262 <para>
263 provides the core user interface functions for the
264 <application>GNOME</application> Desktop
265 </para>
266 <indexterm zone="gnome-shell gnome-shell-prog">
267 <primary sortas="b-gnome-shell">gnome-shell</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 </variablelist>
273
274 </sect2>
275
276</sect1>
Note: See TracBrowser for help on using the repository browser.