source: gnome/platform/gcr.xml@ 65d85668

11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 65d85668 was 65d85668, checked in by Bruce Dubbs <bdubbs@…>, 18 months ago

9ckage updates and fixes.
Update to php-8.0.9.
Update to cbindgen-0.20.0.
Fix dependencies for elogind and p11kit.
Fix gcr-3.40.0 to build properly with meson-0.59.

  • 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 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 &lfs101_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="libxslt"/>, and
89 <xref linkend="vala"/>
90 </para>
91
92 <bridgehead renderas="sect4">Optional</bridgehead>
93 <para role="optional">
94 <xref linkend="gtk-doc"/> and
95 <xref linkend="valgrind"/>
96 </para>
97
98 <para condition="html" role="usernotes">
99 User Notes: <ulink url="&blfs-wiki;/gcr"/>
100 </para>
101 </sect2>
102
103 <sect2 role="installation">
104 <title>Installation of Gcr</title>
105
106 <!--
107 <caution>
108 <para>
109 If you are upgrading from a version of gcr prior to 3.36.0, you must
110 run the <filename>remove-la-files.sh</filename> script from the
111 <xref linkend="la-files"/> after installing gcr.
112 </para>
113 </caution>
114 -->
115
116 <para>
117 Install <application>Gcr</application> by running the following
118 commands:
119 </para>
120
121<screen><userinput>sed -i 's:"/desktop:"/org:' schema/*.xml &amp;&amp;
122
123sed -e '208 s/@BASENAME@/gcr-viewer.desktop/' \
124 -e '231 s/@BASENAME@/gcr-prompter.desktop/' \
125 -i ui/meson.build &amp;&amp;
126
127mkdir build &amp;&amp;
128cd build &amp;&amp;
129
130meson --prefix=/usr --buildtype=release -Dgtk_doc=false .. &amp;&amp;
131ninja</userinput></screen>
132
133 <para>
134 To test the results, issue: <command>ninja test</command>.
135 The tests must be run from an X Terminal or similar. <!-- One test,
136 "test-openssl 3", is known to fail. -->
137 </para>
138
139 <para>
140 Now, as the <systemitem class="username">root</systemitem> user:
141 </para>
142
143<screen role="root"><userinput>ninja install</userinput></screen>
144 </sect2>
145
146 <sect2 role="commands">
147 <title>Command Explanations</title>
148
149 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
150 href="../../xincludes/meson-buildtype-release.xml"/>
151
152 <para>
153 <command>sed ... schema/*.xml</command>: This command fixes a
154 deprecated entry in the schema template.
155 </para>
156
157 <para>
158 <command>sed ... ui/meson.build</command>: This command fixes a
159 problem when building with meson-0.59.0.
160 </para>
161
162 <!--
163 <para>
164 <!- - https://gitlab.gnome.org/GNOME/gcr/-/merge_requests/52/ - ->
165 <command>sed ... gck/gck-slot.c</command>: This command fixes a bug
166 (usage of uninitialized value) identified by upstream.
167 </para>
168 -->
169
170 <para>
171 <option>-Dgtk=false</option>: Use this switch if you
172 haven't installed <xref linkend="gtk3"/>. Note that
173 <application>gcr-viewer</application> will not be installed
174 if this is passed to meson.
175 </para>
176
177 <para>
178 <option>-Dgtk_doc=true</option>: Use this switch if you wish
179 to generate the API reference documentation. Note that you must
180 have <application>GTK-Doc</application> installed.
181 </para>
182
183 <!--<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
184 href="../../xincludes/gtk-doc-rebuild.xml"/>-->
185
186 </sect2>
187
188 <sect2 role="content">
189 <title>Contents</title>
190
191 <segmentedlist>
192 <segtitle>Installed Program</segtitle>
193 <segtitle>Installed Libraries</segtitle>
194 <segtitle>Installed Directories</segtitle>
195
196 <seglistitem>
197 <seg>
198 gcr-viewer
199 </seg>
200 <seg>
201 libgck-1.so, libgcr-base-3.so and libgcr-ui-3.so
202 </seg>
203 <seg>
204 /usr/include/gck-1,
205 /usr/include/gcr-3, and
206 /usr/share/gtk-doc/html/{gcr,gck}
207 </seg>
208 </seglistitem>
209 </segmentedlist>
210
211 <variablelist>
212 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
213 <?dbfo list-presentation="list"?>
214 <?dbhtml list-presentation="table"?>
215
216 <varlistentry id="gcr-viewer">
217 <term><command>gcr-viewer</command></term>
218 <listitem>
219 <para>
220 is used to view certificates and key files
221 </para>
222 <indexterm zone="gcr gcr-viewer">
223 <primary sortas="b-gcr-viewer">gcr-viewer</primary>
224 </indexterm>
225 </listitem>
226 </varlistentry>
227
228 <varlistentry id="libgck-1">
229 <term><filename class="libraryfile">libgck-1.so</filename></term>
230 <listitem>
231 <para>
232 contains GObject bindings for PKCS#11
233 </para>
234 <indexterm zone="gcr libgck-1">
235 <primary sortas="c-libgck-1">libgck-1.so</primary>
236 </indexterm>
237 </listitem>
238 </varlistentry>
239
240 </variablelist>
241
242 </sect2>
243
244</sect1>
Note: See TracBrowser for help on using the repository browser.