source: xsoft/other/gimp.xml@ dbd73d6

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since dbd73d6 was dbd73d6, checked in by Douglas R. Reno <renodr@…>, 14 months ago

Last round of tags for the day from me

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