source: general/graphlib/poppler.xml@ 0340f82

10.0 10.1 11.0 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 0340f82 was 0340f82, checked in by Ken Moffat <ken@…>, 14 years ago

Fix poppler vulnerabilities.

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

  • Property mode set to 100644
File size: 9.4 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.gz">
8 <!ENTITY poppler-download-ftp " ">
9 <!ENTITY poppler-md5sum "053fdfd70533ecce1a06353fa945f061">
10 <!ENTITY poppler-size "1.0 MB">
11 <!ENTITY poppler-buildsize "49 MB (additional 15 MB to install the encoding data package)">
12 <!ENTITY poppler-time "1.0 SBU (includes building with all dependencies)">
13
14 <!ENTITY poppler-data-version "0.1">
15]>
16
17<sect1 id="poppler" xreflabel="Poppler-&poppler-version;">
18 <?dbhtml filename="poppler.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>Poppler-&poppler-version;</title>
26
27 <indexterm zone="poppler">
28 <primary sortas="a-Poppler">Poppler</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to Poppler</title>
33
34 <para>The <application>Poppler</application> package contains a PDF
35 rendering library and command line tools used to manipulate PDF files.
36 This is useful for providing PDF rendering functionality as a shared
37 library.</para>
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>Download (HTTP): <ulink url="&poppler-download-http;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download (FTP): <ulink url="&poppler-download-ftp;"/></para>
46 </listitem>
47 <listitem>
48 <para>Download MD5 sum: &poppler-md5sum;</para>
49 </listitem>
50 <listitem>
51 <para>Download size: &poppler-size;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated disk space required: &poppler-buildsize;</para>
55 </listitem>
56 <listitem>
57 <para>Estimated build time: &poppler-time;</para>
58 </listitem>
59 </itemizedlist>
60
61 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
62 <itemizedlist spacing="compact">
63 <listitem>
64 <para>Required patch: <ulink
65 url="&patch-root;/poppler-&poppler-version;-security_fixes-1.patch"/></para>
66 </listitem>
67 <listitem>
68 <para>Poppler Encoding Data: <ulink
69 url="http://poppler.freedesktop.org/poppler-data-&poppler-data-version;.tar.gz"/></para>
70 </listitem>
71 </itemizedlist>
72
73 <para>The additional package consists of encoding files for use with
74 Poppler. The encoding files are optional and poppler will automatically
75 read them if they are present. When installed, they enable Poppler to
76 render CJK and Cyrillic properly.</para>
77
78 <bridgehead renderas="sect3">Poppler Dependencies</bridgehead>
79
80 <bridgehead renderas="sect4">Required</bridgehead>
81 <para role="required"><xref linkend="pkgconfig"/> and
82 <xref linkend="fontconfig"/></para>
83
84 <bridgehead renderas="sect4">Optional</bridgehead>
85 <para role="optional"><xref linkend="libjpeg"/>,
86 <xref linkend="cairo"/>,
87 <xref linkend="gtk2"/>,
88 <xref linkend="qt"/>, and
89 <ulink url="http://www.trolltech.com/download/opensource.html">Qt-4.x.x</ulink></para>
90
91 <para>If you're installing <application>Poppler</application> to support
92 <xref linkend="kdegraphics"/>, you will need to have <xref linkend="qt"/>
93 installed so that the <filename class='libraryfile'>libpoppler-qt</filename>
94 library is built.</para>
95
96 <para condition="html" role="usernotes">User Notes:
97 <ulink url="&blfs-wiki;/poppler"/></para>
98
99 </sect2>
100
101 <sect2 role="installation">
102 <title>Installation of Poppler</title>
103
104 <caution>
105 <para><application>Poppler</application> will overwrite command-line
106 utilities and man pages previously installed by the
107 <application>Xpdf</application> package. If you prefer to keep the
108 <application>Xpdf</application> versions of these files, pass the
109 <option>--disable-utils</option> parameter to the
110 <command>configure</command> command below.</para>
111 </caution>
112
113 <para>The <command>configure</command> command below includes three
114 parameters which disable various rendering back-ends. Ensure you remove
115 any of the parameters for which you have the corresponding dependency
116 installed. Install <application>Poppler</application> by running the
117 following commands:</para>
118
119<screen><userinput>patch -Np1 -i ../poppler-&poppler-version;-security_fixes-1.patch &amp;&amp;
120./configure --prefix=/usr \
121 --sysconfdir=/etc \
122 --enable-zlib \
123 --disable-cairo-output \
124 --disable-poppler-glib \
125 --disable-gtk-test &amp;&amp;
126make</userinput></screen>
127
128 <para>This package does not come with a test suite.</para>
129
130 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
131
132<screen role="root"><userinput>make install &amp;&amp;
133install -v -m755 -d /usr/share/doc/poppler-&poppler-version; &amp;&amp;
134install -v -m644 README* /usr/share/doc/poppler-&poppler-version;</userinput></screen>
135
136 <para>If you downloaded the additional encoding data package, install
137 it by issuing the following command after unpacking the tarball and
138 changing into the newly-created package source directory (as the
139 <systemitem class="username">root</systemitem> user):</para>
140
141<screen role="root"><userinput>make prefix=/usr install</userinput></screen>
142
143 </sect2>
144
145 <sect2 role="commands">
146 <title>Command Explanations</title>
147
148 <para><parameter>--enable-zlib</parameter>: This parameter forces the build
149 to link with the system-installed
150 <filename class='libraryfile'>libz</filename> library to enable compressed
151 PDF functionality.</para>
152
153 <para><parameter>--disable-cairo-output</parameter>: This parameter
154 disables building the <application>cairo</application> graphics backend.
155 Remove this parameter if you have <application>cairo</application>
156 installed.</para>
157
158 <para><parameter>--disable-poppler-glib</parameter> and
159 <parameter>--disable-gtk-test</parameter>: These parameters disable
160 building the <application>GLib</application> wrapper and
161 <application>GTK+</application> test program. Remove these parameters if
162 you have <application>GTK+</application>-2 installed. Note that if you
163 plan on building <xref linkend="evince"/>, you must build the
164 <application>GLib</application> wrapper.</para>
165
166 </sect2>
167
168 <sect2 role="configuration">
169 <title>Configuring Poppler</title>
170
171 <sect3 id="poppler-config">
172 <title>Config Files</title>
173 <para><filename>/etc/xpdfrc</filename></para>
174
175 <indexterm zone="poppler poppler-config">
176 <primary sortas="e-etc-xpdfrc">/etc/xpdfrc</primary>
177 </indexterm>
178 </sect3>
179
180 </sect2>
181
182 <sect2 role="content">
183 <title>Contents</title>
184
185 <segmentedlist>
186 <segtitle>Installed Programs</segtitle>
187 <segtitle>Installed Libraries</segtitle>
188 <segtitle>Installed Directories</segtitle>
189
190 <seglistitem>
191 <seg><xref linkend="xpdf-content"/></seg>
192 <seg>libpoppler.{so,a}, libpoppler-glib.{so,a},
193 libpoppler-qt.{so,a} and libpoppler-qt4.{so,a}</seg>
194 <seg>/usr/include/poppler,
195 /usr/share/doc/poppler-&poppler-version;,
196 /usr/share/gtk-doc/html/poppler and
197 /usr/share/poppler</seg>
198 </seglistitem>
199 </segmentedlist>
200
201 <variablelist>
202 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
203 <?dbfo list-presentation="list"?>
204 <?dbhtml list-presentation="table"?>
205
206 <varlistentry id="libpoppler">
207 <term><filename class='libraryfile'>libpoppler.{so,a}</filename></term>
208 <listitem>
209 <para>contains the API functions to render PDF files.</para>
210 <indexterm zone="poppler libpoppler">
211 <primary sortas="c-libpoppler">libpoppler.{so,a}</primary>
212 </indexterm>
213 </listitem>
214 </varlistentry>
215
216 <varlistentry id="libpoppler-glib">
217 <term><filename class='libraryfile'>libpoppler-glib.{so,a}</filename></term>
218 <listitem>
219 <para>is a wrapper library used to interface the PDF rendering
220 functions with <application>GTK+</application>.</para>
221 <indexterm zone="poppler libpoppler-glib">
222 <primary sortas="c-libpoppler-glib">libpoppler-glib.{so,a}</primary>
223 </indexterm>
224 </listitem>
225 </varlistentry>
226
227 <varlistentry id="libpoppler-qt">
228 <term><filename class='libraryfile'>libpoppler-qt.{so,a}</filename></term>
229 <listitem>
230 <para>is a wrapper library used to interface the PDF rendering
231 functions with <application>Qt</application>.</para>
232 <indexterm zone="poppler libpoppler-qt">
233 <primary sortas="c-libpoppler-qt">libpoppler-qt.{so,a}</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="libpoppler-qt4">
239 <term><filename class='libraryfile'>libpoppler-qt4.{so,a}</filename></term>
240 <listitem>
241 <para>is a wrapper library used to interface the PDF rendering
242 functions with <application>Qt</application>-4.</para>
243 <indexterm zone="poppler libpoppler-qt4">
244 <primary sortas="c-libpoppler-qt4">libpoppler-qt4.{so,a}</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 </variablelist>
250
251 </sect2>
252
253</sect1>
Note: See TracBrowser for help on using the repository browser.