Changeset b69c81fa for pst/ps

Timestamp:

09/26/2023 11:39:07 PM (7 months ago)

Author:

Ken Moffat <ken@…>

Branches:

12.1, ken/TL2024, ken/tuningfonts, lazarus, plabs/newcss, python3.11, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18

Children:

ddb61e9

Parents:

9aa6fdb

Message:

Use the gtk3 fork of epdfview.

File:

• pst/ps/epdfview.xml (modified) (6 diffs)

pst/ps/epdfview.xml

@@ -5 +5 @@
   %general-entities;
 
-  <!ENTITY epdfview-download-http "&sources-anduin-http;/epdfview/epdfview-&epdfview-version;.tar.bz2">
+  <!ENTITY epdfview-download-http "&sources-anduin-http;/epdfview-gtk3/epdfview-&epdfview-version;.tar.xz">
   <!ENTITY epdfview-download-ftp  " ">
-  <!ENTITY epdfview-md5sum        "e50285b01612169b2594fea375f53ae4">
-  <!ENTITY epdfview-size          "456 KB">
-  <!ENTITY epdfview-buildsize     "6 MB">
-  <!ENTITY epdfview-time          "less than 0.1 SBU">
+  <!ENTITY epdfview-md5sum        "d222a3dc26c2faf6f862018bb478fb36">
+  <!ENTITY epdfview-size          "184 KB">
+  <!ENTITY epdfview-buildsize     "3.5 MB">
+  <!ENTITY epdfview-time          "less than 0.1 SBU (using parallelism=4)">
 ]>
 
@@ -24 +24 @@
 
   <sect2 role="package">
-    <title>Introduction to ePDFView</title>
-
-    <para>
-      <application>ePDFView</application> is a free standalone lightweight PDF
-      document viewer using <application>Poppler</application> and
-      <application>GTK+</application> libraries. It is a good replacement for
+    <title>Introduction to ePDFView-gtk3</title>
+
+    <para>
+      <application>ePDFView-gtk3</application> is a fork of the old
+      <application>ePDFView</application> program. Although the github repository
+      <ulink url="https://github.com/Flow-It/epdfview_old.git"/>  names it as
+      'old' it is indeed the gtk3 fork. It is a lightweight replacement for
       <application>Evince</application> as it does not rely upon
-      <application>GNOME</application> libraries.
+      <application>GNOME</application> libraries and is more capable than
+      <application>MuPDF</application>.
     </para>
 
@@ -70 +72 @@
     </itemizedlist>
 
-    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
-    <itemizedlist spacing='compact'>
-      <listitem>
-        <para>
-          Required patch: <ulink url=
-          "&patch-root;/epdfview-&epdfview-version;-fixes-2.patch"/>
-        </para>
-      </listitem>
-    </itemizedlist>
-
     <bridgehead renderas="sect3">ePDFView Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
-      <xref linkend="gtk2"/> and
+      <xref linkend="gtk3"/> and
       <xref linkend="poppler"/>
     </para>
 
-    <bridgehead renderas="sect4">Recommended (mainly for
-    Desktop Environments)</bridgehead>
+    <bridgehead renderas="sect4">Recommended</bridgehead>
     <para role="Recommended">
+      <xref linkend="cups"/> (to access print queues)
       <xref linkend="desktop-file-utils"/> and
-      <xref linkend="hicolor-icon-theme"/>
+      <xref linkend="hicolor-icon-theme"/> (both for the icons this installs)
     </para>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
-      <xref linkend="cups"/>
-    </para>
-
+      The home page of the project's repository mentions that there are optional
+      dependencies, enabled by switches, for building the documentation and testsuite,
+      <xref linkend="doxygen"/> and
+      <ulink url='https://freedesktop.org/wiki/Software/cppunit/'>Cppunit</ulink>.
+      Unfortunately <application>doxygen</application> only installs a skeletal
+      page about itself, not any package documentation, and the test code does not
+      compile with tecent versions of C++.
+    </para>
   </sect2>
 
   <sect2 role="installation">
