source: pst/ps/mupdf.xml

trunk
Last change on this file was ab44eca, checked in by Bruce Dubbs <bdubbs@…>, 32 hours ago

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