source: general/graphlib/poppler.xml@ 800dd3ae

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 800dd3ae was 800dd3ae, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Update to poppler-0.55.0.
Update to gtksourceview-3.24.2.
Update to libtiff-4.0.8.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@18754 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 17.1 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 poppler-download-http "http://poppler.freedesktop.org/poppler-&poppler-version;.tar.xz">
8 <!ENTITY poppler-download-ftp " ">
9 <!ENTITY poppler-md5sum "f7a8230626b6d2061acfdc852930b7dd">
10 <!ENTITY poppler-size "1.6 MB">
11 <!ENTITY poppler-buildsize "50 MB (with Qt5 library)">
12 <!ENTITY poppler-time "1.3 SBU (with Qt5 library)">
13
14
15 <!ENTITY poppler-data-version "0.4.7">
16
17 <!ENTITY poppler-data-download-http "http://poppler.freedesktop.org/poppler-data-&poppler-data-version;.tar.gz">
18 <!ENTITY poppler-data-md5sum "636a8f2b9f6df9e7ced8ec0946961eaf">
19 <!ENTITY poppler-data-size "4.0 MB">
20 <!ENTITY poppler-data-buildsize "24 MB">
21 <!ENTITY poppler-data-time "less than 0.1 SBU">
22]>
23
24<sect1 id="poppler" xreflabel="Poppler-&poppler-version;">
25 <?dbhtml filename="poppler.html"?>
26
27 <sect1info>
28 <othername>$LastChangedBy$</othername>
29 <date>$Date$</date>
30 </sect1info>
31
32 <title>Poppler-&poppler-version;</title>
33
34 <indexterm zone="poppler">
35 <primary sortas="a-Poppler">Poppler</primary>
36 </indexterm>
37
38 <sect2 role="package">
39 <title>Introduction to Poppler</title>
40
41 <para>
42 The <application>Poppler</application> package contains a PDF rendering
43 library and command line tools used to manipulate PDF files. This is
44 useful for providing PDF rendering functionality as a shared library.
45 </para>
46
47 &lfs80_checked;
48 &gcc7_checked;
49
50 <bridgehead renderas="sect3">Package Information</bridgehead>
51 <itemizedlist spacing="compact">
52 <listitem>
53 <para>
54 Download (HTTP): <ulink url="&poppler-download-http;"/>
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download (FTP): <ulink url="&poppler-download-ftp;"/>
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Download MD5 sum: &poppler-md5sum;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Download size: &poppler-size;
70 </para>
71 </listitem>
72 <listitem>
73 <para>
74 Estimated disk space required: &poppler-buildsize;
75 </para>
76 </listitem>
77 <listitem>
78 <para>
79 Estimated build time: &poppler-time;
80 </para>
81 </listitem>
82 </itemizedlist>
83
84 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
85
86 <itemizedlist spacing="compact">
87 <title>Poppler Encoding Data</title>
88 <listitem>
89 <para>
90 Download (HTTP): <ulink url="&poppler-data-download-http;"/>
91 </para>
92 </listitem>
93 <listitem>
94 <para>
95 Download MD5 sum: &poppler-data-md5sum;
96 </para>
97 </listitem>
98 <listitem>
99 <para>
100 Download size: &poppler-data-size;
101 </para>
102 </listitem>
103 <listitem>
104 <para>
105 Estimated disk space required: &poppler-data-buildsize;
106 </para>
107 </listitem>
108 <listitem>
109 <para>
110 Estimated build time: &poppler-data-time;
111 </para>
112 </listitem>
113 </itemizedlist>
114
115 <para>
116 The additional package consists of encoding files for use with
117 <application>Poppler</application>. The encoding files are optional and
118 <application>Poppler</application> will automatically read them if they
119 are present. When installed, they enable
120 <application>Poppler</application> to render CJK and Cyrillic properly.
121 </para>
122
123 <bridgehead renderas="sect3">Poppler Dependencies</bridgehead>
124
125 <bridgehead renderas="sect4">Required</bridgehead>
126 <para role="required">
127 <xref linkend="fontconfig"/>
128 </para>
129
130 <bridgehead renderas="sect4">Recommended</bridgehead>
131 <para role="recommended">
132 <xref linkend="cairo"/>,
133 <xref linkend="libjpeg"/>,
134 <xref linkend="libpng"/>,
135 <xref linkend="nss"/>, and
136 <xref linkend="openjpeg"/>
137 </para>
138
139 <bridgehead renderas="sect4">Optional</bridgehead>
140 <para role="optional">
141 <xref linkend="curl"/>,
142 <xref linkend="gobject-introspection"/>,
143 <xref linkend="gtk-doc"/>,
144 <xref linkend="gtk2"/>,
145 <xref linkend="lcms"/> or <xref linkend="lcms2"/>,
146 <xref linkend="libtiff"/>,
147 <xref linkend="openjpeg2"/>
148 (preference is for OpenJPEG1, due to regressions with OpenJPEG2), and
149 <xref linkend="qt5"/>
150 </para>
151
152 <para condition="html" role="usernotes">
153 User Notes: <ulink url="&blfs-wiki;/poppler"/>
154 </para>
155 </sect2>
156
157 <sect2 role="installation">
158 <title>Installation of Poppler</title>
159
160 <note>
161 <para>
162 This package can be optionally built with support for only one version
163 of Qt4 or Qt5 or without any Qt support. You can selectively disable
164 support for one or both, see "Command Explanations" section, below.
165 </para>
166 </note>
167
168 <para>
169 Install <application>Poppler</application> by running the following
170 commands:
171 </para>
172
173<!-- Note: the sed is needed even if the /usr/lib64 symlink is not present -->
174
175<screen><userinput>./configure --prefix=/usr \
176 --sysconfdir=/etc \
177 --disable-static \
178 --enable-build-type=release \
179 --enable-cmyk \
180 --enable-xpdf-headers \
181 --with-testdatadir=$PWD/testfiles &amp;&amp;
182make</userinput></screen>
183
184 <para>
185 In order to run the test suite, some testcases are needed and can
186 be obtained only from a git repository. The command to download
187 them is:
188<command>git clone git://git.freedesktop.org/git/poppler/test testfiles</command>.
189 Then issue: <command>LC_ALL=en_US.UTF-8 make check</command>. It seems
190 that only the Qt4/5 libraries are tested.
191 </para>
192
193 <para>
194 Now, as the <systemitem class="username">root</systemitem> user:
195 </para>
196
197<screen role="root"><userinput>make install</userinput></screen>
198
199 <para>
200 To install the documentation, run the following commands as
201 <systemitem class="username">root</systemitem>:
202 </para>
203
204<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/poppler-&poppler-version; &amp;&amp;
205install -v -m644 README* /usr/share/doc/poppler-&poppler-version; &amp;&amp;
206cp -vr glib/reference/html /usr/share/doc/poppler-&poppler-version;</userinput></screen>
207
208<!-- ==== Poppler Data ====== -->
209 <bridgehead renderas="sect3">Poppler Data</bridgehead>
210
211 <para>
212 If you downloaded the additional encoding data package, install it by
213 issuing the following commands:
214 </para>
215
216<screen><userinput>tar -xf ../poppler-data-&poppler-data-version;.tar.gz &amp;&amp;
217cd poppler-data-&poppler-data-version;</userinput></screen>
218
219 <para>
220 Now, as the <systemitem class="username">root</systemitem> user:
221 </para>
222
223<screen role="root"><userinput>make prefix=/usr install</userinput></screen>
224
225 </sect2>
226
227 <sect2 role="commands">
228 <title>Command Explanations</title>
229
230<!--
231 <para>
232 <command>sed ... ltmain.sh</command>: This command removes a lot
233 of irritating invalid warnings.
234 </para>
235 No longer needed with lib64 changes.
236-->
237
238 <para>
239 <parameter>--enable-build-type=release</parameter>: This switch is used
240 to apply a higher level of compiler optimizations. Other options are:
241 [<option>relwithdebinfo/debug/debugfull/profile</option>]
242 </para>
243
244 <para>
245 <parameter>--enable-cmyk</parameter>:
246 Include support for CMYK rasterization.
247 </para>
248
249 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
250 href="../../xincludes/static-libraries.xml"/>
251
252 <para>
253 <parameter>--enable-xpdf-headers</parameter>: Install some old
254 <application>Xpdf</application> headers required by certain programs (e.g.
255 <application>Okular</application>, <application>LibreOffice</application>
256 and <application>Inkscape</application>).
257 </para>
258
259 <para>
260 <parameter>--with-testdatadir=$PWD/testfiles</parameter>: Tell the test
261 programs where the auxiliary files are located.
262 </para>
263
264 <para>
265 <option>--enable-libcurl</option>: Use libcurl for HTTP support.
266 </para>
267
268 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
269 href="../../xincludes/gtk-doc-rebuild.xml"/>
270
271 <para>
272 <option>--disable-poppler-qt4</option>: Don't compile poppler Qt4 wrapper.
273 </para>
274
275 <para>
276 <option>--disable-poppler-qt5</option>: Don't compile poppler Qt5 wrapper.
277 </para>
278
279 <para>
280 <command>LC_ALL=en_US.UTF-8 make check</command>: Run the test suite.
281 The environment variable LC_ALL=en_US.UTF-8 is only needed if the
282 default locale does not include UTF-8.
283 </para>
284
285 </sect2>
286
287 <sect2 role="content">
288 <title>Contents</title>
289
290 <segmentedlist>
291 <segtitle>Installed Programs</segtitle>
292 <segtitle>Installed Libraries</segtitle>
293 <segtitle>Installed Directories</segtitle>
294
295 <seglistitem>
296 <seg>
297 pdfdetach, pdffonts, pdfimages, pdfinfo, pdfseparate, pdfsig,
298 pdftocairo, pdftohtml, pdftoppm, pdftops, pdftotext,
299 pdfunite, and poppler-glib-demo
300 </seg>
301 <seg>
302 libpoppler.so,
303 libpoppler-cpp.so,
304 libpoppler-glib.so, and
305 libpoppler-qt5.so
306 </seg>
307 <seg>
308 /usr/{include,share,share/gtk-doc/html}/poppler and
309 /usr/share/doc/poppler-&poppler-version;
310 </seg>
311 </seglistitem>
312 </segmentedlist>
313
314 <variablelist>
315 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
316 <?dbfo list-presentation="list"?>
317 <?dbhtml list-presentation="table"?>
318
319 <varlistentry id="pdfdetach">
320 <term><command>pdfdetach</command></term>
321 <listitem>
322 <para>
323 lists or extracts embedded files from PDF files.
324 </para>
325 <indexterm zone="poppler pdfdetach">
326 <primary sortas="b-pdfdetach">pdfdetach</primary>
327 </indexterm>
328 </listitem>
329 </varlistentry>
330
331 <varlistentry id="pdffonts">
332 <term><command>pdffonts</command></term>
333 <listitem>
334 <para>
335 lists the fonts used in a PDF file along with various information
336 for each font.
337 </para>
338 <indexterm zone="poppler pdffonts">
339 <primary sortas="b-pdffonts">pdffonts</primary>
340 </indexterm>
341 </listitem>
342 </varlistentry>
343
344 <varlistentry id="pdfimages">
345 <term><command>pdfimages</command></term>
346 <listitem>
347 <para>
348 saves images from a PDF file as PPM, PBM, or JPEG files.
349 </para>
350 <indexterm zone="poppler pdfimages">
351 <primary sortas="b-pdfimages">pdfimages</primary>
352 </indexterm>
353 </listitem>
354 </varlistentry>
355
356 <varlistentry id="pdfinfo">
357 <term><command>pdfinfo</command></term>
358 <listitem>
359 <para>
360 prints the contents of the 'Info' dictionary (plus some other useful
361 information) from a PDF file.
362 </para>
363 <indexterm zone="poppler pdfinfo">
364 <primary sortas="b-pdfinfo">pdfinfo</primary>
365 </indexterm>
366 </listitem>
367 </varlistentry>
368
369 <varlistentry id="pdfseparate">
370 <term><command>pdfseparate</command></term>
371 <listitem>
372 <para>
373 extracts single pages from a PDF file.
374 </para>
375 <indexterm zone="poppler pdfseparate">
376 <primary sortas="b-pdseparate">pdfseparate</primary>
377 </indexterm>
378 </listitem>
379 </varlistentry>
380
381 <varlistentry id="pdfsig">
382 <term><command>pdfsig</command></term>
383 <listitem>
384 <para>
385 verifies the digital signatures in a PDF document.
386 </para>
387 <indexterm zone="poppler pdfsig">
388 <primary sortas="b-pdseparate">pdfsig</primary>
389 </indexterm>
390 </listitem>
391 </varlistentry>
392
393 <varlistentry id="pdftocairo">
394 <term><command>pdftocairo</command></term>
395 <listitem>
396 <para>
397 converts a PDF file to one of several formats (PNG, JPEG, PDF, PS,
398 EPS, SVG) using the cairo output device of the poppler library.
399 </para>
400 <indexterm zone="poppler pdftocairo">
401 <primary sortas="b-pdftocairo">pdftocairo</primary>
402 </indexterm>
403 </listitem>
404 </varlistentry>
405
406 <varlistentry id="pdftohtml">
407 <term><command>pdftohtml</command></term>
408 <listitem>
409 <para>
410 converts a PDF file to HTML.
411 </para>
412 <indexterm zone="poppler pdftohtml">
413 <primary sortas="b-pdftohtml">pdftohtml</primary>
414 </indexterm>
415 </listitem>
416 </varlistentry>
417
418 <varlistentry id="pdftoppm">
419 <term><command>pdftoppm</command></term>
420 <listitem>
421 <para>
422 converts PDF files to PBM, PGM and PPM formats.
423 </para>
424 <indexterm zone="poppler pdftoppm">
425 <primary sortas="b-pdftoppm">pdftoppm</primary>
426 </indexterm>
427 </listitem>
428 </varlistentry>
429
430 <varlistentry id="pdftops">
431 <term><command>pdftops</command></term>
432 <listitem>
433 <para>
434 converts PDF files to Postscript format.
435 </para>
436 <indexterm zone="poppler pdftops">
437 <primary sortas="b-pdftops">pdftops</primary>
438 </indexterm>
439 </listitem>
440 </varlistentry>
441
442 <varlistentry id="pdftotext">
443 <term><command>pdftotext</command></term>
444 <listitem>
445 <para>
446 converts PDF files to plain text.
447 </para>
448 <indexterm zone="poppler pdftotext">
449 <primary sortas="b-pdftotext">pdftotext</primary>
450 </indexterm>
451 </listitem>
452 </varlistentry>
453
454 <varlistentry id="pdfunite">
455 <term><command>pdfunite</command></term>
456 <listitem>
457 <para>
458 merges several PDF files, in the order of their occurrence on the
459 command line, to one PDF output file.
460 </para>
461 <indexterm zone="poppler pdfunite">
462 <primary sortas="b-pdfunite">pdfunite</primary>
463 </indexterm>
464 </listitem>
465 </varlistentry>
466
467 <varlistentry id="poppler-glib-demo">
468 <term><command>poppler-glib-demo</command></term>
469 <listitem>
470 <para>
471 is a tool to demonstrate the API, and for use when debugging and
472 testing <application>Poppler</application>.
473 </para>
474 <indexterm zone="poppler poppler-glib-demo">
475 <primary sortas="b-poppler-glib-demo">poppler-glib-demo</primary>
476 </indexterm>
477 </listitem>
478 </varlistentry>
479
480 <varlistentry id="libpoppler">
481 <term><filename class="libraryfile">libpoppler.so</filename></term>
482 <listitem>
483 <para>
484 contains the API functions to render PDF files.
485 </para>
486 <indexterm zone="poppler libpoppler">
487 <primary sortas="c-libpoppler">libpoppler.so</primary>
488 </indexterm>
489 </listitem>
490 </varlistentry>
491
492 <varlistentry id="libpoppler-cpp">
493 <term><filename class="libraryfile">libpoppler-cpp.so</filename></term>
494 <listitem>
495 <para>
496 is a C++ backend for rendering PDF files.
497 </para>
498 <indexterm zone="poppler libpoppler-cpp">
499 <primary sortas="c-libpoppler-cpp">libpoppler-cpp.so</primary>
500 </indexterm>
501 </listitem>
502 </varlistentry>
503
504 <varlistentry id="libpoppler-glib">
505 <term><filename class="libraryfile">libpoppler-glib.so</filename></term>
506 <listitem>
507 <para>
508 is a wrapper library used to interface the PDF rendering functions
509 with <application>GTK+</application>.
510 </para>
511 <indexterm zone="poppler libpoppler-glib">
512 <primary sortas="c-libpoppler-glib">libpoppler-glib.so</primary>
513 </indexterm>
514 </listitem>
515 </varlistentry>
516
517<!--
518 <varlistentry id="libpoppler-qt4">
519 <term><filename class="libraryfile">libpoppler-qt4.so</filename></term>
520 <listitem>
521 <para>
522 is a wrapper library used to interface the PDF rendering functions
523 with <application>Qt</application>4.
524 </para>
525 <indexterm zone="poppler libpoppler-qt4">
526 <primary sortas="c-libpoppler-qt4">libpoppler-qt4.so</primary>
527 </indexterm>
528 </listitem>
529 </varlistentry>
530-->
531
532 <varlistentry id="libpoppler-qt5">
533 <term><filename class="libraryfile">libpoppler-qt5.so</filename></term>
534 <listitem>
535 <para>
536 is a wrapper library used to interface the PDF rendering functions
537 with <application>Qt</application>5.
538 </para>
539 <indexterm zone="poppler libpoppler-qt5">
540 <primary sortas="c-libpoppler-qt5">libpoppler-qt5.so</primary>
541 </indexterm>
542 </listitem>
543 </varlistentry>
544
545 </variablelist>
546
547 </sect2>
548
549</sect1>
Note: See TracBrowser for help on using the repository browser.