source: xsoft/other/gimp.xml@ 9c105eb

10.0 10.1 11.0 11.1 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 9c105eb was 9c105eb, checked in by Ken Moffat <ken@…>, 4 years ago

New gimp-help snapshot, but note that building it lost links to some images between BLFS-8.1 and BLFS-8.2, so prefer the online help.

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

  • Property mode set to 100644
File size: 18.8 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 "https://download.gimp.org/pub/gimp/v2.10/gimp-&gimp-version;.tar.bz2">
8 <!ENTITY gimp-download-ftp " ">
9 <!ENTITY gimp-md5sum "9e0a3703a920da8b3e51e845fa3bff7d">
10 <!ENTITY gimp-size "30 MB">
11 <!ENTITY gimp-buildsize "630 MB (add 745 MB for tests)">
12 <!ENTITY gimp-time "4.7 SBU (add 0.6 SBU for tests)">
13
14 <!-- pro-tem, a pull of gimp-help, https://gitlab.gnome.org/GNOME/gimp-help.git
15 git archive \-\-format=tar \-\-prefix=${DIRNAME}/ HEAD | xz >../${DIRNAME}.tar.xz -->
16 <!ENTITY gimp-help-version "2018-08-21">
17 <!ENTITY gimp-help-download "&sources-anduin-http;/gimp-help-&gimp-help-version;.tar.xz">
18 <!ENTITY gimp-help-md5sum "4557d7450f0867b4a55190e6525065dc">
19 <!ENTITY gimp-help-size "172 MB">
20 <!ENTITY gimp-help-buildsize "From 352 MB (en only) to 1.6 GB (all 18
21 languages)">
22 <!ENTITY gimp-help-time "1.9 SBU (en only), 13 SBU, with parallelism=4,
23 for all languages">
24]>
25<!--
26 <!ENTITY gimp-help-version "2.8.2">
27 <!ENTITY gimp-help-download "https://download.gimp.org/pub/gimp/help/gimp-help-&gimp-help-version;.tar.bz2">
28 <!ENTITY gimp-help-md5sum "a591c8974b2f4f584d0a769d52ed6c5b">
29 <!ENTITY gimp-help-size "152 MB">
30 <!ENTITY gimp-help-buildsize "From 307 MB (en only) to 1257 MB (all 18
31 languages), average of 52 MB per translation">
32 <!ENTITY gimp-help-time "0.8 SBU (en only), average of 1.2 SBU per
33 translation (measured with 5 languages), 5.9
34 SBU, with parallelism=8, for all languages">
35-->
36
37<sect1 id="gimp" xreflabel="Gimp-&gimp-version;">
38 <?dbhtml filename="gimp.html" ?>
39
40 <sect1info>
41 <othername>$LastChangedBy$</othername>
42 <date>$Date$</date>
43 </sect1info>
44
45 <title>Gimp-&gimp-version;</title>
46
47 <indexterm zone="gimp">
48 <primary sortas="a-Gimp">Gimp</primary>
49 </indexterm>
50
51 <sect2 role="package">
52 <title>Introduction to Gimp</title>
53
54 <para>
55 The <application>Gimp</application> package contains
56 the GNU Image Manipulation Program which is useful for
57 photo retouching, image composition and image authoring.
58 </para>
59
60 &lfs82_checked;
61
62 <bridgehead renderas="sect3">Package Information</bridgehead>
63 <itemizedlist spacing="compact">
64 <listitem>
65 <para>
66 Download (HTTP): <ulink url="&gimp-download-http;"/>
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Download (FTP): <ulink url="&gimp-download-ftp;"/>
72 </para>
73 </listitem>
74 <listitem>
75 <para>
76 Download MD5 sum: &gimp-md5sum;
77 </para>
78 </listitem>
79 <listitem>
80 <para>
81 Download size: &gimp-size;
82 </para>
83 </listitem>
84 <listitem>
85 <para>
86 Estimated disk space required: &gimp-buildsize;
87 </para>
88 </listitem>
89 <listitem>
90 <para>
91 Estimated build time: &gimp-time;
92 </para>
93 </listitem>
94 </itemizedlist>
95
96 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
97 <itemizedlist spacing="compact">
98 <listitem>
99 <note>
100 <para>
101 The creation of local html files with recent versions of the necessary
102 packages is somewhat broken (some png images are not sourced by the
103 generated HTML, only their captions are visible).
104 </para>
105 </note>
106 <para>
107 The updating of the help files is still WIP, with large parts of the
108 text for many languages not yet translated. Here is a git pull:
109 <ulink url="&gimp-help-download;"/>
110 </para>
111 </listitem>
112 <listitem>
113 <para>
114 Download size: &gimp-help-size;
115 </para>
116 <para>
117 Download md5sum: &gimp-help-md5sum;
118 </para>
119 </listitem>
120 <listitem>
121 <para>
122 Estimated disk space required: &gimp-help-buildsize;
123 </para>
124 </listitem>
125 <listitem>
126 <para>
127 Estimated build time: &gimp-help-time;
128 </para>
129 </listitem>
130 </itemizedlist>
131
132 <bridgehead renderas="sect3">Gimp Dependencies</bridgehead>
133
134 <bridgehead renderas="sect4">Required</bridgehead>
135 <para role="required">
136 <xref linkend="gegl"/>,
137 <xref linkend="gexiv2"/>,
138 <xref linkend="glib-networking"/>,
139 <xref linkend="gtk2"/>,
140 <xref linkend="harfbuzz"/>.
141 <xref linkend="libjpeg"/>,
142 <xref linkend="libmypaint"/>,
143 <xref linkend="librsvg"/>,
144 <xref linkend="libtiff"/>,
145 <!-- en can be built without this -->
146 <xref linkend="libxml2py2"/> (to build the translated help files),
147 <xref linkend="lcms2"/>,
148 <xref linkend="mypaint-brushes"/>,
149 <xref linkend="poppler"/> (including poppler-data) and
150 <!-- some parts of Xorg appear to be required, as are deps it pulls in -->
151 <xref linkend="x-window-system"/>
152 </para>
153
154 <bridgehead renderas="sect4">Recommended</bridgehead>
155 <para role="recommended">
156 <xref linkend="dbus-glib"/>,
157 <xref linkend="gs"/> (with libgs installed),
158 <xref linkend="gvfs"/> (to access the online help),
159 <xref linkend="iso-codes"/>,
160 <xref linkend="libgudev"/>,
161 <xref linkend="pygtk"/> (including the gtk, pango and pangocairo modules) and
162 <xref linkend="xdg-utils"/>
163 </para>
164
165 <bridgehead renderas="sect4">Optional</bridgehead>
166 <para role="optional">
167 <xref linkend="aalib"/>,
168 <xref linkend="alsa-lib"/>,
169 <xref linkend="libmng"/>,
170 <xref linkend="libwebp"/>,
171 <xref linkend="openjpeg2"/>,
172 an <xref linkend="server-mail"/> (that provides a
173 <command>sendmail</command> program),
174 <xref linkend="gtk-doc"/>,
175 <ulink url="https://people.freedesktop.org/~hughsient/appstream-glib">appstream-glib</ulink> and
176 <ulink url="http://wvware.sourceforge.net/libwmf.html">libwmf</ulink>
177 </para>
178
179 <para>
180 When you have run configure, you will see that WebKit is not found -
181 that dependency is for the legacy webkit-1.0 which should never be used
182 on a modern system exposed to the internet.
183 </para>
184
185 <bridgehead renderas="sect4">Optional, for building the help system</bridgehead>
186 <para role="optional">
187 <ulink url="http://dblatex.sourceforge.net/">dblatex</ulink> (for PDF docs),
188 <ulink url="http://pngnq.sourceforge.net/">pngnq</ulink> and
189 <ulink url="http://pmt.sourceforge.net/pngcrush/">pngcrush</ulink>
190 to optimize the png files, but see the note on the help download above
191 </para>
192
193 <para condition="html" role="usernotes">User Notes:
194 <ulink url="&blfs-wiki;/gimp"/>
195 </para>
196 </sect2>
197
198 <sect2 role="installation">
199 <title>Installation of Gimp</title>
200
201 <para>
202 Install <application>Gimp</application> by running
203 the following commands:
204 </para>
205
206<screen><userinput>./configure --prefix=/usr \
207 --sysconfdir=/etc &amp;&amp;
208make</userinput></screen>
209
210 <para>
211 To test the results (requires an X-Windowed terminal) issue:
212 <command>make check</command>.
213 </para>
214
215 <para>
216 Now, as the <systemitem class="username">root</systemitem>
217 user:
218 </para>
219
220<screen role="root"><userinput>make install</userinput></screen>
221
222 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
223 href="../../xincludes/update-icons-and-desktop.xml"/>
224
225 </sect2>
226
227 <sect2 role="installation">
228 <title>Installation of Gimp-Help</title>
229
230 <para>
231 The <filename>gimp-help</filename> tarball contains images and English
232 text help for help files, together with translations. Because of the
233 issues mentioned in the note above, you are recommended to use the online
234 help, either by building against <xref linkend="gvfs"/> so that 'help'
235 can open the latest XML files in your browser, or else you can manually
236 open the html in your browser by going to <ulink
237 url="https://docs.gimp.org/2.10/en/">https://docs.gimp.org/2.10/en</ulink>
238 (change the language code if desired).
239 </para>
240
241 <para>
242 If you nevertheless wish to install local copies of the help files to read
243 offline, unpack the <filename>gimp-help</filename> tarball
244 and change into the root of the newly created source tree. Prepare for
245 the build with the following command:
246 </para>
247
248<screen><userinput>ALL_LINGUAS=&quot;ca da de el en en_GB es fi fr it ja ko nl nn pt_BR ro ru zh_CN&quot; \
249./autogen.sh --prefix=/usr &amp;&amp;</userinput></screen>
250
251 <para>
252 Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
253 you do not wish to install. Alternatively, remove the line starting with
254 <envar>ALL_LINGUAS</envar>, if you wish to build all languages.
255 </para>
256
257 <para>
258 Now build the help files:
259 </para>
260
261<screen><userinput>make</userinput></screen>
262
263 <para>
264 Issue the following commands as the
265 <systemitem class="username">root</systemitem> user to install the help
266 files:
267 </para>
268
269<screen role="root"><userinput>make install &amp;&amp;
270chown -R root:root /usr/share/gimp/2.0/help</userinput></screen>
271
272 </sect2>
273
274 <sect2 role="commands" id="gimp-cmd-explanations">
275 <title>Command Explanations</title>
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><option>--disable-python</option>: This option is necessary if
284 you have not installed <application>PyGTK</application>.</para>
285
286 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
287 href="../../xincludes/gtk-doc-rebuild.xml"/>
288
289 </sect2>
290
291 <sect2 role="configuration">
292 <title>Configuring The Gimp</title>
293
294 <sect3 id="gimp-config">
295 <title>Config Files</title>
296
297 <para>
298 <filename>/etc/gimp/2.0/*</filename> and
299 <filename>~/.gimp-2.8/gimprc</filename>
300 </para>
301
302 <indexterm zone="gimp gimp-config">
303 <primary sortas="e-AA.gimp-2.0/gimprc">~/.g/GIMP/2.10/*</primary>
304 </indexterm>
305
306 <indexterm zone="gimp gimp-config">
307 <primary sortas="e-etc-gimp-2.0-star">/etc/gimp/2.0/*</primary>
308 </indexterm>
309
310 </sect3>
311
312 </sect2>
313
314 <sect2 role="content">
315 <title>Contents</title>
316
317 <segmentedlist>
318 <segtitle>Installed Programs</segtitle>
319 <segtitle>Installed Libraries</segtitle>
320 <segtitle>Installed Directories</segtitle>
321
322 <seglistitem>
323 <seg>
324 gimp (symlink), gimp-2.10,
325 gimp-console (symlink), gimp-console-2.10, and
326 gimptool-2.0
327 </seg>
328 <seg>
329 libgimp-2.0.so, libgimpbase-2.0.so, libgimpcolor-2.0.so,
330 libgimpconfig-2.0.so, libgimpmath-2.0.so, libgimpmodule-2.0.so,
331 libgimpthumb-2.0.so, libgimpui-2.0.so, and libgimpwidgets-2.0.so
332 </seg>
333 <seg>
334 /etc/gimp,
335 /usr/include/gimp-2.0,
336 /usr/{lib,share}/gimp,
337 /usr/share/gimp/2.0,
338 /usr/share/gtk-doc/html/libgimp{,base,color,config}, and
339 /usr/share/gtk-doc/html/libgimp{math,module,thumb,widgets}
340 </seg>
341 </seglistitem>
342 </segmentedlist>
343
344 <variablelist>
345 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
346 <?dbfo list-presentation="list"?>
347 <?dbhtml list-presentation="table"?>
348
349 <varlistentry id="gimp-prog">
350 <term><command>gimp</command></term>
351 <listitem>
352 <para>
353 is a symbolic link to <command>gimp-2.10</command>.
354 </para>
355 <indexterm zone="gimp gimp-prog">
356 <primary sortas="b-gimp">gimp</primary>
357 </indexterm>
358 </listitem>
359 </varlistentry>
360
361 <varlistentry id="gimp-2.10">
362 <term><command>gimp-2.10</command></term>
363 <listitem>
364 <para>
365 is the Gnu Image Manipulation Program. It works with a variety
366 of image formats and provides a large selection of tools.
367 </para>
368 <indexterm zone="gimp gimp-2.10">
369 <primary sortas="b-gimp-2.10">gimp-2.10</primary>
370 </indexterm>
371 </listitem>
372 </varlistentry>
373
374 <varlistentry id="gimp-console">
375 <term><command>gimp-console</command></term>
376 <listitem>
377 <para>
378 is a symbolic link to <command>gimp-console-2.10</command>.
379 </para>
380 <indexterm zone="gimp gimp-console">
381 <primary sortas="b-gimp-console">gimp-console</primary>
382 </indexterm>
383 </listitem>
384 </varlistentry>
385
386 <varlistentry id="gimp-console-2.10">
387 <term><command>gimp-console-2.10</command></term>
388 <listitem>
389 <para>
390 is a console program that behaves as if The
391 <application>Gimp</application> was called with the
392 <option>--no-interface</option> command-line option.
393 </para>
394 <indexterm zone="gimp gimp-console-2.10">
395 <primary sortas="b-gimp-console-2.10">gimp-console-2.10</primary>
396 </indexterm>
397 </listitem>
398 </varlistentry>
399
400 <varlistentry id="gimptool-2.0">
401 <term><command>gimptool-2.0</command></term>
402 <listitem>
403 <para>
404 is a tool that can build plug-ins or scripts and install them
405 if they are distributed in one source file.
406 <command>gimptool-2.0</command> can also be used by programs that
407 need to know what libraries and include-paths The
408 <application>Gimp</application> was compiled with.
409 </para>
410 <indexterm zone="gimp gimptool-2.0">
411 <primary sortas="b-gimptool-2.0">gimptool-2.0</primary>
412 </indexterm>
413 </listitem>
414 </varlistentry>
415
416 <varlistentry id="libgimp-2.0">
417 <term><filename class="libraryfile">libgimp-2.0.so</filename></term>
418 <listitem>
419 <para>
420 provides C bindings for The <application>Gimp</application>'s
421 Procedural Database (PDB) which offers an interface to core functions
422 and to functionality provided by plug-ins.
423 </para>
424 <indexterm zone="gimp libgimp-2.0">
425 <primary sortas="c-libgimp-2.0">libgimp-2.0.so</primary>
426 </indexterm>
427 </listitem>
428 </varlistentry>
429
430 <varlistentry id="libgimpbase-2.0">
431 <term><filename class="libraryfile">libgimpbase-2.0.so</filename></term>
432 <listitem>
433 <para>
434 provides the C functions for basic
435 <application>Gimp</application> functionality such as determining
436 enumeration data types, gettext translation, determining The
437 <application>Gimp</application>'s version number and capabilities,
438 handling data files and accessing the environment.
439 </para>
440 <indexterm zone="gimp libgimpbase-2.0">
441 <primary sortas="c-libgimpbase-2.0">libgimpbase-2.0.so</primary>
442 </indexterm>
443 </listitem>
444 </varlistentry>
445
446 <varlistentry id="libgimpcolor-2.0">
447 <term><filename
448 class="libraryfile">libgimpcolor-2.0.so</filename></term>
449 <listitem>
450 <para>
451 provides the C functions relating to RGB, HSV and CMYK colors as
452 well as converting colors between different color models and
453 performing adaptive supersampling on an area.
454 </para>
455 <indexterm zone="gimp libgimpcolor-2.0">
456 <primary sortas="c-libgimpcolor-2.0">libgimpcolor-2.0.so</primary>
457 </indexterm>
458 </listitem>
459 </varlistentry>
460
461 <varlistentry id="libgimpconfig-2.0">
462 <term><filename
463 class="libraryfile">libgimpconfig-2.0.so</filename></term>
464 <listitem>
465 <para>
466 contains C functions for reading and writing config information.
467 </para>
468 <indexterm zone="gimp libgimpconfig-2.0">
469 <primary sortas="c-libgimpconfig-2.0">libgimpconfig-2.0.so</primary>
470 </indexterm>
471 </listitem>
472 </varlistentry>
473
474 <varlistentry id="libgimpmath-2.0">
475 <term><filename class="libraryfile">libgimpmath-2.0.so</filename></term>
476 <listitem>
477 <para>
478 contains C functions which provide mathematical definitions and
479 macros, manipulate 3x3 transformation matrices, set up and manipulate
480 vectors and the MD5 message-digest algorithm.
481 </para>
482 <indexterm zone="gimp libgimpmath-2.0">
483 <primary sortas="c-libgimpmath-2.0">libgimpmath-2.0.so</primary>
484 </indexterm>
485 </listitem>
486 </varlistentry>
487
488 <varlistentry id="libgimpmodule-2.0">
489 <term><filename class="libraryfile">libgimpmodule-2.0.so</filename></term>
490 <listitem>
491 <para>
492 provides the C functions which implements module loading using
493 GModule and keeps a list of GimpModule's found in a given
494 searchpath.
495 </para>
496 <indexterm zone="gimp libgimpmodule-2.0">
497 <primary sortas="c-libgimpmodule-2.0">libgimpmodule-2.0.so</primary>
498 </indexterm>
499 </listitem>
500 </varlistentry>
501
502 <varlistentry id="libgimpthumb-2.0">
503 <term><filename class="libraryfile">libgimpthumb-2.0.so</filename></term>
504 <listitem>
505 <para>
506 provides the C functions for handling The
507 <application>Gimp</application>'s thumbnail objects.
508 </para>
509 <indexterm zone="gimp libgimpthumb-2.0">
510 <primary sortas="c-libgimpthumb-2.0">libgimpthumb-2.0.so</primary>
511 </indexterm>
512 </listitem>
513 </varlistentry>
514
515 <varlistentry id="libgimpui-2.0">
516 <term><filename class="libraryfile">libgimpui-2.0.so</filename></term>
517 <listitem>
518 <para>
519 contains The <application>Gimp</application>'s common user
520 interface functions.
521 </para>
522 <indexterm zone="gimp libgimpui-2.0">
523 <primary sortas="c-libgimpui-2.0">libgimpui-2.0.so</primary>
524 </indexterm>
525 </listitem>
526 </varlistentry>
527
528 <varlistentry id="libgimpwidgets-2.0">
529 <term><filename class="libraryfile">libgimpwidgets-2.0.so</filename></term>
530 <listitem>
531 <para>
532 contains The <application>Gimp</application>
533 and <application>GTK</application>'s widget creation and
534 manipulation functions.
535 </para>
536 <indexterm zone="gimp libgimpwidgets-2.0">
537 <primary
538 sortas="c-libgimpwidgets-2.0">libgimpwidgets-2.0.so</primary>
539 </indexterm>
540 </listitem>
541 </varlistentry>
542
543 </variablelist>
544
545 </sect2>
546
547</sect1>
Note: See TracBrowser for help on using the repository browser.