source: general/graphlib/poppler.xml@ 4b65cdf

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 4b65cdf was 4b65cdf, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Update to xine-lib-1.2.8.
Update to nano-2.7.5.
Update to phonon-backend-vlc-0.9.1.
Update to libsigsegv-2.11.
Update to NSS-3.29.1.
Update to poppler-0.52.0.

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