source: xsoft/other/gimp-systemd.xml@ 64135787

kde5-14269
Last change on this file since 64135787 was 64135787, checked in by Xi Ruoyao <xry111@…>, 3 years ago

Begin manually (while modifying stuff) merging trunk and systemd branches since revision 14087.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/kde5@14270 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 19.6 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 "http://download.gimp.org/pub/gimp/v2.8/gimp-&gimp-version;.tar.bz2">
8 <!ENTITY gimp-download-ftp " ">
9 <!ENTITY gimp-md5sum "233c948203383fa078434cc3f8f925cb">
10 <!ENTITY gimp-size "20 MB">
11 <!ENTITY gimp-buildsize "642 MB (additional 553 MB to run the test suite,
12 the help files add from 288 MB (en only) to 1.3
13 GB (all 18 languages), typically increasing by
14 54 MB per translation)">
15 <!ENTITY gimp-time "4.2 SBU (additional 0.9 SBU to run the test
16 suite, for the help files from 0.6 SBU (en only)
17 to 19 SBU (all) - typically 1.3 SBU
18 per translation)">
19
20 <!ENTITY gimp-help-version "2.8.2">
21 <!ENTITY gimp-help-download "http://download.gimp.org/pub/gimp/help/gimp-help-&gimp-help-version;.tar.bz2">
22 <!ENTITY gimp-help-md5sum "a591c8974b2f4f584d0a769d52ed6c5b">
23 <!ENTITY gimp-help-size "152 MB">
24]>
25
26<sect1 id="gimp" xreflabel="Gimp-&gimp-version;">
27 <?dbhtml filename="gimp.html" ?>
28
29 <sect1info>
30 <othername>$LastChangedBy$</othername>
31 <date>$Date$</date>
32 </sect1info>
33
34 <title>Gimp-&gimp-version;</title>
35
36 <indexterm zone="gimp">
37 <primary sortas="a-Gimp">Gimp</primary>
38 </indexterm>
39
40 <sect2 role="package">
41 <title>Introduction to Gimp</title>
42
43 <para>
44 The <application>Gimp</application> package contains
45 the GNU Image Manipulation Program which is useful for
46 photo retouching, image composition and image authoring.
47 </para>
48
49 &lfs76_checked;
50
51 <bridgehead renderas="sect3">Package Information</bridgehead>
52 <itemizedlist spacing="compact">
53 <listitem>
54 <para>
55 Download (HTTP): <ulink url="&gimp-download-http;"/>
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download (FTP): <ulink url="&gimp-download-ftp;"/>
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download MD5 sum: &gimp-md5sum;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Download size: &gimp-size;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Estimated disk space required: &gimp-buildsize;
76 </para>
77 </listitem>
78 <listitem>
79 <para>
80 Estimated build time: &gimp-time;
81 </para>
82 </listitem>
83 </itemizedlist>
84
85 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
86 <itemizedlist spacing="compact">
87 <listitem>
88 <para>
89 Optional help files: <ulink url="&gimp-help-download;"/>
90 </para>
91 </listitem>
92 <listitem>
93 <para>
94 Download MD5 sum: &gimp-help-md5sum;
95 </para>
96 </listitem>
97 <listitem>
98 <para>
99 Download size: &gimp-help-size;
100 </para>
101 </listitem>
102 <listitem>
103 <para>
104 Optional patch:
105 <ulink url="&patch-root;/gimp-&gimp-version;-device_info-1.patch"/>
106 </para>
107 </listitem>
108<!-- <listitem>
109 <para>
110 Compressed Patch MD5 sum: 5312793a67132131a6e3360e76f392e4
111 </para>
112 </listitem>
113 <listitem>
114 <para>
115 Compressed Patch size: 486 KB
116 </para>
117 </listitem> -->
118 </itemizedlist>
119
120 <bridgehead renderas="sect3">Gimp Dependencies</bridgehead>
121
122 <bridgehead renderas="sect4">Required</bridgehead>
123 <para role="required">
124 <xref linkend="gegl"/> and
125 <xref linkend="gtk2"/>
126 </para>
127
128 <bridgehead renderas="sect4">Recommended</bridgehead>
129 <para role="recommended">
130 <xref linkend="pygtk"/> (including the gtk and pango modules)
131 </para>
132
133 <bridgehead renderas="sect4">Optional</bridgehead>
134 <para role="optional">
135 <xref linkend="aalib"/>,
136 <xref linkend="alsa-lib"/>,
137 <xref linkend="curl"/>,
138 <xref linkend="dbus-glib"/>,
139 <xref linkend="gs"/> (with libgs installed),
140 <xref linkend="gtk-doc"/>,
141 <xref linkend="gvfs"/>,
142 <xref linkend="iso-codes"/>,
143 <xref linkend="jasper"/>,
144 <xref linkend="lcms"/> or <xref linkend="lcms2"/>,
145 <xref linkend="libexif"/>,
146 <xref linkend="libmng"/>,
147 <xref linkend="librsvg"/>,
148 <ulink url="http://wvware.sourceforge.net/libwmf.html">libwmf</ulink>,
149 <xref linkend="poppler"/>,
150 an <xref linkend="server-mail"/> (that provides a
151 <command>sendmail</command> program),
152 <xref linkend="systemd"/> (for GUdev), and
153 <xref linkend="webkitgtk2"/> (Compiled against GTK+ 2, required for the help-plugin)
154 </para>
155
156 <bridgehead renderas="sect4">Optional, for optimizing the PNG files in the
157 help system</bridgehead>
158 <para role="optional">
159 <ulink url="http://pngnq.sourceforge.net/">pngnq</ulink> and
160 <ulink url="http://pmt.sourceforge.net/pngcrush/">pngcrush</ulink>
161 </para>
162
163 <para condition="html" role="usernotes">User Notes:
164 <ulink url="&blfs-wiki;/gimp"/>
165 </para>
166 </sect2>
167
168 <sect2 role="installation">
169 <title>Installation of Gimp</title>
170
171 <para>
172 In order to get rid of an annoying message when running from a terminal
173 and/or if you wish to run the test suite, optionally use the
174 following patch:
175 </para>
176
177<screen><userinput>patch -Np1 -i ../gimp-&gimp-version;-device_info-1.patch</userinput></screen>
178
179 <para>
180 Install <application>Gimp</application> by running
181 the following commands:
182 </para>
183
184<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc --without-gvfs &amp;&amp;
185make</userinput></screen>
186
187 <para>
188 To test the results (requires an X-Windowed terminal) issue:
189 <command>make check</command>.
190 </para>
191
192 <para>
193 Now, as the <systemitem class="username">root</systemitem>
194 user:
195 </para>
196
197<screen role="root"><userinput>make install</userinput></screen>
198
199 <para>
200 The <filename>gimp-help</filename> tarball contains images and English
201 text help for help files, together with translations. It is
202 &quot;work in progress&quot;.
203 </para>
204
205 <para>
206 If you downloaded the <filename>gimp-help</filename> tarball, unpack
207 it and change into the root of the newly created source tree. Prepare for
208 the build with the following command:
209 </para>
210
211<screen><userinput>ALL_LINGUAS=&quot;ca da de el en en_GB es fr it ja ko nl nn pt_BR ru sl sv zh_CN&quot; \
212./configure --prefix=/usr &amp;&amp;</userinput></screen>
213
214 <para>
215 Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
216 you do not wish to install. Alternatively, remove the line starting with
217 <envar>ALL_LINGUAS</envar>, if you wish to build all languages.
218 </para>
219
220<!-- <para>
221 Alternatively, if you wish to build languages including Catalan,
222 apply the patch:
223 </para>
224
225<screen role="nodump"><userinput>xzcat ../gimp-help-2.8.0-build_fixes-1.patch.xz \
226 | patch -p1 &amp;&amp;
227./autogen.sh -prefix=/usr &amp;&amp;</userinput></screen>
228
229 <para>
230 Again, you can specify a subset of languages by specifying
231 <envar>ALL_LINGUAS</envar> in front of <command>./autogen.sh</command>, but
232 this time including &quot;ca&quot;.
233 </para>
234 -->
235 <para>
236 Now build the help files:
237 </para>
238
239<screen><userinput>make</userinput></screen>
240
241 <para>
242 Issue the following commands as the
243 <systemitem class="username">root</systemitem> user to install the help
244 files:
245 </para>
246
247<screen role="root"><userinput>make install &amp;&amp;
248chown -R root:root /usr/share/gimp/2.0/help</userinput></screen>
249
250 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
251 href="../../xincludes/update-icons-and-desktop.xml"/>
252
253 </sect2>
254
255 <sect2 role="commands" id="gimp-cmd-explanations">
256 <title>Command Explanations</title>
257
258 <para>
259 <envar>ALL_LINGUAS=&quot;ca da de el en en_GB ...&quot;</envar>: by
260 default, the help files will be rendered in all the available languages.
261 Remove the codes of any languages you do not wish to build.
262 </para>
263
264 <para>
265 <parameter>--without-gvfs</parameter>: the choice of the backend to
266 handle URI information, e.g., when dragging images from a browser into the
267 <application>Gimp</application>, is made at compile time. This parameter will
268 ensure that <application>cURL</application> is used at run-time, instead of
269 <application>Gvfs</application>. You can omit this if you are installing
270 <application>Gvfs</application> AND will be running <command>gvfsd</command>,
271 e.g., in a <application>GNOME</application> desktop.
272 </para>
273
274 <para><option>--disable-python</option>: This option is necessary if
275 you have not installed <application>PyGTK</application>.</para>
276
277<!--<para>
278 <command>./autogen.sh</command> <parameter>-prefix=/usr</parameter>: In this case, using
279 <command>autoreconf</command> to regenerate <filename>configure</filename>
280 does not work, because of how the gimp-help developers chose to address
281 problems with the autotools.
282 </para>
283
284 <para>
285 <command>xzcat ../gimp-help-2.8.0-build_fixes-1.patch.xz</command>:
286 this patch is large, so it has been compressed with
287 <application>xz</application>. You are encouraged to be suspicious of
288 all patches until you have looked at them. Use <command>view</command>
289 to read the compressed patch before you apply it.
290 </para>
291-->
292 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
293 href="../../xincludes/gtk-doc-rebuild.xml"/>
294
295 </sect2>
296
297 <sect2 role="configuration">
298 <title>Configuring The Gimp</title>
299
300 <sect3 id="gimp-config">
301 <title>Config Files</title>
302
303 <para>
304 <filename>/etc/gimp/2.0/*</filename> and
305 <filename>~/.gimp-2.8/gimprc</filename>
306 </para>
307
308 <indexterm zone="gimp gimp-config">
309 <primary sortas="e-AA.gimp-2.0/gimprc">~/.gimp-2.0/gimprc</primary>
310 </indexterm>
311
312 <indexterm zone="gimp gimp-config">
313 <primary sortas="e-etc-gimp-2.0-star">/etc/gimp/2.0/*</primary>
314 </indexterm>
315
316 </sect3>
317
318 <sect3>
319 <title>Configuration Information</title>
320
321 <para>
322 The <application>Gimp</application> executes a configuration wizard
323 for each user upon their initial use of the program.
324 </para>
325
326 <para>
327 The <application>Gimp</application> executes the
328 <command>firefox</command> web browser by default to view the help
329 files. If you do not have <application>Firefox</application>, or
330 prefer a different web browser, you can set a new system value in
331 <filename>/etc/gimp/2.0/gimprc</filename>. Execute the following
332 command as the <systemitem class="username">root</systemitem> user,
333 replacing <replaceable>&lt;browser&gt;</replaceable> with your
334 preferred web browser:
335 </para>
336
337<screen role="root"><userinput>echo '(web-browser "<replaceable>&lt;browser&gt;</replaceable> %s")' &gt;&gt; /etc/gimp/2.0/gimprc</userinput></screen>
338
339 </sect3>
340
341 </sect2>
342
343 <sect2 role="content">
344 <title>Contents</title>
345
346 <segmentedlist>
347 <segtitle>Installed Programs</segtitle>
348 <segtitle>Installed Libraries</segtitle>
349 <segtitle>Installed Directories</segtitle>
350
351 <seglistitem>
352 <seg>
353 gimp, gimp-2.8, gimp-console, gimp-console-2.8 and
354 gimptool-2.0
355 </seg>
356 <seg>
357 libgimp-2.0.so, libgimpbase-2.0.so, libgimpcolor-2.0.so,
358 libgimpconfig-2.0.so, libgimpmath-2.0.so, libgimpmodule-2.0.so,
359 libgimpthumb-2.0.so, libgimpui-2.0.so and libgimpwidgets-2.0.so
360 </seg>
361 <seg>
362 /etc/gimp,
363 /usr/include/gimp-2.0,
364 /usr/lib/gimp,
365 /usr/share/gimp,
366 /usr/share/gtk-doc/html/{libgimp,libgimpbase,libgimpcolor},
367 /usr/share/gtk-doc/html/{libgimpconfig,libgimpmath},
368 /usr/share/gtk-doc/html/{libgimpmodule,libgimpthumb} and
369 /usr/share/gtk-doc/html/libgimpwidgets
370 </seg>
371 </seglistitem>
372 </segmentedlist>
373
374 <variablelist>
375 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
376 <?dbfo list-presentation="list"?>
377 <?dbhtml list-presentation="table"?>
378
379 <varlistentry id="gimp-prog">
380 <term><command>gimp</command></term>
381 <listitem>
382 <para>
383 is a symbolic link to <command>gimp-2.8</command>.
384 </para>
385 <indexterm zone="gimp gimp-prog">
386 <primary sortas="b-gimp">gimp</primary>
387 </indexterm>
388 </listitem>
389 </varlistentry>
390
391 <varlistentry id="gimp-2.8">
392 <term><command>gimp-2.8</command></term>
393 <listitem>
394 <para>
395 is the Gnu Image Manipulation Program. It works with a variety
396 of image formats and provides a large selection of tools.
397 </para>
398 <indexterm zone="gimp gimp-2.8">
399 <primary sortas="b-gimp-2.8">gimp-2.8</primary>
400 </indexterm>
401 </listitem>
402 </varlistentry>
403
404 <varlistentry id="gimp-console">
405 <term><command>gimp-console</command></term>
406 <listitem>
407 <para>
408 is a symbolic link to <command>gimp-console-2.8</command>.
409 </para>
410 <indexterm zone="gimp gimp-console">
411 <primary sortas="b-gimp-console">gimp-console</primary>
412 </indexterm>
413 </listitem>
414 </varlistentry>
415
416 <varlistentry id="gimp-console-2.8">
417 <term><command>gimp-console-2.8</command></term>
418 <listitem>
419 <para>
420 is a console program that behaves as if The
421 <application>Gimp</application> was called with the
422 <option>--no-interface</option> command-line option.
423 </para>
424 <indexterm zone="gimp gimp-console-2.8">
425 <primary sortas="b-gimp-console-2.8">gimp-console-2.8</primary>
426 </indexterm>
427 </listitem>
428 </varlistentry>
429
430 <varlistentry id="gimptool-2.0">
431 <term><command>gimptool-2.0</command></term>
432 <listitem>
433 <para>
434 is a tool that can build plug-ins or scripts and install them
435 if they are distributed in one source file.
436 <command>gimptool-2.0</command> can also be used by programs that
437 need to know what libraries and include-paths The
438 <application>Gimp</application> was compiled with.
439 </para>
440 <indexterm zone="gimp gimptool-2.0">
441 <primary sortas="b-gimptool-2.0">gimptool-2.0</primary>
442 </indexterm>
443 </listitem>
444 </varlistentry>
445
446 <varlistentry id="libgimp-2.0">
447 <term><filename class="libraryfile">libgimp-2.0.so</filename></term>
448 <listitem>
449 <para>
450 provides C bindings for The <application>Gimp</application>'s
451 Procedural Database (PDB) which offers an interface to core functions
452 and to functionality provided by plug-ins.
453 </para>
454 <indexterm zone="gimp libgimp-2.0">
455 <primary sortas="c-libgimp-2.0">libgimp-2.0.so</primary>
456 </indexterm>
457 </listitem>
458 </varlistentry>
459
460 <varlistentry id="libgimpbase-2.0">
461 <term><filename class="libraryfile">libgimpbase-2.0.so</filename></term>
462 <listitem>
463 <para>
464 provides the C functions for basic
465 <application>Gimp</application> functionality such as determining
466 enumeration data types, gettext translation, determining The
467 <application>Gimp</application>'s version number and capabilities,
468 handling data files and accessing the environment.
469 </para>
470 <indexterm zone="gimp libgimpbase-2.0">
471 <primary sortas="c-libgimpbase-2.0">libgimpbase-2.0.so</primary>
472 </indexterm>
473 </listitem>
474 </varlistentry>
475
476 <varlistentry id="libgimpcolor-2.0">
477 <term><filename
478 class="libraryfile">libgimpcolor-2.0.so</filename></term>
479 <listitem>
480 <para>
481 provides the C functions relating to RGB, HSV and CMYK colors as
482 well as converting colors between different color models and
483 performing adaptive supersampling on an area.
484 </para>
485 <indexterm zone="gimp libgimpcolor-2.0">
486 <primary sortas="c-libgimpcolor-2.0">libgimpcolor-2.0.so</primary>
487 </indexterm>
488 </listitem>
489 </varlistentry>
490
491 <varlistentry id="libgimpconfig-2.0">
492 <term><filename
493 class="libraryfile">libgimpconfig-2.0.so</filename></term>
494 <listitem>
495 <para>
496 contains C functions for reading and writing config information.
497 </para>
498 <indexterm zone="gimp libgimpconfig-2.0">
499 <primary sortas="c-libgimpconfig-2.0">libgimpconfig-2.0.so</primary>
500 </indexterm>
501 </listitem>
502 </varlistentry>
503
504 <varlistentry id="libgimpmath-2.0">
505 <term><filename class="libraryfile">libgimpmath-2.0.so</filename></term>
506 <listitem>
507 <para>
508 contains C functions which provide mathematical definitions and
509 macros, manipulate 3x3 transformation matrices, set up and manipulate
510 vectors and the MD5 message-digest algorithm.
511 </para>
512 <indexterm zone="gimp libgimpmath-2.0">
513 <primary sortas="c-libgimpmath-2.0">libgimpmath-2.0.so</primary>
514 </indexterm>
515 </listitem>
516 </varlistentry>
517
518 <varlistentry id="libgimpmodule-2.0">
519 <term><filename class="libraryfile">libgimpmodule-2.0.so</filename></term>
520 <listitem>
521 <para>
522 provides the C functions which implements module loading using
523 GModule and keeps a list of GimpModule's found in a given
524 searchpath.
525 </para>
526 <indexterm zone="gimp libgimpmodule-2.0">
527 <primary sortas="c-libgimpmodule-2.0">libgimpmodule-2.0.so</primary>
528 </indexterm>
529 </listitem>
530 </varlistentry>
531
532 <varlistentry id="libgimpthumb-2.0">
533 <term><filename class="libraryfile">libgimpthumb-2.0.so</filename></term>
534 <listitem>
535 <para>
536 provides the C functions for handling The
537 <application>Gimp</application>'s thumbnail objects.
538 </para>
539 <indexterm zone="gimp libgimpthumb-2.0">
540 <primary sortas="c-libgimpthumb-2.0">libgimpthumb-2.0.so</primary>
541 </indexterm>
542 </listitem>
543 </varlistentry>
544
545 <varlistentry id="libgimpui-2.0">
546 <term><filename class="libraryfile">libgimpui-2.0.so</filename></term>
547 <listitem>
548 <para>
549 contains The <application>Gimp</application>'s common user
550 interface functions.
551 </para>
552 <indexterm zone="gimp libgimpui-2.0">
553 <primary sortas="c-libgimpui-2.0">libgimpui-2.0.so</primary>
554 </indexterm>
555 </listitem>
556 </varlistentry>
557
558 <varlistentry id="libgimpwidgets-2.0">
559 <term><filename class="libraryfile">libgimpwidgets-2.0.so</filename></term>
560 <listitem>
561 <para>
562 contains The <application>Gimp</application>
563 and <application>GTK</application>'s widget creation and
564 manipulation functions.
565 </para>
566 <indexterm zone="gimp libgimpwidgets-2.0">
567 <primary
568 sortas="c-libgimpwidgets-2.0">libgimpwidgets-2.0.so</primary>
569 </indexterm>
570 </listitem>
571 </varlistentry>
572
573 </variablelist>
574
575 </sect2>
576
577</sect1>
Note: See TracBrowser for help on using the repository browser.