source: gnome/applications/evince.xml

trunk
Last change on this file was 8a2cb97, checked in by Douglas R. Reno <renodr@…>, 5 weeks ago

Tag GNOME Applications and dependencies

  • Property mode set to 100644
File size: 9.8 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 evince-download-http
8 "&gnome-download-http;/evince/&gnome-42;/evince-&evince-version;.tar.xz">
9 <!ENTITY evince-download-ftp
10 "&gnome-download-ftp;/evince/&gnome-42;/evince-&evince-version;.tar.xz">
11 <!ENTITY evince-md5sum "af79972007dc35ee6151aa2ceb0c50a3">
12 <!ENTITY evince-size "2.7 MB">
13 <!ENTITY evince-buildsize "46 MB">
14 <!ENTITY evince-time "0.2 SBU (Using parallelism=4)">
15]>
16
17<sect1 id="evince" xreflabel="Evince-&evince-version;">
18 <?dbhtml filename="evince.html"?>
19
20 <sect1info>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Evince-&evince-version;</title>
25
26 <indexterm zone="evince">
27 <primary sortas="a-Evince">Evince</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Evince</title>
32
33 <para>
34 <application>Evince</application> is a document viewer for multiple
35 document formats. It supports PDF, Postscript, DjVu, TIFF and DVI.
36 It is useful for viewing documents of various types using one simple
37 application instead of the multiple document viewers that once existed
38 on the <application>GNOME</application> Desktop.
39 </para>
40
41 &lfs112_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&evince-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&evince-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &evince-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &evince-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &evince-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &evince-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">Evince Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Required</bridgehead>
80 <para role="required">
81 <xref linkend="adwaita-icon-theme"/>,
82 <xref linkend="gsettings-desktop-schemas"/>,
83 <xref linkend="gtk3"/>,
84 <xref linkend="itstool"/>,
85 <xref linkend="libhandy1"/>,
86 <xref linkend="libxml2"/>, and
87 <xref linkend="openjpeg2"/>
88 </para>
89
90 <bridgehead renderas="sect4">Recommended</bridgehead>
91 <para role="recommended">
92 <xref linkend="gnome-keyring"/>,
93 <xref linkend="gobject-introspection"/>,
94 <xref linkend="libarchive"/>,
95 <xref linkend="libsecret"/>,
96 <xref linkend="nautilus"/> (to build the plugin), and
97 <xref linkend="poppler"/>
98 </para>
99
100 <bridgehead renderas="sect4">Optional</bridgehead>
101 <para role="optional">
102 <xref linkend="cups"/> (to enable printing if support is built into
103 <application>GTK+ 3</application>),
104 <xref linkend="gnome-desktop"/>,
105 <xref linkend="gspell"/>,
106 <xref linkend="gst10-plugins-base"/>,
107 <xref linkend="gtk-doc"/>,
108 <xref linkend="libgxps"/>,
109 <xref linkend="libtiff"/>,
110 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>),
111 <ulink url="http://djvu.sourceforge.net/">DjVuLibre</ulink>,
112 <ulink url="https://gitlab.gnome.org/GNOME/gi-docgen">gi-docgen</ulink>,
113 <ulink url="http://www.freedesktop.org/wiki/Software/libspectre/">libspectre</ulink>,
114 <ulink url="https://github.com/jlaurens/synctex">Synctex</ulink>, and
115 <ulink url="https://www.t1lib.org/">t1lib</ulink>
116 </para>
117
118 <para condition="html" role="usernotes">User Notes:
119 <ulink url="&blfs-wiki;/evince"/>
120 </para>
121 </sect2>
122
123 <sect2 role="installation">
124 <title>Installation of Evince</title>
125
126 <para>
127 First, make sure that meson can find TeXLive if it is installed.
128 This has no effect on systems without TeXLive installed.
129 </para>
130
131<screen><userinput remap="pre">export CPPFLAGS="-I/opt/texlive/&texlive-year;/include" &amp;&amp;
132export LDFLAGS="$LDFLAGS -L/opt/texlive/&texlive-year;/lib"</userinput></screen>
133
134
135 <para>
136 Install <application>Evince</application> by running the following
137 commands:
138 </para>
139
140<screen revision="sysv"><userinput>mkdir build &amp;&amp;
141cd build &amp;&amp;
142
143meson --prefix=/usr \
144 --buildtype=release \
145 -Dgtk_doc=false \
146 --wrap-mode=nodownload \
147 -Dsystemduserunitdir=no .. &amp;&amp;
148ninja</userinput></screen>
149
150<screen revision="systemd"><userinput>mkdir build &amp;&amp;
151cd build &amp;&amp;
152
153meson --prefix=/usr \
154 --buildtype=release \
155 -Dgtk_doc=false \
156 --wrap-mode=nodownload \
157 .. &amp;&amp;
158ninja</userinput></screen>
159
160 <para>
161 This package does not have a working testsuite.
162 </para>
163
164 <para>
165 Now, as the <systemitem class="username">root</systemitem> user:
166 </para>
167
168<screen role="root"><userinput>ninja install</userinput></screen>
169
170 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
171 href="../../xincludes/gsettings-destdir.xml"/>
172
173 </sect2>
174
175 <sect2 role="commands">
176 <title>Command Explanations</title>
177
178 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
179 href="../../xincludes/meson-buildtype-release.xml"/>
180
181 <para>
182 <parameter>CPPFLAGS="..." LDFLAGS="$LDFLAGS ..."</parameter>: If
183 <application>TeXLive</application> has been installed in
184 <filename class="directory">/opt/texlive/&texlive-year;</filename> the
185 configure script will find
186 <filename class='libraryfile'>libkpathsea.so</filename> and enable the
187 DVI backend, but without this addition the compile will fail because it
188 cannot find the required headers. Adding this to a system where
189 <application>TeXLive</application> has not been installed does not break
190 the build.
191 </para>
192
193 <para>
194 <parameter>-Dgtk_doc=false</parameter>: This switch disables generating
195 the gtk-doc API reference documentation. If you have
196 <xref role="nodep" linkend="gtk-doc"/> installed and wish to generate
197 the API reference documentation, remove this switch and the following
198 one.
199 </para>
200
201 <para>
202 <parameter>--wrap-mode=nodownload</parameter>: This switch disables
203 fetching any dependency: the build system tries to fetch gi-docgen
204 even if <parameter>-Dgtk_doc=false</parameter> is passed.
205 </para>
206
207 <para>
208 <option>-Dgspell=false</option>: This switch turns off support
209 for the spell checking plugin.
210 </para>
211
212 <para>
213 <option>-Dintrospection=false</option>: Use this option if you
214 don't have <xref role="nodep" linkend="gobject-introspection"/>
215 installed and don't wish to have introspection support built into Evince.
216 </para>
217
218 <para>
219 <option>-Dnautilus=false</option>: This switch disables building
220 the <application>Nautilus</application> Plugin. Use this switch
221 if <application>Nautilus</application> is not installed.
222 </para>
223
224 <para>
225 <option>-Dkeyring=false</option>: This switch disables the use of
226 <application>libsecret</application>. Use this switch
227 if <application>libsecret</application> is not installed.
228 </para>
229
230 <para>
231 <option>-Dps=enabled</option>: Use this switch if
232 <application>libspectre</application> is installed and you want to
233 view PostScript files with <application>Evince</application>.
234 </para>
235
236 </sect2>
237
238 <sect2 role="content">
239 <title>Contents</title>
240
241 <segmentedlist>
242 <segtitle>Installed Programs</segtitle>
243 <segtitle>Installed Libraries</segtitle>
244 <segtitle>Installed Directories</segtitle>
245
246 <seglistitem>
247 <seg>
248 evince, evince-previewer, and evince-thumbnailer
249 </seg>
250 <seg>
251 libevdocument3.so and
252 libevview3.so
253 </seg>
254 <seg>
255 /usr/{include,lib,share}/evince,
256 /usr/share/gtk-doc/html/{evince,libevdocument-3.0,libevview-3.0}
257 (optional), and
258 /usr/share/help/*/evince
259 </seg>
260 </seglistitem>
261 </segmentedlist>
262
263 <variablelist>
264 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
265 <?dbfo list-presentation="list"?>
266 <?dbhtml list-presentation="table"?>
267
268 <varlistentry id="evince-prog">
269 <term><command>evince</command></term>
270 <listitem>
271 <para>
272 is a multiple format document viewer
273 </para>
274 <indexterm zone="evince evince-prog">
275 <primary sortas="b-evince">evince</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="evince-previewer">
281 <term><command>evince-previewer</command></term>
282 <listitem>
283 <para>
284 is an application that implements the printing previewer
285 </para>
286 <indexterm zone="evince evince-previewer">
287 <primary sortas="b-evince-previewer">evince-previewer</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 <varlistentry id="evince-thumbnailer">
293 <term><command>evince-thumbnailer</command></term>
294 <listitem>
295 <para>
296 is a simple program used to create thumbnail images of
297 supported documents
298 </para>
299 <indexterm zone="evince evince-thumbnailer">
300 <primary sortas="b-evince-thumbnailer">evince-thumbnailer</primary>
301 </indexterm>
302 </listitem>
303 </varlistentry>
304
305 </variablelist>
306
307 </sect2>
308
309</sect1>
Note: See TracBrowser for help on using the repository browser.