source: xsoft/other/gimp.xml@ 8057fc4

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 12.2 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 gimp3 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/for-12.3 xry111/intltool xry111/llvm18 xry111/soup3 xry111/spidermonkey128 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 8057fc4 was 8057fc4, checked in by Krejzi <krejzi@…>, 12 years ago

Mark more packages as LFS 7.2 checked. Remove Gc ftp link. Update Gimp http link.

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

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