source: xsoft/other/gimp.xml@ 99e4509

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym 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 99e4509 was 99e4509, checked in by Bruce Dubbs <bdubbs@…>, 9 years ago

Tags

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

  • Property mode set to 100644
File size: 19.8 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 "http://download.gimp.org/pub/gimp/v2.8/gimp-&gimp-version;.tar.bz2">
8 <!ENTITY gimp-download-ftp " ">
9<!-- <!ENTITY gimp-download-ftp "ftp://mirrors.xmission.com/gimp/gimp/v2.8/gimp-&gimp-version;.tar.bz2">-->
10 <!ENTITY gimp-md5sum "233c948203383fa078434cc3f8f925cb">
11 <!ENTITY gimp-size "20 MB">
12 <!ENTITY gimp-buildsize "642 MB (additional 553 MB to run the test suite,
13 the help files add from 307 MB (en only) to
14 reputedly 1.3 GB (all 18 languages), typically
15 increasing by 60 MB per translation)">
16 <!ENTITY gimp-time "4.2 SBU (additional 0.9 SBU to run the test
17 suite, and for the help files, from 0.6 SBU (en
18 only) to reputedly 19 SBU (all) - typically 1.3
19 SBU per translation)">
20
21 <!ENTITY gimp-help-version "2.8.2">
22 <!ENTITY gimp-help-download "http://download.gimp.org/pub/gimp/help/gimp-help-&gimp-help-version;.tar.bz2">
23 <!ENTITY gimp-help-md5sum "a591c8974b2f4f584d0a769d52ed6c5b">
24 <!ENTITY gimp-help-size "152 MB">
25]>
26
27<sect1 id="gimp" xreflabel="Gimp-&gimp-version;">
28 <?dbhtml filename="gimp.html" ?>
29
30 <sect1info>
31 <othername>$LastChangedBy$</othername>
32 <date>$Date$</date>
33 </sect1info>
34
35 <title>Gimp-&gimp-version;</title>
36
37 <indexterm zone="gimp">
38 <primary sortas="a-Gimp">Gimp</primary>
39 </indexterm>
40
41 <sect2 role="package">
42 <title>Introduction to Gimp</title>
43
44 <para>
45 The <application>Gimp</application> package contains
46 the GNU Image Manipulation Program which is useful for
47 photo retouching, image composition and image authoring.
48 </para>
49
50 &lfs77_checked;
51
52 <bridgehead renderas="sect3">Package Information</bridgehead>
53 <itemizedlist spacing="compact">
54 <listitem>
55 <para>
56 Download (HTTP): <ulink url="&gimp-download-http;"/>
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download (FTP): <ulink url="&gimp-download-ftp;"/>
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Download MD5 sum: &gimp-md5sum;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Download size: &gimp-size;
72 </para>
73 </listitem>
74 <listitem>
75 <para>
76 Estimated disk space required: &gimp-buildsize;
77 </para>
78 </listitem>
79 <listitem>
80 <para>
81 Estimated build time: &gimp-time;
82 </para>
83 </listitem>
84 </itemizedlist>
85
86 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
87 <itemizedlist spacing="compact">
88 <listitem>
89 <para>
90 Optional help files: <ulink url="&gimp-help-download;"/>
91 </para>
92 </listitem>
93 <listitem>
94 <para>
95 Download MD5 sum: &gimp-help-md5sum;
96 </para>
97 </listitem>
98 <listitem>
99 <para>
100 Download size: &gimp-help-size;
101 </para>
102 </listitem>
103 <listitem>
104 <para>
105 Optional patch:
106 <ulink url="&patch-root;/gimp-&gimp-version;-device_info-1.patch"/>
107 </para>
108 </listitem>
109<!-- <listitem>
110 <para>
111 Compressed Patch MD5 sum: 5312793a67132131a6e3360e76f392e4
112 </para>
113 </listitem>
114 <listitem>
115 <para>
116 Compressed Patch size: 486 KB
117 </para>
118 </listitem> -->
119 </itemizedlist>
120
121 <bridgehead renderas="sect3">Gimp Dependencies</bridgehead>
122
123 <bridgehead renderas="sect4">Required</bridgehead>
124 <para role="required">
125 <xref linkend="gegl"/> and
126 <xref linkend="gtk2"/>
127 </para>
128
129 <bridgehead renderas="sect4">Recommended</bridgehead>
130 <para role="recommended">
131 <xref linkend="pygtk"/> (including the gtk and pango modules)
132 </para>
133
134 <bridgehead renderas="sect4">Optional</bridgehead>
135 <para role="optional">
136 <xref linkend="aalib"/>,
137 <xref linkend="alsa-lib"/>,
138 <xref linkend="curl"/>,
139 <xref linkend="dbus-glib"/>,
140 <xref linkend="gs"/> (with libgs installed),
141 <xref linkend="gvfs"/>,
142 <xref linkend="iso-codes"/>,
143 <xref linkend="jasper"/>,
144 <xref linkend="lcms"/> or <xref linkend="lcms2"/>,
145 <xref linkend="libexif"/>,
146 <xref linkend="libmng"/>,
147 <xref linkend="librsvg"/>,
148 <ulink url="http://wvware.sourceforge.net/libwmf.html">libwmf</ulink>,
149 <xref linkend="poppler"/>,
150 an <xref linkend="server-mail"/> (that provides a
151 <command>sendmail</command> program),
152 <xref linkend="udev-extras"/> (for GUdev),
153 <xref linkend="webkitgtk2"/> (required for the help-plugin) and
154 <xref linkend="gtk-doc"/>
155 </para>
156
157 <bridgehead renderas="sect4">Optional, for optimizing the PNG files in the
158 help system</bridgehead>
159 <para role="optional">
160 <ulink url="http://pngnq.sourceforge.net/">pngnq</ulink> and
161 <ulink url="http://pmt.sourceforge.net/pngcrush/">pngcrush</ulink>
162 </para>
163
164 <para condition="html" role="usernotes">User Notes:
165 <ulink url="&blfs-wiki;/gimp"/>
166 </para>
167 </sect2>
168
169 <sect2 role="installation">
170 <title>Installation of Gimp</title>
171
172 <para>
173 In order to get rid of an annoying message when running from a terminal
174 and/or if you wish to run the test suite, optionally use the
175 following patch:
176 </para>
177
178<screen><userinput>patch -Np1 -i ../gimp-&gimp-version;-device_info-1.patch</userinput></screen>
179
180 <para>
181 Install <application>Gimp</application> by running
182 the following commands:
183 </para>
184
185<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc --without-gvfs &amp;&amp;
186make</userinput></screen>
187
188 <para>
189 To test the results (requires an X-Windowed terminal) issue:
190 <command>make check</command>.
191 </para>
192
193 <para>
194 Now, as the <systemitem class="username">root</systemitem>
195 user:
196 </para>
197
198<screen role="root"><userinput>make install</userinput></screen>
199
200 <para>
201 The <filename>gimp-help</filename> tarball contains images and English
202 text help for help files, together with translations. It is
203 &quot;work in progress&quot;.
204 </para>
205
206 <para>
207 If you downloaded the <filename>gimp-help</filename> tarball, unpack
208 it and change into the root of the newly created source tree. Prepare for
209 the build with the following command:
210 </para>
211
212<screen><userinput>ALL_LINGUAS=&quot;ca da de el en en_GB es fr it ja ko nl nn pt_BR ru sl sv zh_CN&quot; \
213./configure --prefix=/usr &amp;&amp;</userinput></screen>
214
215 <para>
216 Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
217 you do not wish to install. Alternatively, remove the line starting with
218 <envar>ALL_LINGUAS</envar>, if you wish to build all languages.
219 </para>
220
221<!-- <para>
222 Alternatively, if you wish to build languages including Catalan,
223 apply the patch:
224 </para>
225
226<screen role="nodump"><userinput>xzcat ../gimp-help-2.8.0-build_fixes-1.patch.xz \
227 | patch -p1 &amp;&amp;
228./autogen.sh -prefix=/usr &amp;&amp;</userinput></screen>
229
230 <para>
231 Again, you can specify a subset of languages by specifying
232 <envar>ALL_LINGUAS</envar> in front of <command>./autogen.sh</command>, but
233 this time including &quot;ca&quot;.
234 </para>
235 -->
236 <para>
237 Now build the help files:
238 </para>
239
240<screen><userinput>make</userinput></screen>
241
242 <para>
243 Issue the following commands as the
244 <systemitem class="username">root</systemitem> user to install the help
245 files:
246 </para>
247
248<screen role="root"><userinput>make install &amp;&amp;
249chown -R root:root /usr/share/gimp/2.0/help</userinput></screen>
250
251 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
252 href="../../xincludes/update-icons-and-desktop.xml"/>
253
254 </sect2>
255
256 <sect2 role="commands" id="gimp-cmd-explanations">
257 <title>Command Explanations</title>
258
259 <para>
260 <envar>ALL_LINGUAS=&quot;ca da de el en en_GB ...&quot;</envar>: by
261 default, the help files will be rendered in all the available languages.
262 Remove the codes of any languages you do not wish to build.
263 </para>
264
265 <para>
266 <parameter>--without-gvfs</parameter>: the choice of the backend to
267 handle URI information, e.g., when dragging images from a browser into the
268 <application>Gimp</application>, is made at compile time. This parameter will
269 ensure that <application>cURL</application> is used at run-time, instead of
270 <application>Gvfs</application>. You can omit this if you are installing
271 <application>Gvfs</application> AND will be running <command>gvfsd</command>,
272 e.g., in a <application>GNOME</application> desktop.
273 </para>
274
275 <para><option>--disable-python</option>: This option is necessary if
276 you have not installed <application>PyGTK</application>.</para>
277
278<!--<para>
279 <command>./autogen.sh</command> <parameter>-prefix=/usr</parameter>: In this case, using
280 <command>autoreconf</command> to regenerate <filename>configure</filename>
281 does not work, because of how the gimp-help developers chose to address
282 problems with the autotools.
283 </para>
284
285 <para>
286 <command>xzcat ../gimp-help-2.8.0-build_fixes-1.patch.xz</command>:
287 this patch is large, so it has been compressed with
288 <application>xz</application>. You are encouraged to be suspicious of
289 all patches until you have looked at them. Use <command>view</command>
290 to read the compressed patch before you apply it.
291 </para>
292-->
293 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
294 href="../../xincludes/gtk-doc-rebuild.xml"/>
295
296 </sect2>
297
298 <sect2 role="configuration">
299 <title>Configuring The Gimp</title>
300
301 <sect3 id="gimp-config">
302 <title>Config Files</title>
303
304 <para>
305 <filename>/etc/gimp/2.0/*</filename> and
306 <filename>~/.gimp-2.8/gimprc</filename>
307 </para>
308
309 <indexterm zone="gimp gimp-config">
310 <primary sortas="e-AA.gimp-2.0/gimprc">~/.gimp-2.0/gimprc</primary>
311 </indexterm>
312
313 <indexterm zone="gimp gimp-config">
314 <primary sortas="e-etc-gimp-2.0-star">/etc/gimp/2.0/*</primary>
315 </indexterm>
316
317 </sect3>
318
319 <sect3>
320 <title>Configuration Information</title>
321
322 <para>
323 The <application>Gimp</application> executes a configuration wizard
324 for each user upon their initial use of the program.
325 </para>
326
327 <para>
328 The <application>Gimp</application> executes the
329 <command>firefox</command> web browser by default to view the help
330 files. If you do not have <application>Firefox</application>, or
331 prefer a different web browser, you can set a new system value in
332 <filename>/etc/gimp/2.0/gimprc</filename>. Execute the following
333 command as the <systemitem class="username">root</systemitem> user,
334 replacing <replaceable>&lt;browser&gt;</replaceable> with your
335 preferred web browser:
336 </para>
337
338<screen role="root"><userinput>echo '(web-browser "<replaceable>&lt;browser&gt;</replaceable> %s")' &gt;&gt; /etc/gimp/2.0/gimprc</userinput></screen>
339
340 </sect3>
341
342 </sect2>
343
344 <sect2 role="content">
345 <title>Contents</title>
346
347 <segmentedlist>
348 <segtitle>Installed Programs</segtitle>
349 <segtitle>Installed Libraries</segtitle>
350 <segtitle>Installed Directories</segtitle>
351
352 <seglistitem>
353 <seg>
354 gimp, gimp-2.8, gimp-console, gimp-console-2.8 and
355 gimptool-2.0
356 </seg>
357 <seg>
358 libgimp-2.0.so, libgimpbase-2.0.so, libgimpcolor-2.0.so,
359 libgimpconfig-2.0.so, libgimpmath-2.0.so, libgimpmodule-2.0.so,
360 libgimpthumb-2.0.so, libgimpui-2.0.so and libgimpwidgets-2.0.so
361 </seg>
362 <seg>
363 /etc/gimp,
364 /usr/include/gimp-2.0,
365 /usr/lib/gimp,
366 /usr/share/gimp,
367 /usr/share/gimp/2.0/help/{en,lang2,lang3,...},
368 /usr/share/gtk-doc/html/{libgimp,libgimpbase,libgimpcolor},
369 /usr/share/gtk-doc/html/{libgimpconfig,libgimpmath},
370 /usr/share/gtk-doc/html/{libgimpmodule,libgimpthumb} and
371 /usr/share/gtk-doc/html/libgimpwidgets
372 </seg>
373 </seglistitem>
374 </segmentedlist>
375
376 <variablelist>
377 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
378 <?dbfo list-presentation="list"?>
379 <?dbhtml list-presentation="table"?>
380
381 <varlistentry id="gimp-prog">
382 <term><command>gimp</command></term>
383 <listitem>
384 <para>
385 is a symbolic link to <command>gimp-2.8</command>.
386 </para>
387 <indexterm zone="gimp gimp-prog">
388 <primary sortas="b-gimp">gimp</primary>
389 </indexterm>
390 </listitem>
391 </varlistentry>
392
393 <varlistentry id="gimp-2.8">
394 <term><command>gimp-2.8</command></term>
395 <listitem>
396 <para>
397 is the Gnu Image Manipulation Program. It works with a variety
398 of image formats and provides a large selection of tools.
399 </para>
400 <indexterm zone="gimp gimp-2.8">
401 <primary sortas="b-gimp-2.8">gimp-2.8</primary>
402 </indexterm>
403 </listitem>
404 </varlistentry>
405
406 <varlistentry id="gimp-console">
407 <term><command>gimp-console</command></term>
408 <listitem>
409 <para>
410 is a symbolic link to <command>gimp-console-2.8</command>.
411 </para>
412 <indexterm zone="gimp gimp-console">
413 <primary sortas="b-gimp-console">gimp-console</primary>
414 </indexterm>
415 </listitem>
416 </varlistentry>
417
418 <varlistentry id="gimp-console-2.8">
419 <term><command>gimp-console-2.8</command></term>
420 <listitem>
421 <para>
422 is a console program that behaves as if The
423 <application>Gimp</application> was called with the
424 <option>--no-interface</option> command-line option.
425 </para>
426 <indexterm zone="gimp gimp-console-2.8">
427 <primary sortas="b-gimp-console-2.8">gimp-console-2.8</primary>
428 </indexterm>
429 </listitem>
430 </varlistentry>
431
432 <varlistentry id="gimptool-2.0">
433 <term><command>gimptool-2.0</command></term>
434 <listitem>
435 <para>
436 is a tool that can build plug-ins or scripts and install them
437 if they are distributed in one source file.
438 <command>gimptool-2.0</command> can also be used by programs that
439 need to know what libraries and include-paths The
440 <application>Gimp</application> was compiled with.
441 </para>
442 <indexterm zone="gimp gimptool-2.0">
443 <primary sortas="b-gimptool-2.0">gimptool-2.0</primary>
444 </indexterm>
445 </listitem>
446 </varlistentry>
447
448 <varlistentry id="libgimp-2.0">
449 <term><filename class="libraryfile">libgimp-2.0.so</filename></term>
450 <listitem>
451 <para>
452 provides C bindings for The <application>Gimp</application>'s
453 Procedural Database (PDB) which offers an interface to core functions
454 and to functionality provided by plug-ins.
455 </para>
456 <indexterm zone="gimp libgimp-2.0">
457 <primary sortas="c-libgimp-2.0">libgimp-2.0.so</primary>
458 </indexterm>
459 </listitem>
460 </varlistentry>
461
462 <varlistentry id="libgimpbase-2.0">
463 <term><filename class="libraryfile">libgimpbase-2.0.so</filename></term>
464 <listitem>
465 <para>
466 provides the C functions for basic
467 <application>Gimp</application> functionality such as determining
468 enumeration data types, gettext translation, determining The
469 <application>Gimp</application>'s version number and capabilities,
470 handling data files and accessing the environment.
471 </para>
472 <indexterm zone="gimp libgimpbase-2.0">
473 <primary sortas="c-libgimpbase-2.0">libgimpbase-2.0.so</primary>
474 </indexterm>
475 </listitem>
476 </varlistentry>
477
478 <varlistentry id="libgimpcolor-2.0">
479 <term><filename
480 class="libraryfile">libgimpcolor-2.0.so</filename></term>
481 <listitem>
482 <para>
483 provides the C functions relating to RGB, HSV and CMYK colors as
484 well as converting colors between different color models and
485 performing adaptive supersampling on an area.
486 </para>
487 <indexterm zone="gimp libgimpcolor-2.0">
488 <primary sortas="c-libgimpcolor-2.0">libgimpcolor-2.0.so</primary>
489 </indexterm>
490 </listitem>
491 </varlistentry>
492
493 <varlistentry id="libgimpconfig-2.0">
494 <term><filename
495 class="libraryfile">libgimpconfig-2.0.so</filename></term>
496 <listitem>
497 <para>
498 contains C functions for reading and writing config information.
499 </para>
500 <indexterm zone="gimp libgimpconfig-2.0">
501 <primary sortas="c-libgimpconfig-2.0">libgimpconfig-2.0.so</primary>
502 </indexterm>
503 </listitem>
504 </varlistentry>
505
506 <varlistentry id="libgimpmath-2.0">
507 <term><filename class="libraryfile">libgimpmath-2.0.so</filename></term>
508 <listitem>
509 <para>
510 contains C functions which provide mathematical definitions and
511 macros, manipulate 3x3 transformation matrices, set up and manipulate
512 vectors and the MD5 message-digest algorithm.
513 </para>
514 <indexterm zone="gimp libgimpmath-2.0">
515 <primary sortas="c-libgimpmath-2.0">libgimpmath-2.0.so</primary>
516 </indexterm>
517 </listitem>
518 </varlistentry>
519
520 <varlistentry id="libgimpmodule-2.0">
521 <term><filename class="libraryfile">libgimpmodule-2.0.so</filename></term>
522 <listitem>
523 <para>
524 provides the C functions which implements module loading using
525 GModule and keeps a list of GimpModule's found in a given
526 searchpath.
527 </para>
528 <indexterm zone="gimp libgimpmodule-2.0">
529 <primary sortas="c-libgimpmodule-2.0">libgimpmodule-2.0.so</primary>
530 </indexterm>
531 </listitem>
532 </varlistentry>
533
534 <varlistentry id="libgimpthumb-2.0">
535 <term><filename class="libraryfile">libgimpthumb-2.0.so</filename></term>
536 <listitem>
537 <para>
538 provides the C functions for handling The
539 <application>Gimp</application>'s thumbnail objects.
540 </para>
541 <indexterm zone="gimp libgimpthumb-2.0">
542 <primary sortas="c-libgimpthumb-2.0">libgimpthumb-2.0.so</primary>
543 </indexterm>
544 </listitem>
545 </varlistentry>
546
547 <varlistentry id="libgimpui-2.0">
548 <term><filename class="libraryfile">libgimpui-2.0.so</filename></term>
549 <listitem>
550 <para>
551 contains The <application>Gimp</application>'s common user
552 interface functions.
553 </para>
554 <indexterm zone="gimp libgimpui-2.0">
555 <primary sortas="c-libgimpui-2.0">libgimpui-2.0.so</primary>
556 </indexterm>
557 </listitem>
558 </varlistentry>
559
560 <varlistentry id="libgimpwidgets-2.0">
561 <term><filename class="libraryfile">libgimpwidgets-2.0.so</filename></term>
562 <listitem>
563 <para>
564 contains The <application>Gimp</application>
565 and <application>GTK</application>'s widget creation and
566 manipulation functions.
567 </para>
568 <indexterm zone="gimp libgimpwidgets-2.0">
569 <primary
570 sortas="c-libgimpwidgets-2.0">libgimpwidgets-2.0.so</primary>
571 </indexterm>
572 </listitem>
573 </varlistentry>
574
575 </variablelist>
576
577 </sect2>
578
579</sect1>
Note: See TracBrowser for help on using the repository browser.