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

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f37e8f37 was f37e8f37, checked in by Douglas R. Reno <renodr@…>, 20 months ago

Fix a gnome-shell regression that can cause crashes with some extensions enabled.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23057 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.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-minor-36;/gnome-shell-&gnome-shell-version;.tar.xz">
9 <!ENTITY gnome-shell-download-ftp
10 "&gnome-download-ftp;/gnome-shell/&gnome-minor-36;/gnome-shell-&gnome-shell-version;.tar.xz">
11 <!ENTITY gnome-shell-md5sum "f0cd44e573a82531b4556afa624b1193">
12 <!ENTITY gnome-shell-size "1.7 MB">
13 <!ENTITY gnome-shell-buildsize "72 MB">
14 <!ENTITY gnome-shell-time "0.2 SBU (Using parallelism=4)">
15]>
16
17<sect1 id="gnome-shell" xreflabel="gnome-shell-&gnome-shell-version;">
18 <?dbhtml filename="gnome-shell.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>gnome-shell-&gnome-shell-version;</title>
26
27 <indexterm zone="gnome-shell">
28 <primary sortas="a-gnome-shell">gnome-shell</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to GNOME Shell</title>
33
34 <para>
35 The <application>GNOME Shell</application> is the core user interface of
36 the <application>GNOME</application> Desktop environment.
37 </para>
38
39 &lfs91_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&gnome-shell-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&gnome-shell-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &gnome-shell-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &gnome-shell-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &gnome-shell-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &gnome-shell-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">GNOME Shell Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Required</bridgehead>
78 <para role="required">
79 <xref linkend="evolution-data-server"/>,
80 <xref linkend="gjs"/>,
81 <xref linkend="gnome-autoar"/>,
82 <xref linkend="gnome-control-center"/>,
83 <xref linkend="mutter"/>,
84 <xref linkend="sassc"/>,
85 <xref linkend="startup-notification"/>, and
86 <phrase revision="sysv"><xref linkend="elogind"/></phrase>
87 <phrase revision="systemd"><xref linkend="systemd"/></phrase>
88 </para>
89
90 <bridgehead renderas="sect4">Recommended</bridgehead>
91 <para role="recommended">
92 <xref linkend="asciidoc"/>,
93 <xref linkend="desktop-file-utils"/>,
94 <xref linkend="gnome-bluetooth"/>,
95 <xref linkend="gst10-plugins-base"/>, and
96 <xref linkend="NetworkManager"/>
97 </para>
98
99 <bridgehead renderas="sect4"
100 revision="sysv">Recommended (Runtime)</bridgehead>
101 <para role="recommended" revision="sysv">
102 <xref linkend="blocaled" role="runtime"/>
103 </para>
104
105 <bridgehead renderas="sect4">Optional</bridgehead>
106 <para role="optional">
107 <xref linkend="gtk-doc"/> and
108 <ulink url="https://github.com/scop/bash-completion">bash-completion</ulink>
109 </para>
110
111 <bridgehead renderas="sect4">Runtime Dependencies</bridgehead>
112 <para role="required">
113 <xref role="runtime" linkend="adwaita-icon-theme"/>,
114 <xref role="runtime" linkend="dconf"/>,
115 <xref role="runtime" linkend="gdm"/>,
116 <xref role="runtime" linkend="gnome-backgrounds"/>,
117 <xref role="runtime" linkend="gnome-menus"/>, and
118 <xref role="runtime" linkend="telepathy-mission-control"/>
119 </para>
120
121 <para condition="html" role="usernotes">User Notes:
122 <ulink url="&blfs-wiki;/gnome-shell"/>
123 </para>
124 </sect2>
125
126 <sect2 role="installation">
127 <title>Installation of GNOME Shell</title>
128
129 <para>
130 First, cause a regression that can cause a crash when locking
131 the screen with some extensions:
132 </para>
133
134<screen><userinput remap="pre">sed -i '290 d' src/st/st-theme.c &amp;&amp;
135sed -i '290a cr_stylesheet_unref (stylesheet);' src/st/st-theme.c</userinput></screen>
136
137 <!-- See https://gitlab.gnome.org/GNOME/gnome-shell/-/merge_requests/1230/diffs
138 https://gitlab.gnome.org/GNOME/gnome-shell/-/issues/2709 and
139 http://lists.linuxfromscratch.org/pipermail/blfs-dev/2020-May/037397.html
140 for rationale for this change. -->
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 --prefix=/usr -Dsystemd=false .. &amp;&amp;
151ninja</userinput></screen>
152
153<screen revision="systemd"><userinput>mkdir build &amp;&amp;
154cd build &amp;&amp;
155
156meson --prefix=/usr .. &amp;&amp;
157ninja</userinput></screen>
158
159 <para>
160 To test the results, issue: <command>ninja test</command>. You must be
161 running an X session to run the tests. Some will fail if
162 <xref linkend="gdm"/> is not installed.
163 </para>
164
165 <para>
166 Now, as the <systemitem class="username">root</systemitem> user:
167 </para>
168
169<screen role="root"><userinput>ninja install</userinput></screen>
170
171 </sect2>
172
173 <sect2 role="commands">
174 <title>Command Explanations</title>
175
176 <para revision="sysv">
177 <parameter>-Dsystemd=false</parameter>: Prevents installing systemd
178 files, which are not needed in this version of BLFS.
179 </para>
180
181 <para>
182 <option>-Dextensions=false</option>: Do not build the
183 <command>gnome-extensions</command> CLI tool. Using this option removes
184 the need for <xref linkend="asciidoc"/>.
185 </para>
186
187 </sect2>
188
189 <sect2 role="content">
190 <title>Contents</title>
191
192 <segmentedlist>
193 <segtitle>Installed Programs</segtitle>
194 <segtitle>Installed Libraries</segtitle>
195 <segtitle>Installed Directories</segtitle>
196
197 <seglistitem>
198 <seg>
199 gnome-extensions, gnome-shell, gnome-shell-extension-prefs,
200 gnome-shell-extension-tool, and gnome-shell-perf-tool
201 </seg>
202 <seg>
203 None
204 </seg>
205 <seg>
206 /usr/lib/gnome-shell,
207 /usr/share/gnome-shell,
208 /usr/share/gtk-doc/html/{shell,st}, and
209 /usr/share/xdg-desktop-portal/
210 </seg>
211 </seglistitem>
212 </segmentedlist>
213
214 <variablelist>
215 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
216 <?dbfo list-presentation="list"?>
217 <?dbhtml list-presentation="table"?>
218
219 <varlistentry id="gnome-shell-prog">
220 <term><command>gnome-shell</command></term>
221 <listitem>
222 <para>
223 provides the core user interface functions for the
224 <application>GNOME</application> 3 Desktop.
225 </para>
226 <indexterm zone="gnome-shell gnome-shell-prog">
227 <primary sortas="b-gnome-shell">gnome-shell</primary>
228 </indexterm>
229 </listitem>
230 </varlistentry>
231
232 </variablelist>
233
234 </sect2>
235
236</sect1>
Note: See TracBrowser for help on using the repository browser.