source: xsoft/other/gimp.xml@ e5225d5

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 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 e5225d5 was 730a1810, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Lots of tags

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

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