source: xsoft/other/gimp.xml@ 6ad5d0f

10.0 10.1 11.0 8.4 9.0 9.1 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 6ad5d0f was 6ad5d0f, checked in by Douglas R. Reno <renodr@…>, 3 years ago

Tags for the rest of the printing stack

Avahi: Remove obsolete systemctl enable command. DNSCONFD is enabled by default by make install.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21191 af4574ff-66df-0310-9fd7-8a98e5e911e0

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