source: xsoft/other/gimp.xml@ 6968e3cb

11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 6968e3cb was dadfb45, checked in by Bruce Dubbs <bdubbs@…>, 2 years ago

Package updates.
Update to mlt-7.4.0.
Update to gimp-2.10.30.
Tweak gegl instructions to remove an obsolete module.

  • 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 "https://download.gimp.org/pub/gimp/v2.10/gimp-&gimp-version;.tar.bz2">
8 <!ENTITY gimp-download-ftp " ">
9 <!ENTITY gimp-md5sum "564fe77da27eaa4dfc73dc8358733d24">
10 <!ENTITY gimp-size "30 MB">
11 <!ENTITY gimp-buildsize "885 MB (194 MB installed, add 814 MB for tests)">
12 <!ENTITY gimp-time "2.0 SBU (Using parallelism=4; add 0.5 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
17 <!-- renodr: I generated the git tarball using the following instructions:
18 cd /tmp &&
19 mkdir gimp-help &&
20 cd gimp-help &&
21 git clone https://gitlab.gnome.org/GNOME/gimp-help.git &&
22 cd gimp-help &&
23 git checkout gimp-help-2-10 &&
24 cd .. &&
25 rm -rv gimp-help/.git &&
26 mv -v gimp-help gimp-help-<DATE>
27 tar -cJvf gimp-help-<DATE>.tar.xz gimp-help-<DATE>
28
29 After you've completed this, run a test build, and upload the tarball to
30 anduin.-->
31
32 <!ENTITY gimp-help-version "2021-03-30">
33 <!ENTITY gimp-help-download "&sources-anduin-http;/gimp/gimp-help-&gimp-help-version;.tar.xz">
34 <!ENTITY gimp-help-md5sum "df6acc812c829b610d621f8e6973a680">
35 <!ENTITY gimp-help-size "170 MB">
36 <!ENTITY gimp-help-buildsize "From 383 MB (en only) to 1.8 GB (all 17
37 languages)">
38 <!ENTITY gimp-help-time "1.8 SBU (en only), 14.0 SBU, with parallelism=4,
39 for all languages">
40]>
41
42<sect1 id="gimp" xreflabel="Gimp-&gimp-version;">
43 <?dbhtml filename="gimp.html" ?>
44
45 <sect1info>
46 <date>$Date$</date>
47 </sect1info>
48
49 <title>Gimp-&gimp-version;</title>
50
51 <indexterm zone="gimp">
52 <primary sortas="a-Gimp">Gimp</primary>
53 </indexterm>
54
55 <sect2 role="package">
56 <title>Introduction to Gimp</title>
57
58 <para>
59 The <application>Gimp</application> package contains
60 the GNU Image Manipulation Program which is useful for
61 photo retouching, image composition and image authoring.
62 </para>
63
64 &lfs110a_checked;
65
66 <bridgehead renderas="sect3">Package Information</bridgehead>
67 <itemizedlist spacing="compact">
68 <listitem>
69 <para>
70 Download (HTTP): <ulink url="&gimp-download-http;"/>
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Download (FTP): <ulink url="&gimp-download-ftp;"/>
76 </para>
77 </listitem>
78 <listitem>
79 <para>
80 Download MD5 sum: &gimp-md5sum;
81 </para>
82 </listitem>
83 <listitem>
84 <para>
85 Download size: &gimp-size;
86 </para>
87 </listitem>
88 <listitem>
89 <para>
90 Estimated disk space required: &gimp-buildsize;
91 </para>
92 </listitem>
93 <listitem>
94 <para>
95 Estimated build time: &gimp-time;
96 </para>
97 </listitem>
98 </itemizedlist>
99
100 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
101<!--
102 <note>
103 <para>
104 The creation of local html files with recent versions of the necessary
105 packages is somewhat broken (some png images are not sourced by the
106 generated HTML, only their captions are visible).
107 </para>
108 </note>
109-->
110 <note>
111 <para>
112 Updating the help files is still a work in progress, with large
113 parts of the text for many languages not yet translated. The file below
114 is a git snapshot.
115 </para>
116 </note>
117
118 <itemizedlist spacing="compact">
119 <listitem>
120 <para>
121 Download (HTTP): <ulink url="&gimp-help-download;"/>
122 </para>
123 </listitem>
124 <listitem>
125 <para>
126 Download size: &gimp-help-size;
127 </para>
128 </listitem>
129 <listitem>
130 <para>
131 Download MD5 sum: &gimp-help-md5sum;
132 </para>
133 </listitem>
134 <listitem>
135 <para>
136 Estimated disk space required: &gimp-help-buildsize;
137 </para>
138 </listitem>
139 <listitem>
140 <para>
141 Estimated build time: &gimp-help-time;
142 </para>
143 </listitem>
144 </itemizedlist>
145
146 <bridgehead renderas="sect3">Gimp Dependencies</bridgehead>
147
148 <bridgehead renderas="sect4">Required</bridgehead>
149 <para role="required">
150 <xref linkend="gegl"/>,
151 <xref linkend="gexiv2"/>,
152 <xref linkend="glib-networking"/>,
153 <xref linkend="gtk2"/>,
154 <xref linkend="harfbuzz"/>.
155 <xref linkend="libjpeg"/>,
156 <xref linkend="libmypaint"/>,
157 <xref linkend="librsvg"/>,
158 <xref linkend="libtiff"/>,
159 <!-- en can be built without this -->
160 <xref linkend="libxml2py2"/> (to build the translated help files),
161 <xref linkend="lcms2"/>,
162 <xref linkend="mypaint-brushes"/>,
163 <xref linkend="poppler"/> (including poppler-data) and
164 <!-- some parts of Xorg appear to be required, as are deps it pulls in -->
165 <xref linkend="x-window-system"/>
166 </para>
167
168 <bridgehead renderas="sect4">Recommended</bridgehead>
169 <para role="recommended">
170 <xref linkend="dbus-glib"/>,
171 <xref linkend="gs"/> (with libgs installed),
172 <xref linkend="iso-codes"/>,
173 <xref linkend="libgudev"/>,
174 <xref linkend="pygtk"/> (including the gtk, pango and pangocairo modules) and
175 <xref linkend="xdg-utils"/>
176 </para>
177
178 <bridgehead renderas="sect4">Optional</bridgehead>
179 <para role="optional">
180 <xref linkend="aalib"/>,
181 <xref linkend="alsa-lib"/>,
182 <xref linkend="gvfs"/> (to access the online help),
183 <xref linkend="libmng"/>,
184 <xref linkend="libwebp"/>,
185 <xref linkend="openjpeg2"/>,
186 an <xref linkend="server-mail"/> (that provides a
187 <command>sendmail</command> program),
188 <xref linkend="gtk-doc"/>,
189 <ulink url="https://people.freedesktop.org/~hughsient/appstream-glib">appstream-glib</ulink>,
190 <ulink url="https://github.com/ianlancetaylor/libbacktrace">libbacktrace</ulink>,
191 <ulink url="https://github.com/strukturag/libheif/">libheif</ulink> with
192 <ulink url="https://github.com/strukturag/libde265/">libde265</ulink>
193 (both needed to read macOS heic images),
194 <ulink url="https://www.nongnu.org/libunwind">libunwind</ulink>,
195 <ulink url="http://wvware.sourceforge.net/libwmf.html">libwmf</ulink>, and
196 <ulink url="https://www.openexr.com/">OpenEXR</ulink>
197 </para>
198
199 <para>
200 When you have run configure, you will see that WebKit is not found -
201 that dependency is for the legacy webkit-1.0 which should never be used
202 on a modern system exposed to the internet.
203 </para>
204
205 <bridgehead renderas="sect4">Optional, for building the help system</bridgehead>
206 <para role="optional">
207 <ulink url="http://dblatex.sourceforge.net/">dblatex</ulink> (for PDF docs),
208 <ulink url="http://pngnq.sourceforge.net/">pngnq</ulink> and
209 <ulink url="http://pmt.sourceforge.net/pngcrush/">pngcrush</ulink>
210 to optimize the png files, but see the note on the help download above
211 </para>
212
213 <para condition="html" role="usernotes">User Notes:
214 <ulink url="&blfs-wiki;/gimp"/>
215 </para>
216 </sect2>
217
218 <sect2 role="installation">
219 <title>Installation of Gimp</title>
220
221 <para>
222 Install <application>Gimp</application> by running
223 the following commands:
224 </para>
225
226<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
227make</userinput></screen>
228
229 <para>
230 To test the results (requires an X-Windowed terminal) issue:
231 <command>make check</command>.
232 <!-- km: in 2.10.16 no failures, 2 tests were skipped -->
233
234 </para>
235
236 <para>
237 Now, as the <systemitem class="username">root</systemitem>
238 user:
239 </para>
240
241<screen role="root"><userinput>make install</userinput></screen>
242
243 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
244 href="../../xincludes/update-icons-and-desktop.xml"/>
245
246 </sect2>
247
248 <sect2 role="installation">
249 <title>Installation of Gimp-Help</title>
250
251 <para>
252 The <filename>gimp-help</filename> tarball contains images and English
253 text help for help files, together with translations. Because of the
254 issues mentioned in the note above, you are recommended to use the online
255 help, either by building against <xref linkend="gvfs"/> so that 'help'
256 can open the latest XML files in your browser, or else you can manually
257 open the html in your browser by going to <ulink
258 url="https://docs.gimp.org/2.10/en/">https://docs.gimp.org/2.10/en</ulink>
259 (change the language code if desired).
260 </para>
261
262 <para>
263 If you nevertheless wish to install local copies of the help files to read
264 offline, unpack the <filename>gimp-help</filename> tarball
265 and change into the root of the newly created source tree. Prepare for
266 the build with the following command:
267 </para>
268
269<screen><userinput>ALL_LINGUAS=&quot;ca da de el en en_GB es fi fr it ja ko nn pt_BR ro ru zh_CN&quot; \
270./autogen.sh --prefix=/usr</userinput></screen>
271
272 <para>
273 Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
274 you do not wish to install. Alternatively, remove the line starting with
275 <envar>ALL_LINGUAS</envar>, if you wish to build all languages.
276 </para>
277
278 <para>
279 Now build the help files:
280 </para>
281
282<screen><userinput>make</userinput></screen>
283
284 <para>
285 Issue the following commands as the
286 <systemitem class="username">root</systemitem> user to install the help
287 files:
288 </para>
289
290<screen role="root"><userinput>make install &amp;&amp;
291chown -R root:root /usr/share/gimp/2.0/help</userinput></screen>
292
293 </sect2>
294
295 <sect2 role="commands" id="gimp-cmd-explanations">
296 <title>Command Explanations</title>
297
298 <para>
299 <envar>ALL_LINGUAS=&quot;ca da de el en en_GB ...&quot;</envar>: by
300 default, the help files will be rendered in all the available languages.
301 Remove the codes of any languages you do not wish to build.
302 </para>
303
304 <para>
305 <option>--disable-python</option>: This option is necessary if
306 you have not installed <application>PyGTK</application>.
307 </para>
308
309 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
310 href="../../xincludes/gtk-doc-rebuild.xml"/>
311
312 </sect2>
313
314 <sect2 role="configuration">
315 <title>Configuring The Gimp</title>
316
317 <sect3 id="gimp-config">
318 <title>Config Files</title>
319
320 <para>
321 <filename>/etc/gimp/2.0/*</filename> and
322 <filename>~/.gimp-2.8/gimprc</filename>
323 </para>
324
325 <indexterm zone="gimp gimp-config">
326 <primary sortas="e-AA.gimp-2.0/gimprc">~/.g/GIMP/2.10/*</primary>
327 </indexterm>
328
329 <indexterm zone="gimp gimp-config">
330 <primary sortas="e-etc-gimp-2.0-star">/etc/gimp/2.0/*</primary>
331 </indexterm>
332
333 </sect3>
334
335 </sect2>
336
337 <sect2 role="content">
338 <title>Contents</title>
339
340 <segmentedlist>
341 <segtitle>Installed Programs</segtitle>
342 <segtitle>Installed Libraries</segtitle>
343 <segtitle>Installed Directories</segtitle>
344
345 <seglistitem>
346 <seg>
347 gimp (symlink), gimp-2.10,
348 gimp-console (symlink), gimp-console-2.10,
349 gimp-test-clipboard-2.0, and
350 gimptool-2.0
351 </seg>
352 <seg>
353 libgimp-2.0.so, libgimpbase-2.0.so, libgimpcolor-2.0.so,
354 libgimpconfig-2.0.so, libgimpmath-2.0.so, libgimpmodule-2.0.so,
355 libgimpthumb-2.0.so, libgimpui-2.0.so, and libgimpwidgets-2.0.so
356 </seg>
357 <seg>
358 /etc/gimp,
359 /usr/include/gimp-2.0,
360 /usr/{lib,share}/gimp,
361 /usr/share/gtk-doc/html/libgimp{,base,color,config}, and
362 /usr/share/gtk-doc/html/libgimp{math,module,thumb,widgets}
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.10</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.10">
385 <term><command>gimp-2.10</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.10">
392 <primary sortas="b-gimp-2.10">gimp-2.10</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.10</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.10">
410 <term><command>gimp-console-2.10</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.10">
418 <primary sortas="b-gimp-console-2.10">gimp-console-2.10</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 class="libraryfile">libgimpcolor-2.0.so</filename></term>
471 <listitem>
472 <para>
473 provides the C functions relating to RGB, HSV and CMYK colors as
474 well as converting colors between different color models and
475 performing adaptive supersampling on an area
476 </para>
477 <indexterm zone="gimp libgimpcolor-2.0">
478 <primary sortas="c-libgimpcolor-2.0">libgimpcolor-2.0.so</primary>
479 </indexterm>
480 </listitem>
481 </varlistentry>
482
483 <varlistentry id="libgimpconfig-2.0">
484 <term><filename class="libraryfile">libgimpconfig-2.0.so</filename></term>
485 <listitem>
486 <para>
487 contains C functions for reading and writing config information
488 </para>
489 <indexterm zone="gimp libgimpconfig-2.0">
490 <primary sortas="c-libgimpconfig-2.0">libgimpconfig-2.0.so</primary>
491 </indexterm>
492 </listitem>
493 </varlistentry>
494
495 <varlistentry id="libgimpmath-2.0">
496 <term><filename class="libraryfile">libgimpmath-2.0.so</filename></term>
497 <listitem>
498 <para>
499 contains C functions which provide mathematical definitions and
500 macros, manipulate 3x3 transformation matrices, set up and manipulate
501 vectors and the MD5 message-digest algorithm
502 </para>
503 <indexterm zone="gimp libgimpmath-2.0">
504 <primary sortas="c-libgimpmath-2.0">libgimpmath-2.0.so</primary>
505 </indexterm>
506 </listitem>
507 </varlistentry>
508
509 <varlistentry id="libgimpmodule-2.0">
510 <term><filename class="libraryfile">libgimpmodule-2.0.so</filename></term>
511 <listitem>
512 <para>
513 provides the C functions which implement module loading using
514 GModule and supports keeping a list of GimpModule's found in a given
515 searchpath
516 </para>
517 <indexterm zone="gimp libgimpmodule-2.0">
518 <primary sortas="c-libgimpmodule-2.0">libgimpmodule-2.0.so</primary>
519 </indexterm>
520 </listitem>
521 </varlistentry>
522
523 <varlistentry id="libgimpthumb-2.0">
524 <term><filename class="libraryfile">libgimpthumb-2.0.so</filename></term>
525 <listitem>
526 <para>
527 provides the C functions for handling The
528 <application>Gimp</application>'s thumbnail objects
529 </para>
530 <indexterm zone="gimp libgimpthumb-2.0">
531 <primary sortas="c-libgimpthumb-2.0">libgimpthumb-2.0.so</primary>
532 </indexterm>
533 </listitem>
534 </varlistentry>
535
536 <varlistentry id="libgimpui-2.0">
537 <term><filename class="libraryfile">libgimpui-2.0.so</filename></term>
538 <listitem>
539 <para>
540 contains The <application>Gimp</application>'s common user
541 interface functions
542 </para>
543 <indexterm zone="gimp libgimpui-2.0">
544 <primary sortas="c-libgimpui-2.0">libgimpui-2.0.so</primary>
545 </indexterm>
546 </listitem>
547 </varlistentry>
548
549 <varlistentry id="libgimpwidgets-2.0">
550 <term><filename class="libraryfile">libgimpwidgets-2.0.so</filename></term>
551 <listitem>
552 <para>
553 contains The <application>Gimp</application>
554 and <application>GTK</application>'s widget creation and
555 manipulation functions
556 </para>
557 <indexterm zone="gimp libgimpwidgets-2.0">
558 <primary sortas="c-libgimpwidgets-2.0">libgimpwidgets-2.0.so</primary>
559 </indexterm>
560 </listitem>
561 </varlistentry>
562
563 </variablelist>
564
565 </sect2>
566
567</sect1>
Note: See TracBrowser for help on using the repository browser.