source: pst/ps/mupdf.xml

trunk
Last change on this file was 8558044, checked in by Pierre Labastie <pierre.labastie@…>, 7 weeks ago

Remove spaces at the end of lines

I know it is somewhat useless, but I don't like them for
two reasons: first they cannot be seen, and I do not like things I
cannot see. Second, git highlights them, and this is disturbing...

  • Property mode set to 100644
File size: 8.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<!--Using archive URL, because when a new version is released, older and new
8can be found there, no need to change directory -->
9 <!ENTITY mupdf-download-http "https://www.mupdf.com/downloads/archive/mupdf-&mupdf-version;-source.tar.gz">
10 <!ENTITY mupdf-download-ftp " ">
11 <!ENTITY mupdf-md5sum "6f42be1365350f05270f8776517a3872">
12 <!ENTITY mupdf-size "69 MB">
13 <!ENTITY mupdf-buildsize "320 MB">
14 <!ENTITY mupdf-time "0.2 SBU (Using parallelism=4)">
15]>
16
17<sect1 id="mupdf" xreflabel="mupdf-&mupdf-version;">
18 <?dbhtml filename="mupdf.html"?>
19
20 <sect1info>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>MuPDF-&mupdf-version;</title>
25
26 <indexterm zone="mupdf">
27 <primary sortas="a-mupdf">mupdf</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to MuPDF</title>
32
33 <para>
34 <application>MuPDF</application> is a lightweight PDF and XPS viewer.
35 </para>
36
37 &lfs110a_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&mupdf-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&mupdf-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &mupdf-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &mupdf-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &mupdf-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &mupdf-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Required Additional Downloads</bridgehead>
74 <itemizedlist spacing="compact">
75 <listitem>
76 <para>
77 Required patch: <ulink
78 url="&patch-root;/mupdf-&mupdf-version;-security_fix-1.patch"/>
79 </para>
80 </listitem>
81 </itemizedlist>
82
83 <bridgehead renderas="sect3">MuPDF Dependencies</bridgehead>
84
85 <bridgehead renderas="sect4">Required</bridgehead>
86 <para role="required">
87 <xref linkend="glu"/> and <!-- previously recommended via system freeglut -->
88 <xref linkend="xorg7-lib"/>
89 </para>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
93 <!--<xref linkend="freeglut"/>, use of the bundled glut is preferred -->
94 <xref linkend="harfbuzz"/>,
95 <!-- This no-longer gets linked in with our system libs patch
96 <xref linkend="lcms2"/>, -->
97 <xref linkend="libjpeg"/>,
98 <xref linkend="openjpeg2"/>, and
99 <xref linkend="curl"/>
100 </para>
101
102 <bridgehead renderas="sect4">Optional</bridgehead>
103 <para role="optional">
104 <xref role="runtime" linkend="xdg-utils"/> (runtime),
105 <ulink url="https://jbig2dec.com">jbig2dec</ulink>, and
106 <ulink url="https:/mujs.com/">MuJS</ulink>
107 </para>
108
109 <bridgehead renderas="sect4">Required (runtime)</bridgehead>
110 <para role="required">
111 <xref role="runtime" linkend="x-window-system"/>
112 </para>
113
114 <para condition="html" role="usernotes">
115 User Notes: <ulink url="&blfs-wiki;/mupdf"/>
116 </para>
117 </sect2>
118
119 <sect2 role="installation">
120 <title>Installation of MuPDF</title>
121
122 <para>First, fix the Makefile to link properly with the shared library:</para>
123
124<screen><userinput>sed -i '/MU.*_EXE. :/{
125 s/\(.(MUPDF_LIB)\)\(.*\)$/\2 | \1/
126 N
127 s/$/ -lmupdf -L$(OUT)/
128 }' Makefile</userinput></screen>
129
130 <para>
131 Install <application>MuPDF</application> by running the following
132 commands:
133 </para>
134
135<screen><userinput>cat &gt; user.make &lt;&lt; EOF &amp;&amp;
136USE_SYSTEM_FREETYPE := yes
137USE_SYSTEM_HARFBUZZ := yes
138USE_SYSTEM_JBIG2DEC := no
139USE_SYSTEM_JPEGXR := no # not used without HAVE_JPEGXR
140USE_SYSTEM_LCMS2 := no # need lcms2-art fork
141USE_SYSTEM_LIBJPEG := yes
142USE_SYSTEM_MUJS := no # build needs source anyways
143USE_SYSTEM_OPENJPEG := yes
144USE_SYSTEM_ZLIB := yes
145USE_SYSTEM_GLUT := no # need freeglut2-art fork
146USE_SYSTEM_CURL := yes
147USE_SYSTEM_GUMBO := no
148EOF
149
150export XCFLAGS=-fPIC &amp;&amp;
151patch -Np1 -i ../mupdf-&mupdf-version;-security_fix-1.patch &amp;&amp;
152make build=release shared=yes &amp;&amp;
153unset XCFLAGS</userinput></screen>
154
155 <para>
156 This package does not come with a test suite.
157 </para>
158
159 <para>
160 Now, as the <systemitem class="username">root</systemitem> user:
161 </para>
162
163<screen role="root"><userinput>make prefix=/usr \
164 shared=yes \
165 docdir=/usr/share/doc/mupdf-&mupdf-version; \
166 install &amp;&amp;
167
168chmod 755 /usr/lib/libmupdf.so &amp;&amp;
169ln -sfv mupdf-x11 /usr/bin/mupdf</userinput></screen>
170
171 </sect2>
172
173 <sect2 role="commands">
174 <title>Command Explanations</title>
175
176 <para>
177 <command>ln -sfv mupdf-x11 /usr/bin/mupdf </command>:
178 This symbolic link chooses between <command>mupdf-gl</command>
179 and <command>mupdf-x11</command> when running <command>mupdf</command>.
180 </para>
181
182 </sect2>
183
184 <sect2 role="content">
185 <title>Contents</title>
186
187 <segmentedlist>
188 <segtitle>Installed Program</segtitle>
189 <segtitle>Installed Libraries</segtitle>
190 <segtitle>Installed Directories</segtitle>
191
192 <seglistitem>
193 <seg>
194 mupdf (symlink),
195 mupdf-gl,
196 mupdf-x11,
197 mupdf-x11-curl,
198 muraster, and
199 mutool
200 </seg>
201 <seg>
202 libmupdf.so
203 </seg>
204 <seg>
205 /usr/include/mupdf,
206 /usr/share/doc/mupdf-&mupdf-version;
207 </seg>
208 </seglistitem>
209 </segmentedlist>
210
211 <variablelist>
212 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
213 <?dbfo list-presentation="list"?>
214 <?dbhtml list-presentation="table"?>
215
216 <varlistentry id="mupdf-prog">
217 <term><command>mupdf</command></term>
218 <listitem>
219 <para>
220 is a program for viewing PDF, XPS, EPUB, and CBZ documents,
221 and various image formats such as PNG, JPEG, GIFF, and TIFF
222 </para>
223 <indexterm zone="mupdf mupdf-prog">
224 <primary sortas="b-mupdf">mupdf</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="mupdf-gl">
230 <term><command>mupdf-gl</command></term>
231 <listitem>
232 <para>
233 same as <command>mupdf</command>, using an opengl renderer
234 </para>
235 <indexterm zone="mupdf mupdf-gl">
236 <primary sortas="b-mupdf-gl">mupdf-gl</primary>
237 </indexterm>
238 </listitem>
239 </varlistentry>
240
241 <varlistentry id="mupdf-x11">
242 <term><command>mupdf-x11</command></term>
243 <listitem>
244 <para>
245 same as <command>mupdf</command>, using an X Window renderer
246 </para>
247 <indexterm zone="mupdf mupdf-x11">
248 <primary sortas="b-mupdf-x11">mupdf-x11</primary>
249 </indexterm>
250 </listitem>
251 </varlistentry>
252
253 <varlistentry id="muraster">
254 <term><command>muraster</command></term>
255 <listitem>
256 <para>
257 is a program used to perform rasterization tasks with PDF
258 documents
259 </para>
260 <indexterm zone="mupdf muraster">
261 <primary sortas="b-muraster">muraster</primary>
262 </indexterm>
263 </listitem>
264 </varlistentry>
265
266 <varlistentry id="mutool">
267 <term><command>mutool</command></term>
268 <listitem>
269 <para>
270 is a program to perform various operations on PDF files, such
271 as merging and cleaning PDF documents
272 </para>
273 <indexterm zone="mupdf mutool">
274 <primary sortas="b-mutool">mutool</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="libmupdf">
280 <term><filename class="libraryfile">libmupdf.so</filename></term>
281 <listitem>
282 <para>
283 contains the mupdf API functions
284 </para>
285 <indexterm zone="mupdf libmupdf">
286 <primary sortas="c-libmupdf">libmupdf.so</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 </variablelist>
292
293 </sect2>
294
295</sect1>
Note: See TracBrowser for help on using the repository browser.