source: gnome/platform/gcr.xml@ bee8bad

11.1 lazarus trunk xry111/intltool xry111/test-20220226
Last change on this file since bee8bad was bee8bad, checked in by Douglas R. Reno <renodr@…>, 6 months ago

GCR: Add recommended dependency on libsecret per report in IRC

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