source: xsoft/other/gimp.xml@ fa3dc9c

12.2 gimp3 lazarus trunk xry111/for-12.3 xry111/spidermonkey128
Last change on this file since fa3dc9c was fa3dc9c, checked in by Bruce Dubbs <bdubbs@…>, 2 months ago

Initial gimp3 page and restore appstream-glib

  • Property mode set to 100644
File size: 19.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 "https://anduin.linuxfromscratch.org/BLFS/gimp/gimp3-&gimp-version;.tar.xz">
8 <!ENTITY gimp-download-ftp " ">
9 <!ENTITY gimp-md5sum "9080dd305a66974d430f23761b9d0197">
10 <!ENTITY gimp-size "639 MB">
11 <!ENTITY gimp-buildsize "1.1 GB (197 MB installed)">
12 <!ENTITY gimp-time "0.5 SBU (Using parallelism=28)">
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/gimp-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 "5e393d61c802e73ffe6c550759ed0853">
36 <!ENTITY gimp-help-size "158 MB">
37 <!ENTITY gimp-help-buildsize "From 412 MB (en only) to 1.8 GB (for all
38 languages)">
39 <!ENTITY gimp-help-time "2.1 SBU (en only), 13 SBU, with parallelism=4,
40 for all languages">
41]>
42
43<sect1 id="gimp" xreflabel="gimp-&gimp-version;">
44 <?dbhtml filename="gimp.html" ?>
45
46
47 <title>Gimp-&gimp-version;</title>
48
49 <indexterm zone="gimp">
50 <primary sortas="a-gimp">gimp</primary>
51 </indexterm>
52
53 <sect2 role="package">
54 <title>Introduction to Gimp</title>
55
56 <para>
57 The <application>Gimp</application> package contains
58 the GNU Image Manipulation Program which is useful for
59 photo retouching, image composition, and image authoring.
60 </para>
61
62 &lfs121_checked;
63
64 <bridgehead renderas="sect3">Package Information</bridgehead>
65 <itemizedlist spacing="compact">
66 <listitem>
67 <para>
68 Download (HTTP): <ulink url="&gimp-download-http;"/>
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Download (FTP): <ulink url="&gimp-download-ftp;"/>
74 </para>
75 </listitem>
76 <listitem>
77 <para>
78 Download MD5 sum: &gimp-md5sum;
79 </para>
80 </listitem>
81 <listitem>
82 <para>
83 Download size: &gimp-size;
84 </para>
85 </listitem>
86 <listitem>
87 <para>
88 Estimated disk space required: &gimp-buildsize;
89 </para>
90 </listitem>
91 <listitem>
92 <para>
93 Estimated build time: &gimp-time;
94 </para>
95 </listitem>
96 </itemizedlist>
97
98 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
99<!--
100 <note>
101 <para>
102 The creation of local html files with recent versions of the necessary
103 packages is somewhat broken (some png images are not sourced by the
104 generated HTML, only their captions are visible).
105 </para>
106 </note>
107-->
108<!--
109 <note>
110 <para>
111 The help files English version is complete, but large
112 parts of the text for many other languages are not yet translated.
113 </para>
114 </note>
115
116
117 <itemizedlist spacing="compact">
118 <listitem>
119 <para>
120 Download (HTTP): <ulink url="&gimp-help-download;"/>
121 </para>
122 </listitem>
123 <listitem>
124 <para>
125 Download size: &gimp-help-size;
126 </para>
127 </listitem>
128 <listitem>
129 <para>
130 Download MD5 sum: &gimp-help-md5sum;
131 </para>
132 </listitem>
133 <listitem>
134 <para>
135 Estimated disk space required: &gimp-help-buildsize;
136 </para>
137 </listitem>
138 <listitem>
139 <para>
140 Estimated build time: &gimp-help-time;
141 </para>
142 </listitem>
143 </itemizedlist>
144-->
145 <bridgehead renderas="sect3">Gimp Dependencies</bridgehead>
146
147 <bridgehead renderas="sect4">Required</bridgehead>
148 <para role="required">
149 <xref linkend="appstream-glib"/>,
150 <xref linkend="gegl"/>,
151 <xref linkend="gexiv2"/>,
152 <xref linkend="glib-networking"/>,
153 <xref linkend="gtk3"/>,
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="libxml2"/> (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="graphviz"/>,
172 <xref linkend="gs"/> (with libgs installed),
173 <xref linkend="iso-codes"/>,
174 <xref linkend="libgudev"/>, 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="libunwind"/>,
185 <xref linkend="libwebp"/>,
186 <xref linkend="openjpeg2"/>,
187 <xref linkend="pygtk"/> (including the gtk, pango and pangocairo modules),
188 an <xref linkend="server-mail"/> (that provides a
189 <command>sendmail</command> program),
190 <xref linkend="gtk-doc"/>,
191<!-- <ulink url="https://people.freedesktop.org/~hughsient/appstream-glib">appstream-glib</ulink>,-->
192 <ulink url="https://github.com/ianlancetaylor/libbacktrace">libbacktrace</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>, and
197 <ulink url="https://www.openexr.com/">OpenEXR</ulink>
198 </para>
199
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 </sect2>
210
211 <sect2 role="installation">
212 <title>Installation of Gimp</title>
213
214 <para>
215 Install <application>Gimp</application> by running
216 the following commands:
217 </para>
218
219<screen><userinput>mkdir gimp-build &amp;&amp;
220cd gimp-build &amp;&amp;
221
222meson setup --prefix=/usr --buildtype=release .. &amp;&amp;
223ninja</userinput></screen>
224
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 &root; user:
235 </para>
236
237<screen role="root"><userinput>ninja install</userinput></screen>
238
239 </sect2>
240
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 The documentation generated by gimp-help-2.10.34 and online help have
249 the same contents, so I comment this out. [pierre Nov. 2023]
250 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, u--><!--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 cs da de en en_GB es fa fr hr ko lt nl nn pt pt_BR ro sl sv uk zh_CN&quot; \
267./configure - -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<!--
291 </sect2>
292 <sect2 role="commands" id="gimp-cmd-explanations">
293 <title>Command Explanations</title>
294
295 <para>
296 <envar>ALL_LINGUAS=&quot;ca cs da de en en_GB es fa...&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 <parameter>- -disable-python</parameter>: 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.