source: xsoft/other/gimp.xml@ fad7ff1

12.2 lazarus trunk xry111/for-12.3 xry111/spidermonkey128
Last change on this file since fad7ff1 was fad7ff1, checked in by Douglas R. Reno <renodr@…>, 2 months ago

GIMP: Fixed the dependencies and updated short descriptions

  • Added gjs dependency (optional)
  • Added lua dependency (optional)
  • Added pygobject3 dependency (Recommended, see meson.build)
  • Added libjxl dependency (optional)
  • Added cfitsio, qoi, libiff, libilbm external dependencies
  • Removed duplicate appstream-glib dependency
  • Changed gimptool-2.99's description to say gimptool-2.99 instead of gimptool-2.0 when referencing how it can be used by other programs.
  • Property mode set to 100644
File size: 18.1 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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 "&sources-anduin-http;/gimp/gimp3-&gimp-version;.tar.xz">
8 <!ENTITY gimp-download-ftp " ">
9 <!ENTITY gimp-md5sum "17fcd0bfc8e66fc61d672b4409cb3e3a">
10 <!ENTITY gimp-size "26 MB">
11 <!ENTITY gimp-buildsize "456 MB (162 MB installed)">
12 <!ENTITY gimp-time "1.2 SBU (Using parallelism=4)">
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 "&gimp-version;">
33 <!ENTITY gimp-help-download "&sources-anduin-http;/gimp/gimp3-help-&gimp-help-version;.tar.xz">
34<!-- <!ENTITY gimp-help-download "https://download.gimp.org/pub/gimp/help/gimp-help-&gimp-help-version;.tar.bz2">-->
35 <!ENTITY gimp-help-md5sum "162d57a67ff737ed221a8d7f274d119f">
36 <!ENTITY gimp-help-size "129 MB">
37 <!ENTITY gimp-help-buildsize "From 351 MB (74 MB installed) for en only to 1.5 GB for all
38 languages">
39 <!ENTITY gimp-help-time "0.4 SBU (en only), 5.1 SBU for all languages; using parallelism=4">
40]>
41
42<sect1 id="gimp" xreflabel="Gimp-&gimp-version;">
43 <?dbhtml filename="gimp.html" ?>
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 &lfs121_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<!--
98 <note>
99 <para>
100 The creation of local html files with recent versions of the necessary
101 packages is somewhat broken (some png images are not sourced by the
102 generated HTML, only their captions are visible).
103 </para>
104 </note>
105-->
106 <note>
107 <para>
108 The help files English version is complete, but large
109 parts of the text for many other languages are not yet translated.
110 </para>
111 </note>
112
113
114 <itemizedlist spacing="compact">
115 <listitem>
116 <para>
117 Download (HTTP): <ulink url="&gimp-help-download;"/>
118 </para>
119 </listitem>
120 <listitem>
121 <para>
122 Download size: &gimp-help-size;
123 </para>
124 </listitem>
125 <listitem>
126 <para>
127 Download MD5 sum: &gimp-help-md5sum;
128 </para>
129 </listitem>
130 <listitem>
131 <para>
132 Estimated disk space required: &gimp-help-buildsize;
133 </para>
134 </listitem>
135 <listitem>
136 <para>
137 Estimated build time: &gimp-help-time;
138 </para>
139 </listitem>
140 </itemizedlist>
141
142 <bridgehead renderas="sect3">Gimp Dependencies</bridgehead>
143
144 <bridgehead renderas="sect4">Required</bridgehead>
145 <para role="required">
146 <xref linkend="appstream-glib"/>,
147 <xref linkend="gegl"/>,
148 <xref linkend="gexiv2"/>,
149 <xref linkend="glib-networking"/>,
150 <xref linkend="harfbuzz"/>,
151 <xref linkend="libjpeg"/>,
152 <xref linkend="libmypaint"/>,
153 <xref linkend="librsvg"/>,
154 <xref linkend="libtiff"/>,
155 <!-- en can be built without this -->
156 <xref linkend="libxml2"/> (to build the translated help files),
157 <xref linkend="lcms2"/>,
158 <xref linkend="mypaint-brushes"/>, and
159 <xref linkend="poppler"/> (including poppler-data)
160 </para>
161
162 <bridgehead renderas="sect4">Recommended</bridgehead>
163 <para role="recommended">
164 <xref linkend="graphviz"/>,
165 <xref linkend="gs"/> (with libgs installed),
166 <xref linkend="iso-codes"/>,
167 <xref linkend="libgudev"/>,
168 <xref linkend="pygobject3"/>, and
169 <xref linkend="xdg-utils"/>
170 </para>
171
172 <bridgehead renderas="sect4">Optional</bridgehead>
173 <para role="optional">
174 <xref linkend="aalib"/>,
175 <xref linkend="alsa-lib"/>,
176 <xref linkend="gjs"/>,
177 <xref linkend="gvfs"/> (to access the online help),
178 <xref linkend="libjxl"/>,
179 <xref linkend="libmng"/>,
180 <xref linkend="libunwind"/>,
181 <xref linkend="libwebp"/>,
182 <xref linkend="lua"/>,
183 <xref linkend="openjpeg2"/>,
184 <xref linkend="gtk-doc"/>,
185 <ulink url="https://github.com/HEASARC/cfitsio">cfitsio</ulink>,
186 <ulink url="https://github.com/ianlancetaylor/libbacktrace">libbacktrace</ulink>,
187 <ulink url="https://github.com/svanderburg/libiff">libiff</ulink>,
188 <ulink url="https://github.com/svanderburg/libilbm">libilbm</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>,
193 <ulink url="https://www.openexr.com/">OpenEXR</ulink>, and
194 <ulink url="https://github.com/phoboslab/qoi">qoi</ulink>
195 </para>
196
197 <bridgehead renderas="sect4">Optional, for building the help system</bridgehead>
198 <para role="optional">
199 <ulink url="https://dblatex.sourceforge.net/">dblatex</ulink> (for PDF docs),
200 <ulink url="https://pngnq.sourceforge.net/">pngnq</ulink> and
201 <ulink url="https://pmt.sourceforge.net/pngcrush/">pngcrush</ulink>
202 to optimize the png files, but see the note on the help download above
203 </para>
204
205 <para condition="html" role="usernotes">Editor Notes:
206 <ulink url="&blfs-wiki;/gimp"/>
207 </para>
208 </sect2>
209
210 <sect2 role="installation">
211 <title>Installation of Gimp</title>
212
213 <para>
214 Install <application>Gimp</application> by running
215 the following commands:
216 </para>
217
218<screen><userinput>mkdir gimp-build &amp;&amp;
219cd gimp-build &amp;&amp;
220
221meson setup --prefix=/usr --buildtype=release .. &amp;&amp;
222ninja</userinput></screen>
223
224 <para>
225 To test the results (requires an X-Windowed terminal) issue:
226 <command>ninja test</command>.
227 <!-- km: in 2.10.16 no failures, 2 tests were skipped -->
228
229 </para>
230
231 <para>
232 Now, as the &root; user:
233 </para>
234
235<screen role="root"><userinput>ninja test</userinput></screen>
236
237 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
238 href="../../xincludes/update-icons-and-desktop.xml"/>
239
240 </sect2>
241
242 <sect2 role="installation">
243 <title>Installation of Gimp-Help</title>
244
245 <para>
246 The <filename>gimp-help</filename> tarball contains images and English
247 text help for help files, together with translations.
248 If you wish to install local copies of the help files to read offline,
249 unpack the gimp-help tarball and change into the root of the newly
250 created source tree.
251
252 <!--
253 The documentation generated by gimp-help-2.10.34 and online help have
254 the same contents, so I comment this out. [pierre Nov. 2023]
255 Because of the
256 issues mentioned in the note above, you are recommended to use the online
257 help, either by building against <xref linkend="gvfs"/> so that 'help'
258 can open the latest XML files in your browser, or else you can manually
259 open the html in your browser by going to <ulink
260 url="https://docs.gimp.org/2.10/en/">https://docs.gimp.org/2.10/en</ulink>
261 (change the language code if desired).-->
262 </para>
263
264<screen><userinput>tar -xf ../../gimp3-help-&gimp-version;.tar.xz &amp;&amp;
265cd gimp3-help-&gimp-version;
266
267ALL_LINGUAS=&quot;ca cs da de en en_GB es fa fr hr ko lt nl nn pt pt_BR ro sl sv uk zh_CN&quot; \
268./configure --prefix=/usr</userinput></screen>
269
270 <para>
271 Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
272 you do not wish to install. Alternatively, remove the line starting with
273 <envar>ALL_LINGUAS</envar>, if you wish to build all languages.
274 </para>
275
276 <para>
277 Now build the help files:
278 </para>
279
280<screen><userinput>make</userinput></screen>
281
282 <para>
283 Issue the following commands as the &root; user to install the help files:
284 </para>
285
286<screen role="root"><userinput>make install &amp;&amp;
287chown -R root:root /usr/share/gimp/3.0/help</userinput></screen>
288
289 </sect2>
290
291 <sect2 role="commands" id="gimp-cmd-explanations">
292 <title>Command Explanations</title>
293
294 <para>
295 <envar>ALL_LINGUAS=&quot;ca cs da de en en_GB es fa...&quot;</envar>: by
296 default, the help files will be rendered in all the available languages.
297 Remove the codes of any languages you do not wish to build.
298 </para>
299
300 <para>
301 <parameter>--disable-python</parameter>: This option is necessary if
302 you have not installed <application>PyGTK</application>.
303 </para>
304
305 </sect2>
306
307 <sect2 role="configuration">
308 <title>Configuring The Gimp</title>
309
310 <sect3 id="gimp-config">
311 <title>Config Files</title>
312
313 <para>
314 <filename>/etc/gimp/3.0/*</filename>
315 </para>
316
317 <indexterm zone="gimp gimp-config">
318 <primary sortas="e-etc-gimp-3.0-star">/etc/gimp/3.0/*</primary>
319 </indexterm>
320
321 </sect3>
322
323 </sect2>
324
325 <sect2 role="content">
326 <title>Contents</title>
327
328 <segmentedlist>
329 <segtitle>Installed Programs</segtitle>
330 <segtitle>Installed Libraries</segtitle>
331 <segtitle>Installed Directories</segtitle>
332
333 <seglistitem>
334 <seg>
335 gimp-2.99,
336 gimp-console-2.99,
337 gimptool-2.99,
338 gimp-test-clipboard-2.99, and
339 gimp-script-fu-interpreter-3.0
340 </seg>
341 <seg>
342 libgimp-3.0.so,
343 libgimp-scriptfu-3.0,
344 libgimpbase-3.0.so,
345 libgimpcolor-3.0.so,
346 libgimpconfig-3.0.so,
347 libgimpmath-3.0.so,
348 libgimpmodule-3.0.so,
349 libgimpui-3.0.so, and
350 libgimpwidgets-3.0.so
351 </seg>
352 <seg>
353 /etc/gimp,
354 /usr/include/gimp-3.0,
355 /usr/lib/gimp-3.0,
356 /usr/lib/gimp/3.0,
357 /usr/share/gimp/3.0, and
358 /usr/share/doc/gimp-2.99
359 </seg>
360 </seglistitem>
361 </segmentedlist>
362
363 <variablelist>
364 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
365 <?dbfo list-presentation="list"?>
366 <?dbhtml list-presentation="table"?>
367
368 <varlistentry id="gimp-2.99">
369 <term><command>gimp-2.99</command></term>
370 <listitem>
371 <para>
372 is the Gnu Image Manipulation Program. It works with a variety
373 of image formats and provides a large selection of tools
374 </para>
375 <indexterm zone="gimp gimp-2.99">
376 <primary sortas="b-gimp-2.99">gimp-2.99</primary>
377 </indexterm>
378 </listitem>
379 </varlistentry>
380
381 <varlistentry id="gimp-console-2.99">
382 <term><command>gimp-console-2.99</command></term>
383 <listitem>
384 <para>
385 is a console program that behaves as if The
386 <application>Gimp</application> was called with the
387 <option>--no-interface</option> command-line option
388 </para>
389 <indexterm zone="gimp gimp-console-2.99">
390 <primary sortas="b-gimp-console-2.99">gimp-console-2.99</primary>
391 </indexterm>
392 </listitem>
393 </varlistentry>
394
395 <varlistentry id="gimptool-2.99">
396 <term><command>gimptool-2.99</command></term>
397 <listitem>
398 <para>
399 is a tool that can build plug-ins or scripts and install them
400 if they are distributed in one source file.
401 <command>gimptool-2.99</command> can also be used by programs that
402 need to know what libraries and include-paths The
403 <application>Gimp</application> was compiled with
404 </para>
405 <indexterm zone="gimp gimptool-2.99">
406 <primary sortas="b-gimptool-2.99">gimptool-2.99</primary>
407 </indexterm>
408 </listitem>
409 </varlistentry>
410
411 <varlistentry id="libgimp-3.0">
412 <term><filename class="libraryfile">libgimp-3.0.so</filename></term>
413 <listitem>
414 <para>
415 provides C bindings for The <application>Gimp</application>'s
416 Procedural Database (PDB) which offers an interface to core functions
417 and to functionality provided by plug-ins
418 </para>
419 <indexterm zone="gimp libgimp-3.0">
420 <primary sortas="c-libgimp-3.0">libgimp-3.0.so</primary>
421 </indexterm>
422 </listitem>
423 </varlistentry>
424
425 <varlistentry id="libgimpbase-3.0">
426 <term><filename class="libraryfile">libgimpbase-3.0.so</filename></term>
427 <listitem>
428 <para>
429 provides the C functions for basic
430 <application>Gimp</application> functionality such as determining
431 enumeration data types, gettext translation, determining The
432 <application>Gimp</application>'s version number and capabilities,
433 handling data files and accessing the environment
434 </para>
435 <indexterm zone="gimp libgimpbase-3.0">
436 <primary sortas="c-libgimpbase-3.0">libgimpbase-3.0.so</primary>
437 </indexterm>
438 </listitem>
439 </varlistentry>
440
441 <varlistentry id="libgimpcolor-3.0">
442 <term><filename class="libraryfile">libgimpcolor-3.0.so</filename></term>
443 <listitem>
444 <para>
445 provides the C functions relating to RGB, HSV and CMYK colors as
446 well as converting colors between different color models and
447 performing adaptive supersampling on an area
448 </para>
449 <indexterm zone="gimp libgimpcolor-3.0">
450 <primary sortas="c-libgimpcolor-3.0">libgimpcolor-3.0.so</primary>
451 </indexterm>
452 </listitem>
453 </varlistentry>
454
455 <varlistentry id="libgimpconfig-3.0">
456 <term><filename class="libraryfile">libgimpconfig-3.0.so</filename></term>
457 <listitem>
458 <para>
459 contains C functions for reading and writing config information
460 </para>
461 <indexterm zone="gimp libgimpconfig-3.0">
462 <primary sortas="c-libgimpconfig-3.0">libgimpconfig-3.0.so</primary>
463 </indexterm>
464 </listitem>
465 </varlistentry>
466
467 <varlistentry id="libgimpmath-3.0">
468 <term><filename class="libraryfile">libgimpmath-3.0.so</filename></term>
469 <listitem>
470 <para>
471 contains C functions which provide mathematical definitions and
472 macros, manipulate 3x3 transformation matrices, set up and manipulate
473 vectors and the MD5 message-digest algorithm
474 </para>
475 <indexterm zone="gimp libgimpmath-3.0">
476 <primary sortas="c-libgimpmath-3.0">libgimpmath-3.0.so</primary>
477 </indexterm>
478 </listitem>
479 </varlistentry>
480
481 <varlistentry id="libgimpmodule-3.0">
482 <term><filename class="libraryfile">libgimpmodule-3.0.so</filename></term>
483 <listitem>
484 <para>
485 provides the C functions which implement module loading using
486 GModule and supports keeping a list of GimpModule's found in a given
487 searchpath
488 </para>
489 <indexterm zone="gimp libgimpmodule-3.0">
490 <primary sortas="c-libgimpmodule-3.0">libgimpmodule-2.0.so</primary>
491 </indexterm>
492 </listitem>
493 </varlistentry>
494
495 <varlistentry id="libgimpthumb-3.0">
496 <term><filename class="libraryfile">libgimpthumb-3.0.so</filename></term>
497 <listitem>
498 <para>
499 provides the C functions for handling The
500 <application>Gimp</application>'s thumbnail objects
501 </para>
502 <indexterm zone="gimp libgimpthumb-3.0">
503 <primary sortas="c-libgimpthumb-3.0">libgimpthumb-3.0.so</primary>
504 </indexterm>
505 </listitem>
506 </varlistentry>
507
508 <varlistentry id="libgimpui-3.0">
509 <term><filename class="libraryfile">libgimpui-3.0.so</filename></term>
510 <listitem>
511 <para>
512 contains The <application>Gimp</application>'s common user
513 interface functions
514 </para>
515 <indexterm zone="gimp libgimpui-3.0">
516 <primary sortas="c-libgimpui-3.0">libgimpui-3.0.so</primary>
517 </indexterm>
518 </listitem>
519 </varlistentry>
520
521 <varlistentry id="libgimpwidgets-3.0">
522 <term><filename class="libraryfile">libgimpwidgets-3.0.so</filename></term>
523 <listitem>
524 <para>
525 contains The <application>Gimp</application>
526 and <application>GTK</application>'s widget creation and
527 manipulation functions
528 </para>
529 <indexterm zone="gimp libgimpwidgets-3.0">
530 <primary sortas="c-libgimpwidgets-3.0">libgimpwidgets-3.0.so</primary>
531 </indexterm>
532 </listitem>
533 </varlistentry>
534
535 </variablelist>
536
537 </sect2>
538
539</sect1>
Note: See TracBrowser for help on using the repository browser.