source: gnome/platform/gnome-shell.xml@ 9789629b

10.0 10.1 11.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 9789629b was 9789629b, checked in by Pierre Labastie <pieere@…>, 2 years ago

Asciidoc is recommended for gnome-shell

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

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