source: gnome/platform/gcr.xml@ 8f16a204

11.1 lazarus trunk xry111/intltool xry111/test-20220226
Last change on this file since 8f16a204 was 8f16a204, checked in by Pierre Labastie <pierre.labastie@…>, 5 months ago

Fixes gcr and dconf-editor for building with meson 0.61

  • Property mode set to 100644
File size: 7.0 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 gcr-download-http "&gnome-download-http;/gcr/&gnome-minor-40;/gcr-&gcr-version;.tar.xz">
8 <!ENTITY gcr-download-ftp "&gnome-download-ftp;/gcr/&gnome-minor-40;/gcr-&gcr-version;.tar.xz">
9 <!ENTITY gcr-md5sum "fa34048b5562f80587a71d11931a7c29">
10 <!ENTITY gcr-size "998 KB">
11 <!ENTITY gcr-buildsize "39 MB (with tests)">
12 <!ENTITY gcr-time "0.4 SBU (with tests)">
13]>
14
15<sect1 id="gcr" xreflabel="Gcr-&gcr-version;">
16 <?dbhtml filename="gcr.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>Gcr-&gcr-version;</title>
23
24 <indexterm zone="gcr">
25 <primary sortas="a-Gcr">Gcr</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to Gcr</title>
30
31 <para>
32 The <application>Gcr</application> package contains libraries used
33 for displaying certificates and accessing key stores. It also
34 provides the viewer for crypto files on the
35 <application>GNOME</application> Desktop.
36 </para>
37
38 &lfs110a_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&gcr-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&gcr-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &gcr-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &gcr-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &gcr-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &gcr-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">Gcr Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="glib2"/>,
79 <xref linkend="libgcrypt"/>, and
80 <xref linkend="p11-kit"/>
81 </para>
82
83 <bridgehead renderas="sect4">Recommended</bridgehead>
84 <para role="recommended">
85 <xref linkend="gnupg2"/>,
86 <xref linkend="gobject-introspection"/>,
87 <xref linkend="gtk3"/>,
88 <xref linkend="libsecret"/>,
89 <xref linkend="libxslt"/>, and
90 <xref linkend="vala"/>
91 </para>
92
93 <bridgehead renderas="sect4">Optional</bridgehead>
94 <para role="optional">
95 <xref linkend="gtk-doc"/> and
96 <xref linkend="valgrind"/>
97 </para>
98
99 <para condition="html" role="usernotes">
100 User Notes: <ulink url="&blfs-wiki;/gcr"/>
101 </para>
102 </sect2>
103
104 <sect2 role="installation">
105 <title>Installation of Gcr</title>
106
107 <!--
108 <caution>
109 <para>
110 If you are upgrading from a version of gcr prior to 3.36.0, you must
111 run the <filename>remove-la-files.sh</filename> script from the
112 <xref linkend="la-files"/> after installing gcr.
113 </para>
114 </caution>
115 -->
116
117 <para>
118 First apply a fix for building with newer versions of
119 <application>meson</application>:
120 </para>
121
122<screen><userinput>find . -name meson.build | xargs sed -i /packages.\*deps/d</userinput></screen>
123
124 <para>
125 Install <application>Gcr</application> by running the following
126 commands:
127 </para>
128
129<screen><userinput>sed -i 's:"/desktop:"/org:' schema/*.xml &amp;&amp;
130
131sed -e '208 s/@BASENAME@/gcr-viewer.desktop/' \
132 -e '231 s/@BASENAME@/gcr-prompter.desktop/' \
133 -i ui/meson.build &amp;&amp;
134
135mkdir build &amp;&amp;
136cd build &amp;&amp;
137
138meson --prefix=/usr --buildtype=release -Dgtk_doc=false .. &amp;&amp;
139ninja</userinput></screen>
140
141 <para>
142 To test the results, issue: <command>ninja test</command>.
143 The tests must be run from an X Terminal or similar. <!-- One test,
144 "test-openssl 3", is known to fail. -->
145 </para>
146
147 <para>
148 Now, as the <systemitem class="username">root</systemitem> user:
149 </para>
150
151<screen role="root"><userinput>ninja install</userinput></screen>
152 </sect2>
153
154 <sect2 role="commands">
155 <title>Command Explanations</title>
156
157 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
158 href="../../xincludes/meson-buildtype-release.xml"/>
159
160 <para>
161 <command>sed ... schema/*.xml</command>: This command fixes a
162 deprecated entry in the schema template.
163 </para>
164
165 <para>
166 <command>sed ... ui/meson.build</command>: This command fixes a
167 problem when building with meson-0.59.0.
168 </para>
169
170 <!--
171 <para>
172 <!- - https://gitlab.gnome.org/GNOME/gcr/-/merge_requests/52/ - ->
173 <command>sed ... gck/gck-slot.c</command>: This command fixes a bug
174 (usage of uninitialized value) identified by upstream.
175 </para>
176 -->
177
178 <para>
179 <option>-Dgtk=false</option>: Use this switch if you
180 haven't installed <xref linkend="gtk3"/>. Note that
181 <application>gcr-viewer</application> will not be installed
182 if this is passed to meson.
183 </para>
184
185 <para>
186 <option>-Dgtk_doc=true</option>: Use this switch if you wish
187 to generate the API reference documentation. Note that you must
188 have <application>GTK-Doc</application> installed.
189 </para>
190
191 <!--<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
192 href="../../xincludes/gtk-doc-rebuild.xml"/>-->
193
194 </sect2>
195
196 <sect2 role="content">
197 <title>Contents</title>
198
199 <segmentedlist>
200 <segtitle>Installed Program</segtitle>
201 <segtitle>Installed Libraries</segtitle>
202 <segtitle>Installed Directories</segtitle>
203
204 <seglistitem>
205 <seg>
206 gcr-viewer
207 </seg>
208 <seg>
209 libgck-1.so, libgcr-base-3.so and libgcr-ui-3.so
210 </seg>
211 <seg>
212 /usr/include/gck-1,
213 /usr/include/gcr-3, and
214 /usr/share/gtk-doc/html/{gcr,gck}
215 </seg>
216 </seglistitem>
217 </segmentedlist>
218
219 <variablelist>
220 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
221 <?dbfo list-presentation="list"?>
222 <?dbhtml list-presentation="table"?>
223
224 <varlistentry id="gcr-viewer">
225 <term><command>gcr-viewer</command></term>
226 <listitem>
227 <para>
228 is used to view certificates and key files
229 </para>
230 <indexterm zone="gcr gcr-viewer">
231 <primary sortas="b-gcr-viewer">gcr-viewer</primary>
232 </indexterm>
233 </listitem>
234 </varlistentry>
235
236 <varlistentry id="libgck-1">
237 <term><filename class="libraryfile">libgck-1.so</filename></term>
238 <listitem>
239 <para>
240 contains GObject bindings for PKCS#11
241 </para>
242 <indexterm zone="gcr libgck-1">
243 <primary sortas="c-libgck-1">libgck-1.so</primary>
244 </indexterm>
245 </listitem>
246 </varlistentry>
247
248 </variablelist>
249
250 </sect2>
251
252</sect1>
Note: See TracBrowser for help on using the repository browser.