source: xsoft/other/gimp.xml@ e1f9f2a

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules 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 e1f9f2a was e1f9f2a, checked in by Ken Moffat <ken@…>, 6 years ago

A newer git pull of gimp-help. Small updates in the English text, a lot of updates in the Catalan and Italian translations.

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