source: xsoft/other/gimp.xml@ c67fbf64

systemd-11177
Last change on this file since c67fbf64 was c67fbf64, checked in by Krejzi <krejzi@…>, 11 years ago

Remove packages that are now in lfs systemd from blfs.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@11302 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 19.3 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 "392592e8755d046317878d226145900f">
10 <!ENTITY gimp-size "20 MB">
11 <!ENTITY gimp-buildsize "680 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="systemd"/> (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,
356 /usr/share/gtk-doc/html/libgimpbase,
357 /usr/share/gtk-doc/html/libgimpcolor,
358 /usr/share/gtk-doc/html/libgimpconfig,
359 /usr/share/gtk-doc/html/libgimpmath,
360 /usr/share/gtk-doc/html/libgimpmodule,
361 /usr/share/gtk-doc/html/libgimpthumb and
362 /usr/share/gtk-doc/html/libgimpwidgets
363 </seg>
364 </seglistitem>
365 </segmentedlist>
366
367 <variablelist>
368 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
369 <?dbfo list-presentation="list"?>
370 <?dbhtml list-presentation="table"?>
371
372 <varlistentry id="gimp-prog">
373 <term><command>gimp</command></term>
374 <listitem>
375 <para>
376 is a symbolic link to <command>gimp-2.8</command>.
377 </para>
378 <indexterm zone="gimp gimp-prog">
379 <primary sortas="b-gimp">gimp</primary>
380 </indexterm>
381 </listitem>
382 </varlistentry>
383
384 <varlistentry id="gimp-2.8">
385 <term><command>gimp-2.8</command></term>
386 <listitem>
387 <para>
388 is the Gnu Image Manipulation Program. It works with a variety
389 of image formats and provides a large selection of tools.
390 </para>
391 <indexterm zone="gimp gimp-2.8">
392 <primary sortas="b-gimp-2.8">gimp-2.8</primary>
393 </indexterm>
394 </listitem>
395 </varlistentry>
396
397 <varlistentry id="gimp-console">
398 <term><command>gimp-console</command></term>
399 <listitem>
400 <para>
401 is a symbolic link to <command>gimp-console-2.8</command>.
402 </para>
403 <indexterm zone="gimp gimp-console">
404 <primary sortas="b-gimp-console">gimp-console</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 <varlistentry id="gimp-console-2.8">
410 <term><command>gimp-console-2.8</command></term>
411 <listitem>
412 <para>
413 is a console program that behaves as if The
414 <application>Gimp</application> was called with the
415 <option>--no-interface</option> command-line option.
416 </para>
417 <indexterm zone="gimp gimp-console-2.8">
418 <primary sortas="b-gimp-console-2.8">gimp-console-2.8</primary>
419 </indexterm>
420 </listitem>
421 </varlistentry>
422
423 <varlistentry id="gimptool-2.0">
424 <term><command>gimptool-2.0</command></term>
425 <listitem>
426 <para>
427 is a tool that can build plug-ins or scripts and install them
428 if they are distributed in one source file.
429 <command>gimptool-2.0</command> can also be used by programs that
430 need to know what libraries and include-paths The
431 <application>Gimp</application> was compiled with.
432 </para>
433 <indexterm zone="gimp gimptool-2.0">
434 <primary sortas="b-gimptool-2.0">gimptool-2.0</primary>
435 </indexterm>
436 </listitem>
437 </varlistentry>
438
439 <varlistentry id="libgimp-2.0">
440 <term><filename class="libraryfile">libgimp-2.0.so</filename></term>
441 <listitem>
442 <para>
443 provides C bindings for The <application>Gimp</application>'s
444 Procedural Database (PDB) which offers an interface to core functions
445 and to functionality provided by plug-ins.
446 </para>
447 <indexterm zone="gimp libgimp-2.0">
448 <primary sortas="c-libgimp-2.0">libgimp-2.0.so</primary>
449 </indexterm>
450 </listitem>
451 </varlistentry>
452
453 <varlistentry id="libgimpbase-2.0">
454 <term><filename class="libraryfile">libgimpbase-2.0.so</filename></term>
455 <listitem>
456 <para>
457 provides the C functions for basic
458 <application>Gimp</application> functionality such as determining
459 enumeration data types, gettext translation, determining The
460 <application>Gimp</application>'s version number and capabilities,
461 handling data files and accessing the environment.
462 </para>
463 <indexterm zone="gimp libgimpbase-2.0">
464 <primary sortas="c-libgimpbase-2.0">libgimpbase-2.0.so</primary>
465 </indexterm>
466 </listitem>
467 </varlistentry>
468
469 <varlistentry id="libgimpcolor-2.0">
470 <term><filename
471 class="libraryfile">libgimpcolor-2.0.so</filename></term>
472 <listitem>
473 <para>
474 provides the C functions relating to RGB, HSV and CMYK colors as
475 well as converting colors between different color models and
476 performing adaptive supersampling on an area.
477 </para>
478 <indexterm zone="gimp libgimpcolor-2.0">
479 <primary sortas="c-libgimpcolor-2.0">libgimpcolor-2.0.so</primary>
480 </indexterm>
481 </listitem>
482 </varlistentry>
483
484 <varlistentry id="libgimpconfig-2.0">
485 <term><filename
486 class="libraryfile">libgimpconfig-2.0.so</filename></term>
487 <listitem>
488 <para>
489 contains C functions for reading and writing config information.
490 </para>
491 <indexterm zone="gimp libgimpconfig-2.0">
492 <primary sortas="c-libgimpconfig-2.0">libgimpconfig-2.0.so</primary>
493 </indexterm>
494 </listitem>
495 </varlistentry>
496
497 <varlistentry id="libgimpmath-2.0">
498 <term><filename class="libraryfile">libgimpmath-2.0.so</filename></term>
499 <listitem>
500 <para>
501 contains C functions which provide mathematical definitions and
502 macros, manipulate 3x3 transformation matrices, set up and manipulate
503 vectors and the MD5 message-digest algorithm.
504 </para>
505 <indexterm zone="gimp libgimpmath-2.0">
506 <primary sortas="c-libgimpmath-2.0">libgimpmath-2.0.so</primary>
507 </indexterm>
508 </listitem>
509 </varlistentry>
510
511 <varlistentry id="libgimpmodule-2.0">
512 <term><filename class="libraryfile">libgimpmodule-2.0.so</filename></term>
513 <listitem>
514 <para>
515 provides the C functions which implements module loading using
516 GModule and keeps a list of GimpModule's found in a given
517 searchpath.
518 </para>
519 <indexterm zone="gimp libgimpmodule-2.0">
520 <primary sortas="c-libgimpmodule-2.0">libgimpmodule-2.0.so</primary>
521 </indexterm>
522 </listitem>
523 </varlistentry>
524
525 <varlistentry id="libgimpthumb-2.0">
526 <term><filename class="libraryfile">libgimpthumb-2.0.so</filename></term>
527 <listitem>
528 <para>
529 provides the C functions for handling The
530 <application>Gimp</application>'s thumbnail objects.
531 </para>
532 <indexterm zone="gimp libgimpthumb-2.0">
533 <primary sortas="c-libgimpthumb-2.0">libgimpthumb-2.0.so</primary>
534 </indexterm>
535 </listitem>
536 </varlistentry>
537
538 <varlistentry id="libgimpui-2.0">
539 <term><filename class="libraryfile">libgimpui-2.0.so</filename></term>
540 <listitem>
541 <para>
542 contains The <application>Gimp</application>'s common user
543 interface functions.
544 </para>
545 <indexterm zone="gimp libgimpui-2.0">
546 <primary sortas="c-libgimpui-2.0">libgimpui-2.0.so</primary>
547 </indexterm>
548 </listitem>
549 </varlistentry>
550
551 <varlistentry id="libgimpwidgets-2.0">
552 <term><filename class="libraryfile">libgimpwidgets-2.0.so</filename></term>
553 <listitem>
554 <para>
555 contains The <application>Gimp</application>
556 and <application>GTK</application>'s widget creation and
557 manipulation functions.
558 </para>
559 <indexterm zone="gimp libgimpwidgets-2.0">
560 <primary
561 sortas="c-libgimpwidgets-2.0">libgimpwidgets-2.0.so</primary>
562 </indexterm>
563 </listitem>
564 </varlistentry>
565
566 </variablelist>
567
568 </sect2>
569
570</sect1>
Note: See TracBrowser for help on using the repository browser.