source: gnome/platform/gnome-desktop.xml@ 36e756b

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

Update to twm-1.0.11
Update to gnome-desktop-3.36.3.1
qt5: Fix a link to a dependency
giflib: Remove an unnecessary comment that was causing an extra (extremely noticable) space in the installation instructions.

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

  • Property mode set to 100644
File size: 6.3 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-desktop-download-http
8 "&gnome-download-http;/gnome-desktop/&gnome-minor-36;/gnome-desktop-&gnome-desktop-version;.tar.xz">
9 <!ENTITY gnome-desktop-download-ftp
10 "&gnome-download-ftp;/gnome-desktop/&gnome-minor-36;/gnome-desktop-&gnome-desktop-version;.tar.xz">
11 <!ENTITY gnome-desktop-md5sum "75e828342e51c88c866dcdd46c021d26">
12 <!ENTITY gnome-desktop-size "724 KB">
13 <!ENTITY gnome-desktop-buildsize "20 MB (with tests)">
14 <!ENTITY gnome-desktop-time "0.2 SBU (Using parallelism=4; with tests)">
15]>
16
17<sect1 id="gnome-desktop" xreflabel="gnome-desktop-&gnome-desktop-version;">
18 <?dbhtml filename="gnome-desktop.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>gnome-desktop-&gnome-desktop-version;</title>
26
27 <indexterm zone="gnome-desktop">
28 <primary sortas="a-gnome-desktop">gnome-desktop</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to GNOME Desktop</title>
33
34 <para>
35 The <application>GNOME Desktop</application> package contains a library
36 that provides an API shared by several applications on the
37 <application>GNOME</application> Desktop.
38 </para>
39
40 &lfs91_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&gnome-desktop-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&gnome-desktop-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &gnome-desktop-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &gnome-desktop-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &gnome-desktop-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &gnome-desktop-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">GNOME Desktop Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="gsettings-desktop-schemas"/>,
81 <xref linkend="gtk3"/>,
82 <xref linkend="iso-codes"/>,
83 <xref linkend="itstool"/>,
84 <xref linkend="libseccomp"/>,
85 <xref linkend="libxml2"/>, and
86 <xref linkend="xkeyboard-config"/>
87 </para>
88
89 <bridgehead renderas="sect4">Recommended</bridgehead>
90 <para role="recommended">
91 <xref linkend="bubblewrap"/> (needed for thumbnailers in Nautilus) and
92 <xref linkend="gobject-introspection"/>
93 </para>
94
95 <bridgehead renderas="sect4">Optional</bridgehead>
96 <para role="optional">
97 <xref linkend="gtk-doc"/>
98 </para>
99
100 <para condition="html" role="usernotes">User Notes:
101 <ulink url="&blfs-wiki;/gnome-desktop"/>
102 </para>
103 </sect2>
104
105 <sect2 role="installation">
106 <title>Installation of GNOME Desktop</title>
107
108 <para>
109 Install <application>GNOME Desktop</application> by
110 running the following commands:
111 </para>
112
113<screen><userinput>mkdir build &amp;&amp;
114cd build &amp;&amp;
115
116meson --prefix=/usr \
117 -Dgnome_distributor="BLFS" .. &amp;&amp;
118ninja</userinput></screen>
119
120 <!-- Previously, there was a note here on SysV about the Wall Clock tests
121 failing. Since we symlinked the timezones, it works okay now. -->
122 <para>
123 To test the results, run <command>ninja test</command> from a X Terminal
124 or similar. One test, <filename>wallclock-reftest</filename>, is known to
125 fail due to a difference in expecations in the he_IL.UTF-8 locale.
126 </para>
127 <!-- This failure is known upstream and seems to be due to a translation
128 update for the Hebrew translation. See
129 https://gitlab.gnome.org/GNOME/gnome-desktop/-/issues/149 and
130 https://gitlab.gnome.org/GNOME/gnome-desktop/-/merge_requests/70/
131 For some reason, I cannot replicate this on my gcc-10 system.-->
132
133 <para>
134 Now, as the <systemitem class="username">root</systemitem> user:
135 </para>
136
137<screen role="root"><userinput>ninja install</userinput></screen>
138
139 </sect2>
140
141 <sect2 role="commands">
142 <title>Command Explanations</title>
143
144 <para>
145 <option>-Dgnome_distributor="Some Name"</option>: Use this
146 parameter to supply a custom name in the <quote>Distributor:</quote>
147 field of the <quote>GNOME About</quote> display window.
148 </para>
149
150 <para>
151 <option>-Dgtk_doc=true</option>: Use this
152 parameter if you wish to build the API documentation.
153 </para>
154
155 <para>
156 <option>-Dinstalled_tests=true</option>: Use this
157 parameter you wish to enable the installed tests.
158 </para>
159
160 </sect2>
161
162 <sect2 role="content">
163 <title>Contents</title>
164
165 <segmentedlist>
166 <segtitle>Installed Programs</segtitle>
167 <segtitle>Installed Library</segtitle>
168 <segtitle>Installed Directories</segtitle>
169
170 <seglistitem>
171 <seg>
172 None
173 </seg>
174 <seg>
175 libgnome-desktop-3.so
176 </seg>
177 <seg>
178 /usr/include/gnome-desktop-3.0,
179 /usr/share/gnome,
180 /usr/share/gtk-doc/html/gnome-desktop3, and
181 /usr/share/help/*/{fdl,gpl,lgpl}
182 </seg>
183 </seglistitem>
184 </segmentedlist>
185
186 <variablelist>
187 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
188 <?dbfo list-presentation="list"?>
189 <?dbhtml list-presentation="table"?>
190
191 <varlistentry id="libgnome-desktop-3">
192 <term><filename class="libraryfile">libgnome-desktop-3.so</filename></term>
193 <listitem>
194 <para>
195 contains functions shared by several <application>GNOME</application>
196 applications.
197 </para>
198 <indexterm zone="gnome-desktop libgnome-desktop-3">
199 <primary sortas="c-libgnome-desktop-3">libgnome-desktop-3.so</primary>
200 </indexterm>
201 </listitem>
202 </varlistentry>
203
204 </variablelist>
205
206 </sect2>
207
208</sect1>
Note: See TracBrowser for help on using the repository browser.