-    <title>Installation of ePDFView</title>
-
-    <para>
-      Install <application>ePDFView</application> by running the following
+    <title>Installation of ePDFView-gtk3</title>
+
+    <para>
+      Install <application>ePDFView-gtk3</application> by running the following
       commands:
     </para>
 
-<screen><userinput>patch -Np1 -i ../epdfview-&epdfview-version;-fixes-2.patch &amp;&amp;
-./configure --prefix=/usr &amp;&amp;
-make</userinput></screen>
-
-    <para>
-      This package does not come with a test suite.
+<screen><userinput>
+mkdir build &amp;&amp;
+cd build    &amp;&amp;
+
+meson setup --prefix=/usr           \
+            --buildtype=release     \
+            --Denable-printing=true \
+            ..                     &amp;&amp;
+ninja</userinput></screen>
+
+    <para>
+      This package does not come with a buildable test suite.
     </para>
 
@@ -122 +125 @@
     </para>
 
-<screen role="root"><userinput>make install</userinput></screen>
-
-    <para>
-      For Desktop Environment users, further (optional) instructions are necessary for properly displaying <filename>epdfview.desktop</filename> in the menu. As <systemitem class="username">root</systemitem> user:
-    </para>
-
-<screen role="root"><userinput>for size in 24 32 48; do
-  ln -svf ../../../../epdfview/pixmaps/icon_epdfview-$size.png \
-          /usr/share/icons/hicolor/${size}x${size}/apps
-done &amp;&amp;
-unset size &amp;&amp;
-
-update-desktop-database &amp;&amp;
+<screen role="root"><userinput>
+ninja install                                                            &amp;&amp;
+update-desktop-database                                                  &amp;&amp;
 gtk-update-icon-cache -t -f --include-image-data /usr/share/icons/hicolor</userinput></screen>
 
@@ -141 +134 @@
   <sect2 role="commands">
     <title>Command Explanations</title>
-
-<!-- keep this in case the patch breaks builds without cups
-    <para>
-      <command>sed -i 's#/gmacros##' src/gtk/StockIcons.h</command>: This sed
-      fixes compiling with <application>glib-2.32</application> or greater.
-    </para> -->
-
-    <para>
-      <command>patch -Np1 -i ../epdfview-&epdfview-version;-fixes-2.patch</command>
-      The patch does four things: fixes compiling with
-      <application>glib-2.32</application> or greater, corrects red appearing as
-      blue with recent versions of <application>poppler</application>, allows
-      the application to compile when <xref linkend="cups"/> has been installed,
-      and fixes the display of embedded png images.
-    </para>
+    <para>
+      <command>--Denable-printing=true</command>: build the code to link to the
+      <application>cups</application> print queue(s). Omit this if you have not
+      installed <application>cups</application>.
+    </para>
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring ePDFView-gtk3</title>
+
+      <para>
+        ePDFView-gtk3 has several toggles for optional features, most are
+        'off' by default, including the toolbar, and if it has been closed with
+         the menu disabled the program can start with all options not visible
+         until the relevant function-key toggles are pressed.           
+        <itemizedlist>
+          <listitem>
+            <para>[F6] - toggle toolbar</para>
+          </listitem>
+          <listitem>
+            <para>[F7] - toggle menu</para>
+          </listitem>
+          <listitem>
+            <para>[F8] - toggle invert-colors</para>
+          </listitem>
+          <listitem>
+            <para>[F9] - toggle show-index.</para>
+          </listitem>
+          <listitem>
+            <para>[F11] - toggle fullscreen.</para>
+          </listitem>
+        </itemizedlist>
+      </para>
+
   </sect2>
 
@@ -182 +194 @@
         <listitem>
           <para>
-            is a <application>Gtk+-2</application> program for viewing PDF
+            is a <application>Gtk+-3</application> program for viewing PDF
             documents
           </para>