source: gnome/applications/evince.xml@ 20f070d8

trunk
Last change on this file since 20f070d8 was 20f070d8, checked in by Xi Ruoyao <xry111@…>, 8 weeks ago

first batch of meson --buildtype=release

  • Property mode set to 100644
File size: 9.7 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-40;/evince-&evince-version;.tar.xz">
9 <!ENTITY evince-download-ftp
10 "&gnome-download-ftp;/evince/&gnome-40;/evince-&evince-version;.tar.xz">
11 <!ENTITY evince-md5sum "89b9c52d6fd03ffb244abc12a989d1ec">
12 <!ENTITY evince-size "2.8 MB">
13 <!ENTITY evince-buildsize "84 MB">
14 <!ENTITY evince-time "0.4 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 &lfs101_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://wiki.gnome.org/action/show/Projects/libgxps">libgxps</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 <para>
135 Install <application>Evince</application> by running the following
136 commands:
137 </para>
138
139<screen revision="sysv"><userinput>mkdir build &amp;&amp;
140cd build &amp;&amp;
141
142meson --prefix=/usr \
143 --buildtype=release \
144 -Dgtk_doc=false \
145 -Dsystemduserunitdir=no .. &amp;&amp;
146ninja</userinput></screen>
147
148<screen revision="systemd"><userinput>mkdir build &amp;&amp;
149cd build &amp;&amp;
150
151meson --prefix=/usr --buildtype=release -Dgtk_doc=false .. &amp;&amp;
152ninja</userinput></screen>
153
154 <para>
155 This package does not have a working testsuite.
156 </para>
157
158 <para>
159 Now, as the <systemitem class="username">root</systemitem> user:
160 </para>
161
162<screen role="root"><userinput>ninja install</userinput></screen>
163
164 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
165 href="../../xincludes/gsettings-destdir.xml"/>
166
167 </sect2>
168
169 <sect2 role="commands">
170 <title>Command Explanations</title>
171
172 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
173 href="../../xincludes/meson-buildtype-release.xml"/>
174
175 <!--
176 <para>
177 <parameter>- -enable-compile-warnings=minimum</parameter>: This
178 switch prevents a warning about a date format being treated as an error by
179 <application>gcc-6.1</application>.
180 </para>
181 -->
182
183 <para>
184 <parameter>CPPFLAGS="..." LDFLAGS="$LDFLAGS ..."</parameter>: If
185 <application>TeXLive</application> has been installed in
186 <filename class="directory">/opt/texlive-&texlive-year;</filename> the
187 configure script will find <filename class='libraryfile'>libkpathsea.so</filename>
188 and enable the DVI backend, but without this addition the compile will fail
189 because it cannot find the required headers. Adding this to a system where
190 <application>TeXLive</application> has not been installed does not break the
191 build.
192 </para>
193
194 <para>
195 <parameter>-Dgtk_doc=false</parameter>: This switch disables generating
196 the gtk-doc API reference documentation. If you have
197 <xref role="nodep" linkend="gtk-doc"/> installed and wish to generate
198 the API reference documentation, remove this switch.
199 </para>
200
201 <para>
202 <option>-Dgspell=false</option>: This switch turns off support
203 for the spell checking plugin.
204 </para>
205
206 <para>
207 <option>-Dintrospection=false</option>: Use this option if you
208 don't have <xref role="nodep" linkend="gobject-introspection"/>
209 installed and don't wish to have introspection support built into Evince.
210 </para>
211
212<!--
213 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
214 href="../../xincludes/static-libraries.xml"/>
215
216 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
217 href="../../xincludes/gtk-doc-rebuild.xml"/>
218-->
219
220 <para>
221 <option>-Dnautilus=false</option>: This switch disables building
222 the <application>Nautilus</application> Plugin. Use this switch
223 if <application>Nautilus</application> is not installed.
224 </para>
225
226 <para>
227 <option>-Dkeyring=false</option>: This switch disables the use of
228 <application>libsecret</application>. Use this switch
229 if <application>libsecret</application> is not installed.
230 </para>
231
232 </sect2>
233
234 <sect2 role="content">
235 <title>Contents</title>
236
237 <segmentedlist>
238 <segtitle>Installed Programs</segtitle>
239 <segtitle>Installed Libraries</segtitle>
240 <segtitle>Installed Directories</segtitle>
241
242 <seglistitem>
243 <seg>
244 evince, evince-previewer, and evince-thumbnailer
245 </seg>
246 <seg>
247 libevdocument3.so,
248 libevview3.so, and
249 /usr/lib/nautilus/extensions-3.0/libevince-properties-page.so
250 </seg>
251 <seg>
252 /usr/{include,lib,share}/evince,
253 /usr/share/gtk-doc/html/{evince,libevdocument-3.0,libevview-3.0}, and
254 /usr/share/help/*/evince
255 </seg>
256 </seglistitem>
257 </segmentedlist>
258
259 <variablelist>
260 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
261 <?dbfo list-presentation="list"?>
262 <?dbhtml list-presentation="table"?>
263
264 <varlistentry id="evince-prog">
265 <term><command>evince</command></term>
266 <listitem>
267 <para>
268 is a multiple format document viewer
269 </para>
270 <indexterm zone="evince evince-prog">
271 <primary sortas="b-evince">evince</primary>
272 </indexterm>
273 </listitem>
274 </varlistentry>
275
276 <varlistentry id="evince-previewer">
277 <term><command>evince-previewer</command></term>
278 <listitem>
279 <para>
280 is an applicaton that implements the printing previewer
281 </para>
282 <indexterm zone="evince evince-previewer">
283 <primary sortas="b-evince-previewer">evince-previewer</primary>
284 </indexterm>
285 </listitem>
286 </varlistentry>
287
288 <varlistentry id="evince-thumbnailer">
289 <term><command>evince-thumbnailer</command></term>
290 <listitem>
291 <para>
292 is a simple program used to create thumbnail images of
293 supported documents
294 </para>
295 <indexterm zone="evince evince-thumbnailer">
296 <primary sortas="b-evince-thumbnailer">evince-thumbnailer</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 </variablelist>
302
303 </sect2>
304
305</sect1>
Note: See TracBrowser for help on using the repository browser.