source: xsoft/other/gimp.xml@ ef68c78

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since ef68c78 was ef68c78, checked in by Krejzi <krejzi@…>, 11 years ago

gimp 2.8.6 and evince 3.8.3

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