source: xsoft/other/gimp.xml@ f45fa1c

systemd-13485
Last change on this file since f45fa1c was 37191af, checked in by Douglas R. Reno <renodr@…>, 8 years ago

Sync to trunk r17270. Last round for the night.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@17330 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://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 &lfs78_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>sed -i '/gegl/s/2/3/' configure.ac &amp;&amp;
190autoreconf -fiv &amp;&amp;
191./configure --prefix=/usr \
192 --sysconfdir=/etc \
193 --without-gvfs &amp;&amp;
194
195make</userinput></screen>
196
197 <para>
198 To test the results (requires an X-Windowed terminal) issue:
199 <command>make check</command>.
200 </para>
201
202 <para>
203 Now, as the <systemitem class="username">root</systemitem>
204 user:
205 </para>
206
207<screen role="root"><userinput>make install</userinput></screen>
208
209 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
210 href="../../xincludes/update-icons-and-desktop.xml"/>
211
212 </sect2>
213
214 <sect2 role="installation">
215 <title>Installation of Gimp-Help</title>
216
217 <para>
218 The <filename>gimp-help</filename> tarball contains images and English
219 text help for help files, together with translations.
220 </para>
221
222 <para>
223 If you downloaded the <filename>gimp-help</filename> tarball, unpack
224 it and change into the root of the newly created source tree. Prepare for
225 the build with the following command:
226 </para>
227
228<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; \
229./configure --prefix=/usr &amp;&amp;</userinput></screen>
230
231 <para>
232 Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
233 you do not wish to install. Alternatively, remove the line starting with
234 <envar>ALL_LINGUAS</envar>, if you wish to build all languages.
235 </para>
236
237<!-- <para>
238 Alternatively, if you wish to build languages including Catalan,
239 apply the patch:
240 </para>
241
242<screen role="nodump"><userinput>xzcat ../gimp-help-2.8.0-build_fixes-1.patch.xz \
243 | patch -p1 &amp;&amp;
244./autogen.sh -prefix=/usr &amp;&amp;</userinput></screen>
245
246 <para>
247 Again, you can specify a subset of languages by specifying
248 <envar>ALL_LINGUAS</envar> in front of <command>./autogen.sh</command>, but
249 this time including &quot;ca&quot;.
250 </para>
251 -->
252 <para>
253 Now build the help files:
254 </para>
255
256<screen><userinput>make</userinput></screen>
257
258 <para>
259 Issue the following commands as the
260 <systemitem class="username">root</systemitem> user to install the help
261 files:
262 </para>
263
264<screen role="root"><userinput>make install &amp;&amp;
265chown -R root:root /usr/share/gimp/2.0/help</userinput></screen>
266
267 </sect2>
268
269 <sect2 role="commands" id="gimp-cmd-explanations">
270 <title>Command Explanations</title>
271
272 <para>
273 <command>sed ... configure.ac</command>: This command allows
274 building with the current version of gegl.
275 </para>
276
277 <para>
278 <envar>ALL_LINGUAS=&quot;ca da de el en en_GB ...&quot;</envar>: by
279 default, the help files will be rendered in all the available languages.
280 Remove the codes of any languages you do not wish to build.
281 </para>
282
283 <para>
284 <parameter>--without-gvfs</parameter>: the choice of the backend to
285 handle URI information, e.g., when dragging images from a browser into the
286 <application>Gimp</application>, is made at compile time. This parameter will
287 ensure that <application>cURL</application> is used at run-time, instead of
288 <application>Gvfs</application>. You can omit this if you are installing
289 <application>Gvfs</application> AND will be running <command>gvfsd</command>,
290 e.g., in a <application>GNOME</application> desktop.
291 </para>
292
293 <para><option>--disable-python</option>: This option is necessary if
294 you have not installed <application>PyGTK</application>.</para>
295
296<!--<para>
297 <command>./autogen.sh</command> <parameter>-prefix=/usr</parameter>: In this case, using
298 <command>autoreconf</command> to regenerate <filename>configure</filename>
299 does not work, because of how the gimp-help developers chose to address
300 problems with the autotools.
301 </para>
302
303 <para>
304 <command>xzcat ../gimp-help-2.8.0-build_fixes-1.patch.xz</command>:
305 this patch is large, so it has been compressed with
306 <application>xz</application>. You are encouraged to be suspicious of
307 all patches until you have looked at them. Use <command>view</command>
308 to read the compressed patch before you apply it.
309 </para>
310-->
311 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
312 href="../../xincludes/gtk-doc-rebuild.xml"/>
313
314 </sect2>
315
316 <sect2 role="configuration">
317 <title>Configuring The Gimp</title>
318
319 <sect3 id="gimp-config">
320 <title>Config Files</title>
321
322 <para>
323 <filename>/etc/gimp/2.0/*</filename> and
324 <filename>~/.gimp-2.8/gimprc</filename>
325 </para>
326
327 <indexterm zone="gimp gimp-config">
328 <primary sortas="e-AA.gimp-2.0/gimprc">~/.gimp-2.0/gimprc</primary>
329 </indexterm>
330
331 <indexterm zone="gimp gimp-config">
332 <primary sortas="e-etc-gimp-2.0-star">/etc/gimp/2.0/*</primary>
333 </indexterm>
334
335 </sect3>
336
337 <sect3>
338 <title>Configuration Information</title>
339
340 <para>
341 The <application>Gimp</application> executes a configuration wizard
342 for each user upon their initial use of the program.
343 </para>
344
345 </sect3>
346
347 </sect2>
348
349 <sect2 role="content">
350 <title>Contents</title>
351
352 <segmentedlist>
353 <segtitle>Installed Programs</segtitle>
354 <segtitle>Installed Libraries</segtitle>
355 <segtitle>Installed Directories</segtitle>
356
357 <seglistitem>
358 <seg>
359 gimp, gimp-2.8,
360 gimp-console, gimp-console-2.8, and
361 gimptool-2.0
362 </seg>
363 <seg>
364 libgimp-2.0.so, libgimpbase-2.0.so, libgimpcolor-2.0.so,
365 libgimpconfig-2.0.so, libgimpmath-2.0.so, libgimpmodule-2.0.so,
366 libgimpthumb-2.0.so, libgimpui-2.0.so, and libgimpwidgets-2.0.so
367 </seg>
368 <seg>
369 /etc/gimp,
370 /usr/include/gimp-2.0,
371 /usr/{lib,share}/gimp,
372 /usr/share/gimp/2.0/help/{en,lang2,lang3,...},
373 /usr/share/gtk-doc/html/libgimp{,base,color,config}, and
374 /usr/share/gtk-doc/html/libgimp{math,module,thumb,widgets}
375 </seg>
376 </seglistitem>
377 </segmentedlist>
378
379 <variablelist>
380 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
381 <?dbfo list-presentation="list"?>
382 <?dbhtml list-presentation="table"?>
383
384 <varlistentry id="gimp-prog">
385 <term><command>gimp</command></term>
386 <listitem>
387 <para>
388 is a symbolic link to <command>gimp-2.8</command>.
389 </para>
390 <indexterm zone="gimp gimp-prog">
391 <primary sortas="b-gimp">gimp</primary>
392 </indexterm>
393 </listitem>
394 </varlistentry>
395
396 <varlistentry id="gimp-2.8">
397 <term><command>gimp-2.8</command></term>
398 <listitem>
399 <para>
400 is the Gnu Image Manipulation Program. It works with a variety
401 of image formats and provides a large selection of tools.
402 </para>
403 <indexterm zone="gimp gimp-2.8">
404 <primary sortas="b-gimp-2.8">gimp-2.8</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 <varlistentry id="gimp-console">
410 <term><command>gimp-console</command></term>
411 <listitem>
412 <para>
413 is a symbolic link to <command>gimp-console-2.8</command>.
414 </para>
415 <indexterm zone="gimp gimp-console">
416 <primary sortas="b-gimp-console">gimp-console</primary>
417 </indexterm>
418 </listitem>
419 </varlistentry>
420
421 <varlistentry id="gimp-console-2.8">
422 <term><command>gimp-console-2.8</command></term>
423 <listitem>
424 <para>
425 is a console program that behaves as if The
426 <application>Gimp</application> was called with the
427 <option>--no-interface</option> command-line option.
428 </para>
429 <indexterm zone="gimp gimp-console-2.8">
430 <primary sortas="b-gimp-console-2.8">gimp-console-2.8</primary>
431 </indexterm>
432 </listitem>
433 </varlistentry>
434
435 <varlistentry id="gimptool-2.0">
436 <term><command>gimptool-2.0</command></term>
437 <listitem>
438 <para>
439 is a tool that can build plug-ins or scripts and install them
440 if they are distributed in one source file.
441 <command>gimptool-2.0</command> can also be used by programs that
442 need to know what libraries and include-paths The
443 <application>Gimp</application> was compiled with.
444 </para>
445 <indexterm zone="gimp gimptool-2.0">
446 <primary sortas="b-gimptool-2.0">gimptool-2.0</primary>
447 </indexterm>
448 </listitem>
449 </varlistentry>
450
451 <varlistentry id="libgimp-2.0">
452 <term><filename class="libraryfile">libgimp-2.0.so</filename></term>
453 <listitem>
454 <para>
455 provides C bindings for The <application>Gimp</application>'s
456 Procedural Database (PDB) which offers an interface to core functions
457 and to functionality provided by plug-ins.
458 </para>
459 <indexterm zone="gimp libgimp-2.0">
460 <primary sortas="c-libgimp-2.0">libgimp-2.0.so</primary>
461 </indexterm>
462 </listitem>
463 </varlistentry>
464
465 <varlistentry id="libgimpbase-2.0">
466 <term><filename class="libraryfile">libgimpbase-2.0.so</filename></term>
467 <listitem>
468 <para>
469 provides the C functions for basic
470 <application>Gimp</application> functionality such as determining
471 enumeration data types, gettext translation, determining The
472 <application>Gimp</application>'s version number and capabilities,
473 handling data files and accessing the environment.
474 </para>
475 <indexterm zone="gimp libgimpbase-2.0">
476 <primary sortas="c-libgimpbase-2.0">libgimpbase-2.0.so</primary>
477 </indexterm>
478 </listitem>
479 </varlistentry>
480
481 <varlistentry id="libgimpcolor-2.0">
482 <term><filename
483 class="libraryfile">libgimpcolor-2.0.so</filename></term>
484 <listitem>
485 <para>
486 provides the C functions relating to RGB, HSV and CMYK colors as
487 well as converting colors between different color models and
488 performing adaptive supersampling on an area.
489 </para>
490 <indexterm zone="gimp libgimpcolor-2.0">
491 <primary sortas="c-libgimpcolor-2.0">libgimpcolor-2.0.so</primary>
492 </indexterm>
493 </listitem>
494 </varlistentry>
495
496 <varlistentry id="libgimpconfig-2.0">
497 <term><filename
498 class="libraryfile">libgimpconfig-2.0.so</filename></term>
499 <listitem>
500 <para>
501 contains C functions for reading and writing config information.
502 </para>
503 <indexterm zone="gimp libgimpconfig-2.0">
504 <primary sortas="c-libgimpconfig-2.0">libgimpconfig-2.0.so</primary>
505 </indexterm>
506 </listitem>
507 </varlistentry>
508
509 <varlistentry id="libgimpmath-2.0">
510 <term><filename class="libraryfile">libgimpmath-2.0.so</filename></term>
511 <listitem>
512 <para>
513 contains C functions which provide mathematical definitions and
514 macros, manipulate 3x3 transformation matrices, set up and manipulate
515 vectors and the MD5 message-digest algorithm.
516 </para>
517 <indexterm zone="gimp libgimpmath-2.0">
518 <primary sortas="c-libgimpmath-2.0">libgimpmath-2.0.so</primary>
519 </indexterm>
520 </listitem>
521 </varlistentry>
522
523 <varlistentry id="libgimpmodule-2.0">
524 <term><filename class="libraryfile">libgimpmodule-2.0.so</filename></term>
525 <listitem>
526 <para>
527 provides the C functions which implements module loading using
528 GModule and keeps a list of GimpModule's found in a given
529 searchpath.
530 </para>
531 <indexterm zone="gimp libgimpmodule-2.0">
532 <primary sortas="c-libgimpmodule-2.0">libgimpmodule-2.0.so</primary>
533 </indexterm>
534 </listitem>
535 </varlistentry>
536
537 <varlistentry id="libgimpthumb-2.0">
538 <term><filename class="libraryfile">libgimpthumb-2.0.so</filename></term>
539 <listitem>
540 <para>
541 provides the C functions for handling The
542 <application>Gimp</application>'s thumbnail objects.
543 </para>
544 <indexterm zone="gimp libgimpthumb-2.0">
545 <primary sortas="c-libgimpthumb-2.0">libgimpthumb-2.0.so</primary>
546 </indexterm>
547 </listitem>
548 </varlistentry>
549
550 <varlistentry id="libgimpui-2.0">
551 <term><filename class="libraryfile">libgimpui-2.0.so</filename></term>
552 <listitem>
553 <para>
554 contains The <application>Gimp</application>'s common user
555 interface functions.
556 </para>
557 <indexterm zone="gimp libgimpui-2.0">
558 <primary sortas="c-libgimpui-2.0">libgimpui-2.0.so</primary>
559 </indexterm>
560 </listitem>
561 </varlistentry>
562
563 <varlistentry id="libgimpwidgets-2.0">
564 <term><filename class="libraryfile">libgimpwidgets-2.0.so</filename></term>
565 <listitem>
566 <para>
567 contains The <application>Gimp</application>
568 and <application>GTK</application>'s widget creation and
569 manipulation functions.
570 </para>
571 <indexterm zone="gimp libgimpwidgets-2.0">
572 <primary
573 sortas="c-libgimpwidgets-2.0">libgimpwidgets-2.0.so</primary>
574 </indexterm>
575 </listitem>
576 </varlistentry>
577
578 </variablelist>
579
580 </sect2>
581
582</sect1>
Note: See TracBrowser for help on using the repository browser.