source: xsoft/other/gimp.xml@ 81d6733

12.2 lazarus trunk xry111/for-12.3
Last change on this file since 81d6733 was 81d6733, checked in by Bruce Dubbs <bdubbs@…>, 6 weeks ago

Really install gimp.

  • Property mode set to 100644
File size: 18.3 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="gtk3"/>,
151 <xref linkend="harfbuzz"/>,
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 role='runtime' linkend="gvfs"/> and
167 <xref role='runtime' linkend='glib-networking'/>
168 (both runtime, to access the online help, open images from a HTTP
169 or HTTPS URL, drag and drop images from an external application,
170 etc.),
171 <xref linkend="iso-codes"/>,
172 <xref linkend="libgudev"/>,
173 <xref linkend="pygobject3"/>, and
174 <xref linkend="xdg-utils"/>
175 </para>
176
177 <bridgehead renderas="sect4">Optional</bridgehead>
178 <para role="optional">
179 <xref linkend="aalib"/>,
180 <xref linkend="alsa-lib"/>,
181 <xref linkend="gjs"/>,
182 <xref linkend="libjxl"/>,
183 <xref linkend="libmng"/>,
184 <xref linkend="libunwind"/>,
185 <xref linkend="libwebp"/>,
186 <xref linkend="lua"/>,
187 <xref linkend="openjpeg2"/>,
188 <xref linkend="gtk-doc"/>,
189 <ulink url="https://github.com/HEASARC/cfitsio">cfitsio</ulink>,
190 <ulink url="https://github.com/ianlancetaylor/libbacktrace">libbacktrace</ulink>,
191 <ulink url="https://github.com/svanderburg/libiff">libiff</ulink>,
192 <ulink url="https://github.com/svanderburg/libilbm">libilbm</ulink>,
193 <ulink url="https://github.com/strukturag/libheif/">libheif</ulink> with
194 <ulink url="https://github.com/strukturag/libde265/">libde265</ulink>
195 (both needed to read macOS heic images),
196 <ulink url="https://wvware.sourceforge.net/libwmf.html">libwmf</ulink>,
197 <ulink url="https://www.openexr.com/">OpenEXR</ulink>, and
198 <ulink url="https://github.com/phoboslab/qoi">qoi</ulink>
199 </para>
200
201 <bridgehead renderas="sect4">Optional, for building the help system</bridgehead>
202 <para role="optional">
203 <ulink url="https://dblatex.sourceforge.net/">dblatex</ulink> (for PDF docs),
204 <ulink url="https://pngnq.sourceforge.net/">pngnq</ulink> and
205 <ulink url="https://pmt.sourceforge.net/pngcrush/">pngcrush</ulink>
206 to optimize the png files, but see the note on the help download above
207 </para>
208
209 <para condition="html" role="usernotes">Editor Notes:
210 <ulink url="&blfs-wiki;/gimp"/>
211 </para>
212 </sect2>
213
214 <sect2 role="installation">
215 <title>Installation of Gimp</title>
216
217 <para>
218 Install <application>Gimp</application> by running
219 the following commands:
220 </para>
221
222<screen><userinput>mkdir gimp-build &amp;&amp;
223cd gimp-build &amp;&amp;
224
225meson setup --prefix=/usr --buildtype=release .. &amp;&amp;
226ninja</userinput></screen>
227
228 <para>
229 To test the results (requires an X-Windowed terminal) issue:
230 <command>ninja test</command>.
231 <!-- km: in 2.10.16 no failures, 2 tests were skipped -->
232
233 </para>
234
235 <para>
236 Now, as the &root; user:
237 </para>
238
239<screen role="root"><userinput>ninja install</userinput></screen>
240
241 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
242 href="../../xincludes/update-icons-and-desktop.xml"/>
243
244 </sect2>
245
246 <sect2 role="installation">
247 <title>Installation of Gimp-Help</title>
248
249 <para>
250 The <filename>gimp-help</filename> tarball contains images and English
251 text help for help files, together with translations.
252 If you wish to install local copies of the help files to read offline,
253 unpack the gimp-help tarball and change into the root of the newly
254 created source tree.
255
256 <!--
257 The documentation generated by gimp-help-2.10.34 and online help have
258 the same contents, so I comment this out. [pierre Nov. 2023]
259 Because of the
260 issues mentioned in the note above, you are recommended to use the online
261 help, either by building against <xref linkend="gvfs"/> so that 'help'
262 can open the latest XML files in your browser, or else you can manually
263 open the html in your browser by going to <ulink
264 url="https://docs.gimp.org/2.10/en/">https://docs.gimp.org/2.10/en</ulink>
265 (change the language code if desired).-->
266 </para>
267
268<screen><userinput>tar -xf ../../gimp3-help-&gimp-version;.tar.xz &amp;&amp;
269cd gimp3-help-&gimp-version;
270
271ALL_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; \
272./configure --prefix=/usr</userinput></screen>
273
274 <para>
275 Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
276 you do not wish to install. Alternatively, remove the line starting with
277 <envar>ALL_LINGUAS</envar>, if you wish to build all languages.
278 </para>
279
280 <para>
281 Now build the help files:
282 </para>
283
284<screen><userinput>make</userinput></screen>
285
286 <para>
287 Issue the following commands as the &root; user to install the help files:
288 </para>
289
290<screen role="root"><userinput>make install &amp;&amp;
291chown -R root:root /usr/share/gimp/3.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 cs da de en en_GB es fa...&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 <parameter>--disable-python</parameter>: This option is necessary if
306 you have not installed <application>PyGTK</application>.
307 </para>
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/3.0/*</filename>
319 </para>
320
321 <indexterm zone="gimp gimp-config">
322 <primary sortas="e-etc-gimp-3.0-star">/etc/gimp/3.0/*</primary>
323 </indexterm>
324
325 </sect3>
326
327 </sect2>
328
329 <sect2 role="content">
330 <title>Contents</title>
331
332 <segmentedlist>
333 <segtitle>Installed Programs</segtitle>
334 <segtitle>Installed Libraries</segtitle>
335 <segtitle>Installed Directories</segtitle>
336
337 <seglistitem>
338 <seg>
339 gimp-2.99,
340 gimp-console-2.99,
341 gimptool-2.99,
342 gimp-test-clipboard-2.99, and
343 gimp-script-fu-interpreter-3.0
344 </seg>
345 <seg>
346 libgimp-3.0.so,
347 libgimp-scriptfu-3.0,
348 libgimpbase-3.0.so,
349 libgimpcolor-3.0.so,
350 libgimpconfig-3.0.so,
351 libgimpmath-3.0.so,
352 libgimpmodule-3.0.so,
353 libgimpui-3.0.so, and
354 libgimpwidgets-3.0.so
355 </seg>
356 <seg>
357 /etc/gimp,
358 /usr/include/gimp-3.0,
359 /usr/lib/gimp-3.0,
360 /usr/lib/gimp/3.0,
361 /usr/share/gimp/3.0, and
362 /usr/share/doc/gimp-2.99
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-2.99">
373 <term><command>gimp-2.99</command></term>
374 <listitem>
375 <para>
376 is the Gnu Image Manipulation Program. It works with a variety
377 of image formats and provides a large selection of tools
378 </para>
379 <indexterm zone="gimp gimp-2.99">
380 <primary sortas="b-gimp-2.99">gimp-2.99</primary>
381 </indexterm>
382 </listitem>
383 </varlistentry>
384
385 <varlistentry id="gimp-console-2.99">
386 <term><command>gimp-console-2.99</command></term>
387 <listitem>
388 <para>
389 is a console program that behaves as if The
390 <application>Gimp</application> was called with the
391 <option>--no-interface</option> command-line option
392 </para>
393 <indexterm zone="gimp gimp-console-2.99">
394 <primary sortas="b-gimp-console-2.99">gimp-console-2.99</primary>
395 </indexterm>
396 </listitem>
397 </varlistentry>
398
399 <varlistentry id="gimptool-2.99">
400 <term><command>gimptool-2.99</command></term>
401 <listitem>
402 <para>
403 is a tool that can build plug-ins or scripts and install them
404 if they are distributed in one source file.
405 <command>gimptool-2.99</command> can also be used by programs that
406 need to know what libraries and include-paths The
407 <application>Gimp</application> was compiled with
408 </para>
409 <indexterm zone="gimp gimptool-2.99">
410 <primary sortas="b-gimptool-2.99">gimptool-2.99</primary>
411 </indexterm>
412 </listitem>
413 </varlistentry>
414
415 <varlistentry id="libgimp-3.0">
416 <term><filename class="libraryfile">libgimp-3.0.so</filename></term>
417 <listitem>
418 <para>
419 provides C bindings for The <application>Gimp</application>'s
420 Procedural Database (PDB) which offers an interface to core functions
421 and to functionality provided by plug-ins
422 </para>
423 <indexterm zone="gimp libgimp-3.0">
424 <primary sortas="c-libgimp-3.0">libgimp-3.0.so</primary>
425 </indexterm>
426 </listitem>
427 </varlistentry>
428
429 <varlistentry id="libgimpbase-3.0">
430 <term><filename class="libraryfile">libgimpbase-3.0.so</filename></term>
431 <listitem>
432 <para>
433 provides the C functions for basic
434 <application>Gimp</application> functionality such as determining
435 enumeration data types, gettext translation, determining The
436 <application>Gimp</application>'s version number and capabilities,
437 handling data files and accessing the environment
438 </para>
439 <indexterm zone="gimp libgimpbase-3.0">
440 <primary sortas="c-libgimpbase-3.0">libgimpbase-3.0.so</primary>
441 </indexterm>
442 </listitem>
443 </varlistentry>
444
445 <varlistentry id="libgimpcolor-3.0">
446 <term><filename class="libraryfile">libgimpcolor-3.0.so</filename></term>
447 <listitem>
448 <para>
449 provides the C functions relating to RGB, HSV and CMYK colors as
450 well as converting colors between different color models and
451 performing adaptive supersampling on an area
452 </para>
453 <indexterm zone="gimp libgimpcolor-3.0">
454 <primary sortas="c-libgimpcolor-3.0">libgimpcolor-3.0.so</primary>
455 </indexterm>
456 </listitem>
457 </varlistentry>
458
459 <varlistentry id="libgimpconfig-3.0">
460 <term><filename class="libraryfile">libgimpconfig-3.0.so</filename></term>
461 <listitem>
462 <para>
463 contains C functions for reading and writing config information
464 </para>
465 <indexterm zone="gimp libgimpconfig-3.0">
466 <primary sortas="c-libgimpconfig-3.0">libgimpconfig-3.0.so</primary>
467 </indexterm>
468 </listitem>
469 </varlistentry>
470
471 <varlistentry id="libgimpmath-3.0">
472 <term><filename class="libraryfile">libgimpmath-3.0.so</filename></term>
473 <listitem>
474 <para>
475 contains C functions which provide mathematical definitions and
476 macros, manipulate 3x3 transformation matrices, set up and manipulate
477 vectors and the MD5 message-digest algorithm
478 </para>
479 <indexterm zone="gimp libgimpmath-3.0">
480 <primary sortas="c-libgimpmath-3.0">libgimpmath-3.0.so</primary>
481 </indexterm>
482 </listitem>
483 </varlistentry>
484
485 <varlistentry id="libgimpmodule-3.0">
486 <term><filename class="libraryfile">libgimpmodule-3.0.so</filename></term>
487 <listitem>
488 <para>
489 provides the C functions which implement module loading using
490 GModule and supports keeping a list of GimpModule's found in a given
491 searchpath
492 </para>
493 <indexterm zone="gimp libgimpmodule-3.0">
494 <primary sortas="c-libgimpmodule-3.0">libgimpmodule-2.0.so</primary>
495 </indexterm>
496 </listitem>
497 </varlistentry>
498
499 <varlistentry id="libgimpthumb-3.0">
500 <term><filename class="libraryfile">libgimpthumb-3.0.so</filename></term>
501 <listitem>
502 <para>
503 provides the C functions for handling The
504 <application>Gimp</application>'s thumbnail objects
505 </para>
506 <indexterm zone="gimp libgimpthumb-3.0">
507 <primary sortas="c-libgimpthumb-3.0">libgimpthumb-3.0.so</primary>
508 </indexterm>
509 </listitem>
510 </varlistentry>
511
512 <varlistentry id="libgimpui-3.0">
513 <term><filename class="libraryfile">libgimpui-3.0.so</filename></term>
514 <listitem>
515 <para>
516 contains The <application>Gimp</application>'s common user
517 interface functions
518 </para>
519 <indexterm zone="gimp libgimpui-3.0">
520 <primary sortas="c-libgimpui-3.0">libgimpui-3.0.so</primary>
521 </indexterm>
522 </listitem>
523 </varlistentry>
524
525 <varlistentry id="libgimpwidgets-3.0">
526 <term><filename class="libraryfile">libgimpwidgets-3.0.so</filename></term>
527 <listitem>
528 <para>
529 contains The <application>Gimp</application>
530 and <application>GTK</application>'s widget creation and
531 manipulation functions
532 </para>
533 <indexterm zone="gimp libgimpwidgets-3.0">
534 <primary sortas="c-libgimpwidgets-3.0">libgimpwidgets-3.0.so</primary>
535 </indexterm>
536 </listitem>
537 </varlistentry>
538
539 </variablelist>
540
541 </sect2>
542
543</sect1>
Note: See TracBrowser for help on using the repository browser.