source: gnome/applications/gucharmap.xml@ b9fc02a

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since b9fc02a was b9fc02a, checked in by Bruce Dubbs <bdubbs@…>, 3 months ago

Finish adding --buildtype=release
Most meson based packages should be built with --buildtype=release.
There are a lot of these packages in BLFS. Not all meson based
packages need this. For example gnome-backgrounds only installs
data and mutteer needs --buildtype=debugoptimized for tests.

This commit finishes all of BLFS.

  • Property mode set to 100644
File size: 8.2 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 "68 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;
137 unzip ../../../UCD.zip &amp;&amp;
138 cp -v ../../../Unihan.zip . &amp;&amp;
139popd &amp;&amp;
140
141meson --prefix=/usr \
142 --strip \
143 --buildtype=release \
144 -Ducd_path=./ucd \
145 -Ddocs=false .. &amp;&amp;
146ninja</userinput></screen>
147
148 <para>
149 This package does not have a testsuite.
150 </para>
151
152 <para>
153 Now, as the <systemitem class="username">root</systemitem> user:
154 </para>
155
156<screen role="root"><userinput>rm -fv /usr/share/glib-2.0/schemas/org.gnome.Charmap.enums.xml &amp;&amp;
157ninja install</userinput></screen>
158
159 </sect2>
160
161 <sect2 role="commands">
162 <title>Command Explanations</title>
163
164 <!-- 13.0.8, meson 58 series - file reports 'with debug_info, not stripped'.
165 The build still used -O3 and claimed to not be a debug version -->
166 <para>
167 <parameter>--strip</parameter>: Although the package defaults to a release
168 build without debug information, without this switch there will be some
169 debug information in the binaries.
170 </para>
171
172 <para>
173 <parameter>-Ducd_path=./ucd</parameter>: This points to where the extracted
174 main Unicode data files, and the zipped Unihan archive can be found.
175 </para>
176
177 <para>
178 <command>rm -fv /usr/share/glib-2.0/schemas/org.gnome.Charmap.enums.xml</command>:
179 Old versions of this package installed an obsolete file that prevents the
180 program from running, as if the main schema has not been installed.
181 Forcibly removing works even if the old file is not present.
182 </para>
183
184 <para>
185 <parameter>-Ddocs=false</parameter>: This allows the package to build even
186 if <application>gtk-doc</application> has not been installed. Remove this
187 if you have installed that and wish to build the documentation.
188 </para>
189
190 <para>
191 <option>-Dgir=false</option>: Use this if you have not installed
192 <xref linkend="gobject-introspection"/>.
193 </para>
194
195 <para>
196 <option>-Dvapi=false</option>: Use this if you have not installed
197 <xref linkend="vala"/>.
198 </para>
199
200 </sect2>
201
202 <sect2 role="content">
203 <title>Contents</title>
204
205 <segmentedlist>
206 <segtitle>Installed Program</segtitle>
207 <segtitle>Installed Library</segtitle>
208 <segtitle>Installed Directories</segtitle>
209
210 <seglistitem>
211 <seg>
212 <!-- these appear to no-longer get created
213 charmap, gnome-character-map (both symlinks), and--> gucharmap
214 </seg>
215 <seg>
216 libgucharmap_2_90.so
217 </seg>
218 <seg>
219 /usr/include/gucharmap-2.90 and
220 /usr/share/help/*/gucharmap
221 </seg>
222 </seglistitem>
223 </segmentedlist>
224
225 <variablelist>
226 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
227 <?dbfo list-presentation="list"?>
228 <?dbhtml list-presentation="table"?>
229
230 <varlistentry id="gucharmap-prog">
231 <term><command>gucharmap</command></term>
232 <listitem>
233 <para>
234 is a Unicode character map and font viewer
235 </para>
236 <indexterm zone="gucharmap gucharmap-prog">
237 <primary sortas="b-gucharmap">gucharmap</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="libgucharmap_2_90">
243 <term><filename class="libraryfile">libgucharmap_2_90.so</filename></term>
244 <listitem>
245 <para>
246 contains the <application>Gucharmap</application> API functions
247 </para>
248 <indexterm zone="gucharmap libgucharmap_2_90">
249 <primary sortas="c-libgucharmap_2_90">libgucharmap_2_90.so</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 </variablelist>
255
256 </sect2>
257
258</sect1>
Note: See TracBrowser for help on using the repository browser.