source: gnome/applications/gucharmap.xml@ 86200e7

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since 86200e7 was 86200e7, checked in by Pierre Labastie <pierre.labastie@…>, 3 months ago

gucharmap: UCD and Unihan are in the third parent dir

  • Property mode set to 100644
File size: 8.1 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 <!-- found by looking at souce of https://gitlab.gnome.org/GNOME/gucharmap/-/tags
8 in seamonkey, finding the .tar.bz2 and putting the gitlab.gnome.org prefix
9 onto it -->
10 <!ENTITY gucharmap-download-http "https://gitlab.gnome.org/GNOME/gucharmap/-/archive/&gucharmap-version;/gucharmap-&gucharmap-version;.tar.bz2">
11 <!ENTITY gucharmap-download-ftp " ">
12 <!ENTITY gucharmap-md5sum "5dbe3a3f6d063f819f82f15d6613a7a4">
13 <!ENTITY gucharmap-size "1.3 MB">
14 <!ENTITY gucharmap-buildsize "77 MB">
15 <!ENTITY gucharmap-time "0.1 SBU">
16]>
17
18<sect1 id="gucharmap" xreflabel="Gucharmap-&gucharmap-version;">
19 <?dbhtml filename="gucharmap.html"?>
20
21 <sect1info>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>Gucharmap-&gucharmap-version;</title>
26
27 <indexterm zone="gucharmap">
28 <primary sortas="a-Gucharmap">Gucharmap</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to Gucharmap</title>
33
34 <para>
35 <application>Gucharmap</application> is a Unicode character map and
36 font viewer. It allows you to browse through all the available Unicode
37 characters and categories for the installed fonts, and to examine their
38 detailed properties. It is an easy way to find the character you might
39 only know by its Unicode name or code point.
40 </para>
41
42 &lfs101_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>
48 Download (HTTP): <ulink url="&gucharmap-download-http;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download (FTP): <ulink url="&gucharmap-download-ftp;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download MD5 sum: &gucharmap-md5sum;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download size: &gucharmap-size;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated disk space required: &gucharmap-buildsize;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated build time: &gucharmap-time;
74 </para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
79
80 <bridgehead renderas="sect4">Unicode Character Database files</bridgehead>
81 <itemizedlist spacing="compact">
82 <listitem>
83 <para>
84 Download: <ulink url="https://www.unicode.org/Public/zipped/&gucharmap-major-version;.0/UCD.zip"> https://www.unicode.org/Public/zipped/&gucharmap-major-version;.0/UCD.zip</ulink>
85 (Unicode Character Database)
86 </para>
87 </listitem>
88 <listitem>
89 <para>
90 Download: <ulink url="https://www.unicode.org/Public/zipped/&gucharmap-major-version;.0/Unihan.zip"> https://www.unicode.org/Public/zipped/&gucharmap-major-version;.0/Unihan.zip</ulink>
91 (CJK Unified Ideographs)
92 </para>
93 </listitem>
94 </itemizedlist>
95
96 <bridgehead renderas="sect3">Gucharmap Dependencies</bridgehead>
97
98 <bridgehead renderas="sect4">Required</bridgehead>
99 <para role="required">
100 <xref linkend="desktop-file-utils"/>,
101 <xref linkend="gsettings-desktop-schemas"/>,
102 <xref linkend="gtk3"/>,
103 <xref linkend="itstool"/>, and
104 <xref linkend="unzip"/>
105 </para>
106
107 <bridgehead renderas="sect4">Recommended</bridgehead>
108 <para role="recommended">
109 <xref linkend="gobject-introspection"/> and
110 <xref linkend="vala"/>
111 </para>
112
113 <bridgehead renderas="sect4">Optional</bridgehead>
114 <para role="optional">
115<!-- <phrase revision="systemd"><xref linkend="appstream-glib"/> and </phrase> -->
116 <ulink url="&appstream-glib-url;">appstream-glib</ulink> and
117 <xref linkend="gtk-doc"/>
118 </para>
119
120 <para condition="html" role="usernotes">User Notes:
121 <ulink url="&blfs-wiki;/gucharmap"/>
122 </para>
123 </sect2>
124
125 <sect2 role="installation">
126 <title>Installation of Gucharmap</title>
127
128 <para>
129 Install <application>Gucharmap</application> by running the following
130 commands:
131 </para>
132
133<screen><userinput>mkdir build &amp;&amp;
134cd build &amp;&amp;
135mkdir ucd &amp;&amp;
136pushd ucd &amp;&amp;
137unzip ../../../UCD.zip &amp;&amp;
138cp -v ../../../Unihan.zip . &amp;&amp;
139popd &amp;&amp;
140meson --prefix=/usr \
141 --strip \
142 -Ducd_path=./ucd \
143 -Ddocs=false .. &amp;&amp;
144ninja</userinput></screen>
145
146 <para>
147 This package does not have a testsuite.
148 </para>
149
150 <para>
151 Now, as the <systemitem class="username">root</systemitem> user:
152 </para>
153
154<screen role="root"><userinput>rm -fv /usr/share/glib-2.0/schemas/org.gnome.Charmap.enums.xml &amp;&amp;
155ninja install</userinput></screen>
156
157 </sect2>
158
159 <sect2 role="commands">
160 <title>Command Explanations</title>
161
162 <!-- 13.0.8, meson 58 series - file reports 'with debug_info, not stripped'.
163 The build still used -O3 and claimed to not be a debug version -->
164 <para>
165 <parameter>--strip</parameter>: Although the package defaults to a release
166 build without debug information, without this switch there will be some
167 debug information in the binaries.
168 </para>
169
170 <para>
171 <parameter>-Ducd_path=./ucd</parameter>: This points to where the extracted
172 main Unicode data files, and the zipped Unihan archive can be found.
173 </para>
174
175 <para>
176 <command>rm -fv /usr/share/glib-2.0/schemas/org.gnome.Charmap.enums.xml</command>:
177 Old versions of this package installed an obsolete file that prevents the
178 program from running, as if the main schema has not been installed.
179 Forcibly removing works even if the old file is not present.
180 </para>
181
182 <para>
183 <parameter>-Ddocs=false</parameter>: This allows the package to build even
184 if <application>gtk-doc</application> has not been installed. Remove this
185 if you have installed that and wish to build the documentation.
186 </para>
187
188 <para>
189 <option>-Dgir=false</option>: Use this if you have not installed
190 <xref linkend="gobject-introspection"/>.
191 </para>
192
193 <para>
194 <option>-Dvapi=false</option>: Use this if you have not installed
195 <xref linkend="vala"/>.
196 </para>
197
198 </sect2>
199
200 <sect2 role="content">
201 <title>Contents</title>
202
203 <segmentedlist>
204 <segtitle>Installed Program</segtitle>
205 <segtitle>Installed Library</segtitle>
206 <segtitle>Installed Directories</segtitle>
207
208 <seglistitem>
209 <seg>
210 <!-- these appear to no-longer get created
211 charmap, gnome-character-map (both symlinks), and--> gucharmap
212 </seg>
213 <seg>
214 libgucharmap_2_90.so
215 </seg>
216 <seg>
217 /usr/include/gucharmap-2.90 and
218 /usr/share/help/*/gucharmap
219 </seg>
220 </seglistitem>
221 </segmentedlist>
222
223 <variablelist>
224 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
225 <?dbfo list-presentation="list"?>
226 <?dbhtml list-presentation="table"?>
227
228 <varlistentry id="gucharmap-prog">
229 <term><command>gucharmap</command></term>
230 <listitem>
231 <para>
232 is a Unicode character map and font viewer
233 </para>
234 <indexterm zone="gucharmap gucharmap-prog">
235 <primary sortas="b-gucharmap">gucharmap</primary>
236 </indexterm>
237 </listitem>
238 </varlistentry>
239
240 <varlistentry id="libgucharmap_2_90">
241 <term><filename class="libraryfile">libgucharmap_2_90.so</filename></term>
242 <listitem>
243 <para>
244 contains the <application>Gucharmap</application> API functions
245 </para>
246 <indexterm zone="gucharmap libgucharmap_2_90">
247 <primary sortas="c-libgucharmap_2_90">libgucharmap_2_90.so</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251
252 </variablelist>
253
254 </sect2>
255
256</sect1>
Note: See TracBrowser for help on using the repository browser.