source: x/lib/colord-gtk.xml@ 8ebc8b4

12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since 8ebc8b4 was 9d0d597f, checked in by Bruce Dubbs <bdubbs@…>, 10 months ago

Tag most of Chapter 25.
  • Property mode set to 100644
File size: 7.9 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 colord-gtk-download-http "https://www.freedesktop.org/software/colord/releases/colord-gtk-&colord-gtk-version;.tar.xz">
8 <!ENTITY colord-gtk-download-ftp " ">
9 <!ENTITY colord-gtk-md5sum "08c245d6482b3923a2b6a09f7fbbe612">
10 <!ENTITY colord-gtk-size "24 KB">
11 <!ENTITY colord-gtk-buildsize "6.1 MB">
12 <!ENTITY colord-gtk-time "less than 0.1 SBU">
13]>
14
15<sect1 id="colord-gtk" xreflabel="colord-gtk-&colord-gtk-version;">
16 <?dbhtml filename="colord-gtk.html"?>
17
18
19 <title>colord-gtk-&colord-gtk-version;</title>
20
21 <indexterm zone="colord-gtk">
22 <primary sortas="a-colord-gtk">colord-gtk</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to Colord GTK</title>
27
28 <para>
29 The <application>Colord GTK</application> package contains
30 <application>GTK+</application> bindings for
31 <application>Colord</application>.
32 </para>
33
34 &lfs120_checked;
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>
40 Download (HTTP): <ulink url="&colord-gtk-download-http;"/>
41 </para>
42 </listitem>
43 <listitem>
44 <para>
45 Download (FTP): <ulink url="&colord-gtk-download-ftp;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download MD5 sum: &colord-gtk-md5sum;
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download size: &colord-gtk-size;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Estimated disk space required: &colord-gtk-buildsize;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated build time: &colord-gtk-time;
66 </para>
67 </listitem>
68 </itemizedlist>
69
70 <bridgehead renderas="sect3">Colord GTK Dependencies</bridgehead>
71
72 <bridgehead renderas="sect4">Required</bridgehead>
73 <para role="required">
74 <xref linkend="colord"/> and
75 <xref linkend="gtk3"/>
76 </para>
77
78 <bridgehead renderas="sect4">Recommended</bridgehead>
79 <para role="recommended">
80 <xref linkend="gobject-introspection"/>,
81 <xref linkend="gtk2"/>,
82 <xref linkend="gtk4"/>, and
83 <xref linkend="vala"/>
84 </para>
85
86 <bridgehead renderas="sect4">Optional</bridgehead>
87 <para role="optional">
88 <xref linkend="docbook-utils"/> and
89 <xref linkend="gtk-doc"/>
90 </para>
91
92 </sect2>
93
94 <sect2 role="installation">
95 <title>Installation of Colord GTK</title>
96
97 <warning>
98 <para>
99 If building the documentation <command>ninja -j1</command> must be used.
100 </para>
101 </warning>
102
103 <para>
104 Install <application>Colord GTK</application> by running the following
105 commands:
106 </para>
107
108<screen><userinput>mkdir build &amp;&amp;
109cd build &amp;&amp;
110
111meson setup --prefix=/usr \
112 --buildtype=release \
113 -Dgtk2=true \
114 -Dgtk4=true \
115 -Dvapi=true \
116 -Ddocs=false \
117 -Dman=false \
118 .. &amp;&amp;
119ninja</userinput></screen>
120
121 <para>
122 To test the results, issue: <command>ninja test</command>.
123 The tests need to be run from an X session, and may require
124 a color profile for your primary display.
125 <!-- on an ASUS 32" IPS display, I have a color profile and it works
126 properly. On the other hand, with a Dell SP2208WFP LCD,
127 no color profile is available and the tests fail. It seems to
128 depend on the system/display. -->
129 </para>
130
131 <para>
132 Now, as the <systemitem class="username">root</systemitem> user:
133 </para>
134
135<screen role="root"><userinput>ninja install</userinput></screen>
136 </sect2>
137
138 <sect2 role="commands">
139 <title>Command Explanations</title>
140
141 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
142 href="../../xincludes/meson-buildtype-release.xml"/>
143
144 <para>
145 <parameter>-Dvapi=true</parameter>: This switch enables
146 building of the Vala bindings. Remove this switch if you don't
147 have <xref linkend="vala" role="nodep"/> installed.
148 </para>
149
150 <para>
151 <parameter>-Dgtk2=true</parameter>: This switch enables building
152 the GTK+-2 bindings for colord.
153 </para>
154
155 <para>
156 <parameter>-Dgtk4=true</parameter>: This switch enables building
157 the GTK-4 bindings for colord. Set this option to 'false' if you
158 do not have <xref linkend="gtk4" role="nodep"/> installed.
159 </para>
160
161 <para>
162 <parameter>-Ddocs=false</parameter>: This switch disables building
163 gtk-doc based documentation. Even if gtk-doc is installed, you will
164 need the namespaced versions of the Docbook XSL stylesheets.
165 </para>
166
167 <para>
168 <parameter>-Dman=false</parameter>: This switch disables generating
169 the manual pages for this package. Remove this switch if you have
170 namespaced versions of the Docbook XSL stylesheets installed.
171 </para>
172
173 <!--
174 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
175 href="../../xincludes/static-libraries.xml"/>
176
177 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
178 href="../../xincludes/gtk-doc-rebuild.xml"/>
179 -->
180 </sect2>
181
182 <sect2 role="content">
183 <title>Contents</title>
184
185 <segmentedlist>
186 <segtitle>Installed Programs</segtitle>
187 <segtitle>Installed Libraries</segtitle>
188 <segtitle>Installed Directories</segtitle>
189
190 <seglistitem>
191 <seg>
192 cd-convert
193 </seg>
194 <seg>
195 libcolord-gtk.so,
196 libcolord-gtk2.so, and
197 libcolord-gtk4.so
198 </seg>
199 <seg>
200 /usr/include/colord-1/colord-gtk and
201 /usr/share/gtk-doc/html/colord-gtk
202 </seg>
203 </seglistitem>
204 </segmentedlist>
205
206 <variablelist>
207 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
208 <?dbfo list-presentation="list"?>
209 <?dbhtml list-presentation="table"?>
210
211 <varlistentry id="cd-convert">
212 <term><command>cd-convert</command></term>
213 <listitem>
214 <para>
215 is a Color Manager Testing Tool
216 </para>
217 <indexterm zone="colord-gtk cd-convert">
218 <primary sortas="b-cd-convert">cd-convert</primary>
219 </indexterm>
220 </listitem>
221 </varlistentry>
222
223 <varlistentry id="libcolord-gtk">
224 <term><filename class="libraryfile">libcolord-gtk.so</filename></term>
225 <listitem>
226 <para>
227 contains the <application>Colord</application>
228 <application>GTK+</application> bindings
229 </para>
230 <indexterm zone="colord-gtk libcolord-gtk">
231 <primary sortas="c-libcolord-gtk">libcolord-gtk.so</primary>
232 </indexterm>
233 </listitem>
234 </varlistentry>
235
236 <varlistentry id="libcolord-gtk2">
237 <term><filename class="libraryfile">libcolord-gtk2.so</filename></term>
238 <listitem>
239 <para>
240 contains the <application>Colord</application>
241 <application>GTK+-2</application> bindings
242 </para>
243 <indexterm zone="colord-gtk libcolord-gtk2">
244 <primary sortas="c-libcolord-gtk2">libcolord-gtk2.so</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="libcolord-gtk4">
250 <term><filename class="libraryfile">libcolord-gtk4.so</filename></term>
251 <listitem>
252 <para>
253 contains the <application>Colord</application>
254 <application>GTK-4</application> bindings
255 </para>
256 <indexterm zone="colord-gtk libcolord-gtk4">
257 <primary sortas="c-libcolord-gtk4">libcolord-gtk4.so</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261 </variablelist>
262
263 </sect2>
264
265</sect1>
Note: See TracBrowser for help on using the repository browser.