source: gnome/platform/gcr.xml@ 45ab6c7

trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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