source: xsoft/other/gimp.xml@ 0d7900a

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

Removed extraneous spaces from blank lines and at the end of lines in the .xml

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@11015 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://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 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
203 href="../../xincludes/update-icons-and-desktop.xml"/>
204 </sect2>
205
206 <sect2 role="commands" id="gimp-cmd-explanations">
207 <title>Command Explanations</title>
208
209 <para><command>LINGUAS=&quot;ca da de en en_GB ...&quot;</command>: by
210 default, the help files will be rendered in all the available languages.
211 Remove the codes of any languages you do not wish to build.</para>
212
213 <para><parameter>--without-gvfs</parameter>: the choice of the backend to
214 handle URI information, e.g., when dragging images from a browser into the
215 <application>Gimp</application>, is made at compile time. This parameter will
216 ensure that <application>cURL</application> is used at run-time, instead of
217 <application>Gvfs</application>. You can omit this if you are installing
218 <application>Gvfs</application> AND will be running <command>gvfsd</command>,
219 e.g., in a <application>GNOME</application> desktop.</para>
220
221 <!-- These are required by gdk-pixbuf, which is required by GTK+-2
222 <para><option>-without-libpng</option>: This option is necessary if
223 <application>libpng</application> is not installed.</para>
224
225 <para><option>-without-libjpeg</option>: This option is necessary if
226 <application>libjpeg</application> is not installed.</para>
227
228 <para><option>-without-libtiff</option>: This option is necessary if
229 <application>libtiff</application> is not installed.</para> -->
230
231 <para><option>--disable-python</option>: This option is necessary if
232 you have not installed <application>PyGTK</application>.</para>
233
234 <para><parameter>./autogen.sh --prefix=/usr</parameter>: In this case, using
235 <command>autoreconf</command> to regenerate <filename>configure</filename>
236 does not work, because of how the gimp-help developers chose to address
237 problems with the autotools.</para>
238
239 <para><parameter>xzcat ../gimp-help-2.8.0-build_fixes-1.patch.xz</parameter>:
240 this patch is large, so it has been compressed with
241 <application>xz</application>. You are encouraged to be suspicious of
242 all patches until you have looked at them. Use <command>view</command>
243 to read the compressed patch before you apply it.</para>
244
245 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
246 href="../../xincludes/gtk-doc-rebuild.xml"/>
247 </sect2>
248
249 <sect2 role="configuration">
250 <title>Configuring The Gimp</title>
251
252 <sect3 id="gimp-config">
253 <title>Config Files</title>
254
255 <para><filename>/etc/gimp/2.0/*</filename> and
256 <filename>~/.gimp-2.8/gimprc</filename></para>
257
258 <indexterm zone="gimp gimp-config">
259 <primary sortas="e-AA.gimp-2.0/gimprc">~/.gimp-2.0/gimprc</primary>
260 </indexterm>
261
262 <indexterm zone="gimp gimp-config">
263 <primary sortas="e-etc-gimp-2.0-star">/etc/gimp/2.0/*</primary>
264 </indexterm>
265 </sect3>
266
267 <sect3>
268 <title>Configuration Information</title>
269
270 <para>The <application>Gimp</application> executes a configuration wizard
271 for each user upon their initial use of the program.</para>
272
273 <para>The <application>Gimp</application> executes the
274 <command>firefox</command> web browser by default to view the help
275 files. If you do not have <application>Firefox</application>, or
276 prefer a different web browser, you can set a new system value in
277 <filename>/etc/gimp/2.0/gimprc</filename>. Execute the following
278 command as the <systemitem class="username">root</systemitem> user,
279 replacing <replaceable>&lt;browser&gt;</replaceable> with your
280 preferred web browser:</para>
281
282<screen role="root"><userinput>echo '(web-browser "<replaceable>&lt;browser&gt;</replaceable> %s")' &gt;&gt; /etc/gimp/2.0/gimprc</userinput></screen>
283 </sect3>
284 </sect2>
285
286 <sect2 role="content">
287 <title>Contents</title>
288
289 <segmentedlist>
290 <segtitle>Installed Programs</segtitle>
291 <segtitle>Installed Libraries</segtitle>
292 <segtitle>Installed Directories</segtitle>
293
294 <seglistitem>
295 <seg>gimp, gimp-2.8, gimp-console, gimp-console-2.8,
296 and gimptool-2.0</seg>
297 <seg>libgimp-2.0.so, libgimpbase-2.0.so, libgimpcolor-2.0.so,
298 libgimpconfig-2.0.so, libgimpmath-2.0.so, libgimpmodule-2.0.so,
299 libgimpthumb-2.0.so, libgimpui-2.0.so, libgimpwidgets-2.0.so, and many
300 other modules and plugin libraries</seg>
301 <seg>/etc/gimp, /usr/include/gimp-2.0, /usr/lib/gimp,
302 /usr/share/gimp and
303 /usr/share/gtk-doc/html/libgimp{,base,color,config,math,module,thumb,widgets}</seg>
304 </seglistitem>
305 </segmentedlist>
306
307 <variablelist>
308 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
309 <?dbfo list-presentation="list"?>
310 <?dbhtml list-presentation="table"?>
311
312 <varlistentry id="gimp-prog">
313 <term><command>gimp</command></term>
314 <listitem>
315 <para>is a symbolic link to <command>gimp-2.8</command>.</para>
316 <indexterm zone="gimp gimp-prog">
317 <primary sortas="b-gimp">gimp</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="gimp-2.8">
323 <term><command>gimp-2.8</command></term>
324 <listitem>
325 <para>is the Gnu Image Manipulation Program. It works with a variety
326 of image formats and provides a large selection of tools.</para>
327 <indexterm zone="gimp gimp-2.8">
328 <primary sortas="b-gimp-2.8">gimp-2.8</primary>
329 </indexterm>
330 </listitem>
331 </varlistentry>
332
333 <varlistentry id="gimp-console">
334 <term><command>gimp-console</command></term>
335 <listitem>
336 <para>is a symbolic link to <command>gimp-console-2.8</command>.</para>
337 <indexterm zone="gimp gimp-console">
338 <primary sortas="b-gimp-console">gimp-console</primary>
339 </indexterm>
340 </listitem>
341 </varlistentry>
342
343 <varlistentry id="gimp-console-2.8">
344 <term><command>gimp-console-2.8</command></term>
345 <listitem>
346 <para>is a console program that behaves as if The
347 <application>Gimp</application> was called with the
348 <option>--no-interface</option> command-line option.</para>
349 <indexterm zone="gimp gimp-console-2.8">
350 <primary sortas="b-gimp-console-2.8">gimp-console-2.8</primary>
351 </indexterm>
352 </listitem>
353 </varlistentry>
354
355 <varlistentry id="gimptool-2.0">
356 <term><command>gimptool-2.0</command></term>
357 <listitem>
358 <para>is a tool that can build plug-ins or scripts and install them
359 if they are distributed in one source file.
360 <command>gimptool-2.0</command> can also be used by programs that
361 need to know what libraries and include-paths The
362 <application>Gimp</application> was compiled with.</para>
363 <indexterm zone="gimp gimptool-2.0">
364 <primary sortas="b-gimptool-2.0">gimptool-2.0</primary>
365 </indexterm>
366 </listitem>
367 </varlistentry>
368
369 <varlistentry id="libgimp-2.0">
370 <term><filename class="libraryfile">libgimp-2.0.so</filename></term>
371 <listitem>
372 <para> provides C bindings for The <application>Gimp</application>'s
373 Procedural Database (PDB) which offers an interface to core functions
374 and to functionality provided by plug-ins.</para>
375 <indexterm zone="gimp libgimp-2.0">
376 <primary sortas="c-libgimp-2.0">libgimp-2.0.so</primary>
377 </indexterm>
378 </listitem>
379 </varlistentry>
380
381 <varlistentry id="libgimpbase-2.0">
382 <term><filename class="libraryfile">libgimpbase-2.0.so</filename></term>
383 <listitem>
384 <para>provides the C functions for basic
385 <application>Gimp</application> functionality such as determining
386 enumeration data types, gettext translation, determining The
387 <application>Gimp</application>'s version number and capabilities,
388 handling data files and accessing the environment.</para>
389 <indexterm zone="gimp libgimpbase-2.0">
390 <primary sortas="c-libgimpbase-2.0">libgimpbase-2.0.so</primary>
391 </indexterm>
392 </listitem>
393 </varlistentry>
394
395 <varlistentry id="libgimpcolor-2.0">
396 <term><filename
397 class="libraryfile">libgimpcolor-2.0.so</filename></term>
398 <listitem>
399 <para>provides the C functions relating to RGB, HSV and CMYK colors as
400 well as converting colors between different color models and
401 performing adaptive supersampling on an area.</para>
402 <indexterm zone="gimp libgimpcolor-2.0">
403 <primary sortas="c-libgimpcolor-2.0">libgimpcolor-2.0.so</primary>
404 </indexterm>
405 </listitem>
406 </varlistentry>
407
408 <varlistentry id="libgimpconfig-2.0">
409 <term><filename
410 class="libraryfile">libgimpconfig-2.0.so</filename></term>
411 <listitem>
412 <para>contains C functions for reading and writing config information.
413 </para>
414 <indexterm zone="gimp libgimpconfig-2.0">
415 <primary sortas="c-libgimpconfig-2.0">libgimpconfig-2.0.so</primary>
416 </indexterm>
417 </listitem>
418 </varlistentry>
419
420 <varlistentry id="libgimpmath-2.0">
421 <term><filename class="libraryfile">libgimpmath-2.0.so</filename></term>
422 <listitem>
423 <para>contains C functions which provide mathematical definitions and
424 macros, manipulate 3x3 transformation matrices, set up and manipulate
425 vectors and the MD5 message-digest algorithm.</para>
426 <indexterm zone="gimp libgimpmath-2.0">
427 <primary sortas="c-libgimpmath-2.0">libgimpmath-2.0.so</primary>
428 </indexterm>
429 </listitem>
430 </varlistentry>
431
432 <varlistentry id="libgimpmodule-2.0">
433 <term><filename
434 class="libraryfile">libgimpmodule-2.0.so</filename></term>
435 <listitem>
436 <para>provides the C functions which implements module loading using
437 GModule and keeps a list of GimpModule's found in a given
438 searchpath.</para>
439 <indexterm zone="gimp libgimpmodule-2.0">
440 <primary sortas="c-libgimpmodule-2.0">libgimpmodule-2.0.so</primary>
441 </indexterm>
442 </listitem>
443 </varlistentry>
444
445 <varlistentry id="libgimpthumb-2.0">
446 <term><filename
447 class="libraryfile">libgimpthumb-2.0.so</filename></term>
448 <listitem>
449 <para>provides the C functions for handling The
450 <application>Gimp</application>'s thumbnail objects.</para>
451 <indexterm zone="gimp libgimpthumb-2.0">
452 <primary sortas="c-libgimpthumb-2.0">libgimpthumb-2.0.so</primary>
453 </indexterm>
454 </listitem>
455 </varlistentry>
456
457 <varlistentry id="libgimpui-2.0">
458 <term><filename class="libraryfile">libgimpui-2.0.so</filename></term>
459 <listitem>
460 <para>contains The <application>Gimp</application>'s common user
461 interface functions.</para>
462 <indexterm zone="gimp libgimpui-2.0">
463 <primary sortas="c-libgimpui-2.0">libgimpui-2.0.so</primary>
464 </indexterm>
465 </listitem>
466 </varlistentry>
467
468 <varlistentry id="libgimpwidgets-2.0">
469 <term><filename
470 class="libraryfile">libgimpwidgets-2.0.so</filename></term>
471 <listitem>
472 <para>contains The <application>Gimp</application>
473 and <application>GTK</application>'s widget creation and
474 manipulation functions.</para>
475 <indexterm zone="gimp libgimpwidgets-2.0">
476 <primary
477 sortas="c-libgimpwidgets-2.0">libgimpwidgets-2.0.so</primary>
478 </indexterm>
479 </listitem>
480 </varlistentry>
481 </variablelist>
482 </sect2>
483</sect1>
Note: See TracBrowser for help on using the repository browser.