source: xsoft/other/gimp.xml@ bc39dca

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 bc39dca was bc39dca, checked in by Randy McMurchy <randy@…>, 11 years ago

Modified dependencies and general cleanup of the Gimp instructions

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

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