source: xsoft/other/gimp.xml@ 622c1021

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 622c1021 was 622c1021, checked in by Pierre Labastie <pieere@…>, 4 years ago

Format xsoft chapter

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22857 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 19.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 <!ENTITY gimp-download-http "https://download.gimp.org/pub/gimp/v2.10/gimp-&gimp-version;.tar.bz2">
8 <!ENTITY gimp-download-ftp " ">
9 <!ENTITY gimp-md5sum "096d04ffb2c4559cb2152f507ff31c9c">
10 <!ENTITY gimp-size "32 MB">
11 <!ENTITY gimp-buildsize "931 MB (206 MB installed, add 975 MB for tests)">
12 <!ENTITY gimp-time "2.1 SBU (Using parallelism=4; add 0.6 SBU for tests)">
13
14 <!-- pro-tem, a pull of gimp-help, https://gitlab.gnome.org/GNOME/gimp-help.git
15 git archive - -format=tar - -prefix=${DIRNAME}/ HEAD | xz >../${DIRNAME}.tar.xz -->
16 <!ENTITY gimp-help-version "2019-04-08">
17 <!ENTITY gimp-help-download "&sources-anduin-http;/gimp/gimp-help-&gimp-help-version;.tar.xz">
18 <!ENTITY gimp-help-md5sum "e334ebe7fd5e12350e6319c2e8c39141">
19 <!ENTITY gimp-help-size "166 MB">
20 <!ENTITY gimp-help-buildsize "From 310 MB (en only) to 1.6 GB (all 18
21 languages)">
22 <!ENTITY gimp-help-time "0.8 SBU (en only), 13 SBU, with parallelism=4,
23 for all languages">
24]>
25<!--
26 <!ENTITY gimp-help-version "2.8.2">
27 <!ENTITY gimp-help-download "https://download.gimp.org/pub/gimp/help/gimp-help-&gimp-help-version;.tar.bz2">
28 <!ENTITY gimp-help-md5sum "a591c8974b2f4f584d0a769d52ed6c5b">
29 <!ENTITY gimp-help-size "152 MB">
30 <!ENTITY gimp-help-buildsize "From 307 MB (en only) to 1257 MB (all 18
31 languages), average of 52 MB per translation">
32 <!ENTITY gimp-help-time "0.8 SBU (en only), average of 1.2 SBU per
33 translation (measured with 5 languages), 5.9
34 SBU, with parallelism=8, for all languages">
35-->
36
37<sect1 id="gimp" xreflabel="Gimp-&gimp-version;">
38 <?dbhtml filename="gimp.html" ?>
39
40 <sect1info>
41 <othername>$LastChangedBy$</othername>
42 <date>$Date$</date>
43 </sect1info>
44
45 <title>Gimp-&gimp-version;</title>
46
47 <indexterm zone="gimp">
48 <primary sortas="a-Gimp">Gimp</primary>
49 </indexterm>
50
51 <sect2 role="package">
52 <title>Introduction to Gimp</title>
53
54 <para>
55 The <application>Gimp</application> package contains
56 the GNU Image Manipulation Program which is useful for
57 photo retouching, image composition and image authoring.
58 </para>
59
60 &lfs91_checked;
61
62 <bridgehead renderas="sect3">Package Information</bridgehead>
63 <itemizedlist spacing="compact">
64 <listitem>
65 <para>
66 Download (HTTP): <ulink url="&gimp-download-http;"/>
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Download (FTP): <ulink url="&gimp-download-ftp;"/>
72 </para>
73 </listitem>
74 <listitem>
75 <para>
76 Download MD5 sum: &gimp-md5sum;
77 </para>
78 </listitem>
79 <listitem>
80 <para>
81 Download size: &gimp-size;
82 </para>
83 </listitem>
84 <listitem>
85 <para>
86 Estimated disk space required: &gimp-buildsize;
87 </para>
88 </listitem>
89 <listitem>
90 <para>
91 Estimated build time: &gimp-time;
92 </para>
93 </listitem>
94 </itemizedlist>
95
96 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
97<!--
98 <note>
99 <para>
100 The creation of local html files with recent versions of the necessary
101 packages is somewhat broken (some png images are not sourced by the
102 generated HTML, only their captions are visible).
103 </para>
104 </note>
105-->
106 <note>
107 <para>
108 The updating of the help files is still a work in progress, with large
109 parts of the text for many languages not yet translated. The file below
110 is a git snapshot.
111 </para>
112 </note>
113
114 <itemizedlist spacing="compact">
115 <listitem>
116 <para>
117 Download (HTTP): <ulink url="&gimp-help-download;"/>
118 </para>
119 </listitem>
120 <listitem>
121 <para>
122 Download size: &gimp-help-size;
123 </para>
124 </listitem>
125 <listitem>
126 <para>
127 Download md5sum: &gimp-help-md5sum;
128 </para>
129 </listitem>
130 <listitem>
131 <para>
132 Estimated disk space required: &gimp-help-buildsize;
133 </para>
134 </listitem>
135 <listitem>
136 <para>
137 Estimated build time: &gimp-help-time;
138 </para>
139 </listitem>
140 </itemizedlist>
141
142 <bridgehead renderas="sect3">Gimp Dependencies</bridgehead>
143
144 <bridgehead renderas="sect4">Required</bridgehead>
145 <para role="required">
146 <xref linkend="gegl"/>,
147 <xref linkend="gexiv2"/>,
148 <xref linkend="glib-networking"/>,
149 <xref linkend="gtk2"/>,
150 <xref linkend="harfbuzz"/>.
151 <xref linkend="libjpeg"/>,
152 <xref linkend="libmypaint"/>,
153 <xref linkend="librsvg"/>,
154 <xref linkend="libtiff"/>,
155 <!-- en can be built without this -->
156 <xref linkend="libxml2py2"/> (to build the translated help files),
157 <xref linkend="lcms2"/>,
158 <xref linkend="mypaint-brushes"/>,
159 <xref linkend="poppler"/> (including poppler-data) and
160 <!-- some parts of Xorg appear to be required, as are deps it pulls in -->
161 <xref linkend="x-window-system"/>
162 </para>
163
164 <bridgehead renderas="sect4">Recommended</bridgehead>
165 <para role="recommended">
166 <xref linkend="dbus-glib"/>,
167 <xref linkend="gs"/> (with libgs installed),
168 <xref linkend="gvfs"/> (to access the online help),
169 <xref linkend="iso-codes"/>,
170 <xref linkend="libgudev"/>,
171 <xref linkend="pygtk"/> (including the gtk, pango and pangocairo modules) and
172 <xref linkend="xdg-utils"/>
173 </para>
174
175 <bridgehead renderas="sect4">Optional</bridgehead>
176 <para role="optional">
177 <xref linkend="aalib"/>,
178 <xref linkend="alsa-lib"/>,
179 <xref linkend="libmng"/>,
180 <xref linkend="libwebp"/>,
181 <xref linkend="openjpeg2"/>,
182 an <xref linkend="server-mail"/> (that provides a
183 <command>sendmail</command> program),
184 <xref linkend="gtk-doc"/>,
185 <ulink url="https://people.freedesktop.org/~hughsient/appstream-glib">appstream-glib</ulink> and
186 <ulink url="http://wvware.sourceforge.net/libwmf.html">libwmf</ulink>
187 </para>
188
189 <para>
190 When you have run configure, you will see that WebKit is not found -
191 that dependency is for the legacy webkit-1.0 which should never be used
192 on a modern system exposed to the internet.
193 </para>
194
195 <bridgehead renderas="sect4">Optional, for building the help system</bridgehead>
196 <para role="optional">
197 <ulink url="http://dblatex.sourceforge.net/">dblatex</ulink> (for PDF docs),
198 <ulink url="http://pngnq.sourceforge.net/">pngnq</ulink> and
199 <ulink url="http://pmt.sourceforge.net/pngcrush/">pngcrush</ulink>
200 to optimize the png files, but see the note on the help download above
201 </para>
202
203 <para condition="html" role="usernotes">User Notes:
204 <ulink url="&blfs-wiki;/gimp"/>
205 </para>
206 </sect2>
207
208 <sect2 role="installation">
209 <title>Installation of Gimp</title>
210
211 <para>
212 Install <application>Gimp</application> by running
213 the following commands:
214 </para>
215
216<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
217make</userinput></screen>
218
219 <para>
220 To test the results (requires an X-Windowed terminal) issue:
221 <command>make check</command>.
222 <!-- Six tests are known to fail.
223 All appear to be related to the same problem in the test suite.-->
224 <!-- km: in 2.10.16 no failures, 2 tests were skipped -->
225 </para>
226
227 <para>
228 Now, as the <systemitem class="username">root</systemitem>
229 user:
230 </para>
231
232<screen role="root"><userinput>make install</userinput></screen>
233
234 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
235 href="../../xincludes/update-icons-and-desktop.xml"/>
236
237 </sect2>
238
239 <sect2 role="installation">
240 <title>Installation of Gimp-Help</title>
241
242 <para>
243 The <filename>gimp-help</filename> tarball contains images and English
244 text help for help files, together with translations. Because of the
245 issues mentioned in the note above, you are recommended to use the online
246 help, either by building against <xref linkend="gvfs"/> so that 'help'
247 can open the latest XML files in your browser, or else you can manually
248 open the html in your browser by going to <ulink
249 url="https://docs.gimp.org/2.10/en/">https://docs.gimp.org/2.10/en</ulink>
250 (change the language code if desired).
251 </para>
252
253 <para>
254 If you nevertheless wish to install local copies of the help files to read
255 offline, unpack the <filename>gimp-help</filename> tarball
256 and change into the root of the newly created source tree. Prepare for
257 the build with the following command:
258 </para>
259
260<screen><userinput>ALL_LINGUAS=&quot;ca da de el en en_GB es fi fr it ja ko nl nn pt_BR ro ru zh_CN&quot; \
261./autogen.sh --prefix=/usr</userinput></screen>
262
263 <para>
264 Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
265 you do not wish to install. Alternatively, remove the line starting with
266 <envar>ALL_LINGUAS</envar>, if you wish to build all languages.
267 </para>
268
269 <para>
270 Now build the help files:
271 </para>
272
273<screen><userinput>make</userinput></screen>
274
275 <para>
276 Issue the following commands as the
277 <systemitem class="username">root</systemitem> user to install the help
278 files:
279 </para>
280
281<screen role="root"><userinput>make install &amp;&amp;
282chown -R root:root /usr/share/gimp/2.0/help</userinput></screen>
283
284 </sect2>
285
286 <sect2 role="commands" id="gimp-cmd-explanations">
287 <title>Command Explanations</title>
288
289 <para>
290 <envar>ALL_LINGUAS=&quot;ca da de el en en_GB ...&quot;</envar>: by
291 default, the help files will be rendered in all the available languages.
292 Remove the codes of any languages you do not wish to build.
293 </para>
294
295 <para>
296 <option>--disable-python</option>: This option is necessary if
297 you have not installed <application>PyGTK</application>.
298 </para>
299
300 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
301 href="../../xincludes/gtk-doc-rebuild.xml"/>
302
303 </sect2>
304
305 <sect2 role="configuration">
306 <title>Configuring The Gimp</title>
307
308 <sect3 id="gimp-config">
309 <title>Config Files</title>
310
311 <para>
312 <filename>/etc/gimp/2.0/*</filename> and
313 <filename>~/.gimp-2.8/gimprc</filename>
314 </para>
315
316 <indexterm zone="gimp gimp-config">
317 <primary sortas="e-AA.gimp-2.0/gimprc">~/.g/GIMP/2.10/*</primary>
318 </indexterm>
319
320 <indexterm zone="gimp gimp-config">
321 <primary sortas="e-etc-gimp-2.0-star">/etc/gimp/2.0/*</primary>
322 </indexterm>
323
324 </sect3>
325
326 </sect2>
327
328 <sect2 role="content">
329 <title>Contents</title>
330
331 <segmentedlist>
332 <segtitle>Installed Programs</segtitle>
333 <segtitle>Installed Libraries</segtitle>
334 <segtitle>Installed Directories</segtitle>
335
336 <seglistitem>
337 <seg>
338 gimp (symlink), gimp-2.10,
339 gimp-console (symlink), gimp-console-2.10,
340 gimp-test-clipboard-2.0, and
341 gimptool-2.0
342 </seg>
343 <seg>
344 libgimp-2.0.so, libgimpbase-2.0.so, libgimpcolor-2.0.so,
345 libgimpconfig-2.0.so, libgimpmath-2.0.so, libgimpmodule-2.0.so,
346 libgimpthumb-2.0.so, libgimpui-2.0.so, and libgimpwidgets-2.0.so
347 </seg>
348 <seg>
349 /etc/gimp,
350 /usr/include/gimp-2.0,
351 /usr/{lib,share}/gimp,
352 /usr/share/gimp/2.0,
353 /usr/share/gtk-doc/html/libgimp{,base,color,config}, and
354 /usr/share/gtk-doc/html/libgimp{math,module,thumb,widgets}
355 </seg>
356 </seglistitem>
357 </segmentedlist>
358
359 <variablelist>
360 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
361 <?dbfo list-presentation="list"?>
362 <?dbhtml list-presentation="table"?>
363
364 <varlistentry id="gimp-prog">
365 <term><command>gimp</command></term>
366 <listitem>
367 <para>
368 is a symbolic link to <command>gimp-2.10</command>.
369 </para>
370 <indexterm zone="gimp gimp-prog">
371 <primary sortas="b-gimp">gimp</primary>
372 </indexterm>
373 </listitem>
374 </varlistentry>
375
376 <varlistentry id="gimp-2.10">
377 <term><command>gimp-2.10</command></term>
378 <listitem>
379 <para>
380 is the Gnu Image Manipulation Program. It works with a variety
381 of image formats and provides a large selection of tools.
382 </para>
383 <indexterm zone="gimp gimp-2.10">
384 <primary sortas="b-gimp-2.10">gimp-2.10</primary>
385 </indexterm>
386 </listitem>
387 </varlistentry>
388
389 <varlistentry id="gimp-console">
390 <term><command>gimp-console</command></term>
391 <listitem>
392 <para>
393 is a symbolic link to <command>gimp-console-2.10</command>.
394 </para>
395 <indexterm zone="gimp gimp-console">
396 <primary sortas="b-gimp-console">gimp-console</primary>
397 </indexterm>
398 </listitem>
399 </varlistentry>
400
401 <varlistentry id="gimp-console-2.10">
402 <term><command>gimp-console-2.10</command></term>
403 <listitem>
404 <para>
405 is a console program that behaves as if The
406 <application>Gimp</application> was called with the
407 <option>--no-interface</option> command-line option.
408 </para>
409 <indexterm zone="gimp gimp-console-2.10">
410 <primary sortas="b-gimp-console-2.10">gimp-console-2.10</primary>
411 </indexterm>
412 </listitem>
413 </varlistentry>
414
415 <varlistentry id="gimptool-2.0">
416 <term><command>gimptool-2.0</command></term>
417 <listitem>
418 <para>
419 is a tool that can build plug-ins or scripts and install them
420 if they are distributed in one source file.
421 <command>gimptool-2.0</command> can also be used by programs that
422 need to know what libraries and include-paths The
423 <application>Gimp</application> was compiled with.
424 </para>
425 <indexterm zone="gimp gimptool-2.0">
426 <primary sortas="b-gimptool-2.0">gimptool-2.0</primary>
427 </indexterm>
428 </listitem>
429 </varlistentry>
430
431 <varlistentry id="libgimp-2.0">
432 <term><filename class="libraryfile">libgimp-2.0.so</filename></term>
433 <listitem>
434 <para>
435 provides C bindings for The <application>Gimp</application>'s
436 Procedural Database (PDB) which offers an interface to core functions
437 and to functionality provided by plug-ins.
438 </para>
439 <indexterm zone="gimp libgimp-2.0">
440 <primary sortas="c-libgimp-2.0">libgimp-2.0.so</primary>
441 </indexterm>
442 </listitem>
443 </varlistentry>
444
445 <varlistentry id="libgimpbase-2.0">
446 <term><filename class="libraryfile">libgimpbase-2.0.so</filename></term>
447 <listitem>
448 <para>
449 provides the C functions for basic
450 <application>Gimp</application> functionality such as determining
451 enumeration data types, gettext translation, determining The
452 <application>Gimp</application>'s version number and capabilities,
453 handling data files and accessing the environment.
454 </para>
455 <indexterm zone="gimp libgimpbase-2.0">
456 <primary sortas="c-libgimpbase-2.0">libgimpbase-2.0.so</primary>
457 </indexterm>
458 </listitem>
459 </varlistentry>
460
461 <varlistentry id="libgimpcolor-2.0">
462 <term><filename
463 class="libraryfile">libgimpcolor-2.0.so</filename></term>
464 <listitem>
465 <para>
466 provides the C functions relating to RGB, HSV and CMYK colors as
467 well as converting colors between different color models and
468 performing adaptive supersampling on an area.
469 </para>
470 <indexterm zone="gimp libgimpcolor-2.0">
471 <primary sortas="c-libgimpcolor-2.0">libgimpcolor-2.0.so</primary>
472 </indexterm>
473 </listitem>
474 </varlistentry>
475
476 <varlistentry id="libgimpconfig-2.0">
477 <term><filename
478 class="libraryfile">libgimpconfig-2.0.so</filename></term>
479 <listitem>
480 <para>
481 contains C functions for reading and writing config information.
482 </para>
483 <indexterm zone="gimp libgimpconfig-2.0">
484 <primary sortas="c-libgimpconfig-2.0">libgimpconfig-2.0.so</primary>
485 </indexterm>
486 </listitem>
487 </varlistentry>
488
489 <varlistentry id="libgimpmath-2.0">
490 <term><filename class="libraryfile">libgimpmath-2.0.so</filename></term>
491 <listitem>
492 <para>
493 contains C functions which provide mathematical definitions and
494 macros, manipulate 3x3 transformation matrices, set up and manipulate
495 vectors and the MD5 message-digest algorithm.
496 </para>
497 <indexterm zone="gimp libgimpmath-2.0">
498 <primary sortas="c-libgimpmath-2.0">libgimpmath-2.0.so</primary>
499 </indexterm>
500 </listitem>
501 </varlistentry>
502
503 <varlistentry id="libgimpmodule-2.0">
504 <term><filename class="libraryfile">libgimpmodule-2.0.so</filename></term>
505 <listitem>
506 <para>
507 provides the C functions which implements module loading using
508 GModule and keeps a list of GimpModule's found in a given
509 searchpath.
510 </para>
511 <indexterm zone="gimp libgimpmodule-2.0">
512 <primary sortas="c-libgimpmodule-2.0">libgimpmodule-2.0.so</primary>
513 </indexterm>
514 </listitem>
515 </varlistentry>
516
517 <varlistentry id="libgimpthumb-2.0">
518 <term><filename class="libraryfile">libgimpthumb-2.0.so</filename></term>
519 <listitem>
520 <para>
521 provides the C functions for handling The
522 <application>Gimp</application>'s thumbnail objects.
523 </para>
524 <indexterm zone="gimp libgimpthumb-2.0">
525 <primary sortas="c-libgimpthumb-2.0">libgimpthumb-2.0.so</primary>
526 </indexterm>
527 </listitem>
528 </varlistentry>
529
530 <varlistentry id="libgimpui-2.0">
531 <term><filename class="libraryfile">libgimpui-2.0.so</filename></term>
532 <listitem>
533 <para>
534 contains The <application>Gimp</application>'s common user
535 interface functions.
536 </para>
537 <indexterm zone="gimp libgimpui-2.0">
538 <primary sortas="c-libgimpui-2.0">libgimpui-2.0.so</primary>
539 </indexterm>
540 </listitem>
541 </varlistentry>
542
543 <varlistentry id="libgimpwidgets-2.0">
544 <term><filename class="libraryfile">libgimpwidgets-2.0.so</filename></term>
545 <listitem>
546 <para>
547 contains The <application>Gimp</application>
548 and <application>GTK</application>'s widget creation and
549 manipulation functions.
550 </para>
551 <indexterm zone="gimp libgimpwidgets-2.0">
552 <primary
553 sortas="c-libgimpwidgets-2.0">libgimpwidgets-2.0.so</primary>
554 </indexterm>
555 </listitem>
556 </varlistentry>
557
558 </variablelist>
559
560 </sect2>
561
562</sect1>
Note: See TracBrowser for help on using the repository browser.