glfs/pst/ps/mupdf.xml
Douglas R. Reno c1ee0054fb mupdf: Add a description for mutool.
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22388 af4574ff-66df-0310-9fd7-8a98e5e911e0
2019-11-23 01:51:21 +00:00

270 lines
7.8 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!--Using archive URL, because when a new version is released, older and new
can be found there, no need to change directory -->
<!ENTITY mupdf-download-http "http://www.mupdf.com/downloads/archive/mupdf-&mupdf-version;-source.tar.gz">
<!ENTITY mupdf-download-ftp " ">
<!ENTITY mupdf-md5sum "fe6ef7a800d4283c6ca14b22e0e7f748">
<!ENTITY mupdf-size "58 MB">
<!ENTITY mupdf-buildsize "238 MB">
<!ENTITY mupdf-time "0.1 SBU (Using parallelism=4)">
]>
<sect1 id="mupdf" xreflabel="mupdf-&mupdf-version;">
<?dbhtml filename="mupdf.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>MuPDF-&mupdf-version;</title>
<indexterm zone="mupdf">
<primary sortas="a-mupdf">mupdf</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to MuPDF</title>
<para>
<application>MuPDF</application> is a lightweight PDF and XPS viewer.
</para>
&lfs90_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&mupdf-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&mupdf-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &mupdf-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &mupdf-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &mupdf-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &mupdf-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Recommended patch:
<ulink url="&patch-root;/mupdf-&mupdf-version;-shared_libs-1.patch"/>
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">MuPDF Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="xorg7-lib"/>
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="freeglut"/>,
<xref linkend="harfbuzz"/>,
<!-- This no-longer gets linked in with our system libs patch
<xref linkend="lcms2"/>, -->
<xref linkend="libjpeg"/>,
<xref linkend="openjpeg2"/>, and
<xref linkend="curl"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref role="runtime" linkend="xdg-utils"/> (runtime),
<ulink url="https://jbig2dec.com">jbig2dec</ulink>, and
<ulink url="https://artifex.com/mujs/">MuJS</ulink>
</para>
<bridgehead renderas="sect4">Required (runtime)</bridgehead>
<para role="required">
<xref role="runtime" linkend="x-window-system"/>
</para>
<para condition="html" role="usernotes">
User Notes: <ulink url="&blfs-wiki;/mupdf"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of MuPDF</title>
<para>
Install <application>MuPDF</application> by running the following
commands:
</para>
<screen><userinput>patch -Np1 -i ../mupdf-&mupdf-version;-shared_libs-1.patch &amp;&amp;
USE_SYSTEM_LIBS=yes make</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>USE_SYSTEM_LIBS=yes \
make prefix=/usr \
build=release \
docdir=/usr/share/doc/mupdf-&mupdf-version; \
install &amp;&amp;
ln -sfv mupdf-x11 /usr/bin/mupdf &amp;&amp;
ldconfig</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para>
<command>ln -sfv mupdf-x11 /usr/bin/mupdf </command>:
This symbolic link chooses between <command>mupdf-gl</command>
and <command>mupdf-x11</command> when running <command>mupdf</command>.
</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>mupdf(symlink),
mupdf-gl,
mupdf-x11, and
mutool
</seg>
<seg>libmupdf.so,
libmupdfthird.so,
libmupkcs7.so, and
libmuthreads.so
</seg>
<seg>/usr/include/mupdf,
/usr/share/doc/mupdf-&mupdf-version;
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="mupdf-prog">
<term><command>mupdf</command></term>
<listitem>
<para>
is a program for viewing PDF, XPS, EPUB, and CBZ documents,
and various image formats such as PNG, JPEG, GIFF, and TIFF.
</para>
<indexterm zone="mupdf mupdf-prog">
<primary sortas="b-mupdf">mupdf</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mupdf-gl">
<term><command>mupdf-gl</command></term>
<listitem>
<para>
same as <command>mupdf</command>, using an opengl renderer.
</para>
<indexterm zone="mupdf mupdf-gl">
<primary sortas="b-mupdf-gl">mupdf-gl</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mupdf-x11">
<term><command>mupdf-x11</command></term>
<listitem>
<para>
same as <command>mupdf</command>, using an X Window renderer.
</para>
<indexterm zone="mupdf mupdf-x11">
<primary sortas="b-mupdf-x11">mupdf-x11</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mutool">
<term><command>mutool</command></term>
<listitem>
<para>
is a program to perform various operations on PDF files, such
as merging and cleaning PDF documents.
</para>
<indexterm zone="mupdf mutool">
<primary sortas="b-mutool">mutool</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libmupdf">
<term><filename class="libraryfile">libmupdf.so</filename></term>
<listitem>
<para>
contains the mupdf API functions.
</para>
<indexterm zone="mupdf libmupdf">
<primary sortas="c-libmupdf">libmupdf.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libmupdfthird">
<term><filename class="libraryfile">libmupdfthird.so</filename></term>
<listitem>
<para>
contains the third party libraries compiled for mudpf.
</para>
<indexterm zone="mupdf libmupdfthird">
<primary sortas="c-libmupdfthird">libmupdfthird.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>