source: gnome/platform/gnome-shell.xml@ 078db5b

10.0 10.1 11.0 9.1 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 078db5b was 078db5b, checked in by Pierre Labastie <pieere@…>, 2 years ago

Add dependency on desktop-file-utils for packages which have a custom
meson command calling update-desktop-database at install time

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

  • Property mode set to 100644
File size: 6.9 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-34;/gnome-shell-&gnome-shell-version;.tar.xz">
9 <!ENTITY gnome-shell-download-ftp
10 "&gnome-download-ftp;/gnome-shell/&gnome-minor-34;/gnome-shell-&gnome-shell-version;.tar.xz">
11 <!ENTITY gnome-shell-md5sum "2e00c22673d069d6b919b2ca1b225d89">
12 <!ENTITY gnome-shell-size "1.5 MB">
13 <!ENTITY gnome-shell-buildsize "66 MB">
14 <!ENTITY gnome-shell-time "0.3 SBU">
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 &lfs90_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="libcroco"/>,
84 <xref linkend="mutter"/>,
85 <xref linkend="sassc"/>,
86 <xref linkend="startup-notification"/>, and
87 <phrase revision="sysv"><xref linkend="elogind"/></phrase>
88 <phrase revision="systemd"><xref linkend="systemd"/></phrase>
89 </para>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
93 <xref linkend="asciidoc"/>,
94 <xref linkend="desktop-file-utils"/>,
95 <xref linkend="gnome-bluetooth"/>,
96 <xref linkend="gst10-plugins-base"/>, and
97 <xref linkend="network-manager-applet"/>
98 </para>
99
100 <bridgehead renderas="sect4">Optional</bridgehead>
101 <para role="optional">
102 <xref linkend="gtk-doc"/> and
103 <ulink url="https://github.com/scop/bash-completion">bash-completion</ulink>
104 </para>
105
106 <bridgehead renderas="sect4">Runtime Dependencies</bridgehead>
107 <para role="required">
108 <xref role="runtime" linkend="adwaita-icon-theme"/>,
109 <xref role="runtime" linkend="dconf"/>,
110 <xref role="runtime" linkend="gdm"/>,
111 <xref role="runtime" linkend="gnome-backgrounds"/>,
112 <xref role="runtime" linkend="gnome-menus"/>,
113 <xref role="runtime" linkend="gnome-themes-extra"/>, and
114 <xref role="runtime" linkend="telepathy-mission-control"/>
115 </para>
116
117 <para condition="html" role="usernotes">User Notes:
118 <ulink url="&blfs-wiki;/gnome-shell"/>
119 </para>
120 </sect2>
121
122 <sect2 role="installation">
123 <title>Installation of GNOME Shell</title>
124
125 <para>
126 Install <application>GNOME Shell</application> by running the
127 following commands:
128 </para>
129
130<screen revision="sysv"><userinput>sed -i '/isGreeter/,+2 d' js/ui/status/keyboard.js &amp;&amp;
131
132mkdir build &amp;&amp;
133cd build &amp;&amp;
134
135meson --prefix=/usr -Dsystemd=false .. &amp;&amp;
136ninja</userinput></screen>
137
138<screen revision="systemd"><userinput>mkdir build &amp;&amp;
139cd build &amp;&amp;
140
141meson --prefix=/usr .. &amp;&amp;
142ninja</userinput></screen>
143
144 <para>
145 To test the results, issue: <command>ninja test</command>. You must be
146 running an X session to run the tests. Some will fail if
147 <xref linkend="gdm"/> is not installed.
148 </para>
149
150 <para>
151 Now, as the <systemitem class="username">root</systemitem> user:
152 </para>
153
154<screen role="root"><userinput>ninja install</userinput></screen>
155
156<!-- not needed with -Dsystemd=false
157 <para revision="sysv">
158 Finally, remove some systemd units that are unnecessary on SysV.
159 </para>
160
161<screen role="root" revision="sysv"><userinput>rm -v /usr/lib/systemd/user/gnome-shell*</userinput></screen>
162-->
163 </sect2>
164
165 <sect2 role="commands">
166 <title>Command Explanations</title>
167
168 <para revision="sysv">
169 <command>sed -i ...</command>: This command allows the GDM greeter to
170 use a keyboard layout taken from the dconf database instead of a default
171 US qwerty one.
172 </para>
173
174 <para>
175 <option>-Dextensions=false</option>: Do not build the
176 <command>gnome-extensions</command> CLI tool. Using this option removes
177 the need for <xref linkend="asciidoc"/>.
178 </para>
179
180 </sect2>
181
182 <sect2 role="content">
183 <title>Contents</title>
184
185 <segmentedlist>
186 <segtitle>Installed Programs</segtitle>
187 <segtitle>Installed Libraries</segtitle>
188 <segtitle>Installed Directories</segtitle>
189
190 <seglistitem>
191 <seg>
192 gnome-extensions, gnome-shell, gnome-shell-extension-prefs,
193 gnome-shell-extension-tool, and gnome-shell-perf-tool
194 </seg>
195 <seg>
196 None
197 </seg>
198 <seg>
199 /usr/lib/gnome-shell,
200 /usr/share/gnome-shell,
201 /usr/share/gtk-doc/html/{shell,st}, and
202 /usr/share/xdg-desktop-portal/
203 </seg>
204 </seglistitem>
205 </segmentedlist>
206
207 <variablelist>
208 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
209 <?dbfo list-presentation="list"?>
210 <?dbhtml list-presentation="table"?>
211
212 <varlistentry id="gnome-shell-prog">
213 <term><command>gnome-shell</command></term>
214 <listitem>
215 <para>
216 provides the core user interface functions for the
217 <application>GNOME</application> 3 Desktop.
218 </para>
219 <indexterm zone="gnome-shell gnome-shell-prog">
220 <primary sortas="b-gnome-shell">gnome-shell</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 </variablelist>
226
227 </sect2>
228
229</sect1>
Note: See TracBrowser for help on using the repository browser.