Changes in general/genlib/libportal.xml [20a35ab:c5408a2]

File:

• general/genlib/libportal.xml (modified) (9 diffs)

general/genlib/libportal.xml

@@ -7 +7 @@
   <!ENTITY libportal-download-http "https://github.com/flatpak/libportal/releases/download/&libportal-version;/libportal-&libportal-version;.tar.xz">
   <!ENTITY libportal-download-ftp  " ">
-  <!ENTITY libportal-md5sum        "2ca3806e18e2197dd87d22379405a624">
-  <!ENTITY libportal-size          "52 KB">
-  <!ENTITY libportal-buildsize     "3.6 MB">
+  <!ENTITY libportal-md5sum        "e16c8ca2621aff64774a1d2ad6a2a346">
+  <!ENTITY libportal-size          "64 KB">
+  <!ENTITY libportal-buildsize     "2.9 MB">
   <!ENTITY libportal-time          "0.1 SBU">
-
 ]>
 
@@ -17 +16 @@
   <?dbhtml filename="libportal.html"?>
 
-  <sect1info>
-    <date>$Date$</date>
-  </sect1info>
 
   <title>libportal-&libportal-version;</title>
@@ -35 +31 @@
     </para>
 
-    &lfs110a_checked;
+    &lfs112_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
@@ -75 +71 @@
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
-      <xref linkend="glib2"/>
+      <xref linkend="gobject-introspection"/>
+    </para>
+
+    <bridgehead renderas="sect4">Recommended</bridgehead>
+    <para role="recommended">
+      <xref linkend="gtk3"/>,
+      <xref linkend="gtk4"/>, and
+      <xref linkend="qt5"/>
     </para>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
-      <xref linkend="gtk-doc"/>
-    </para>
-
+      <xref linkend="vala"/> and
+      <ulink url="&gi-docgen-url;">gi-docgen</ulink>
+    </para>
 
     <para condition="html" role="usernotes">
@@ -92 +95 @@
     <title>Installation of libportal</title>
 
+    <warning>
+      <para>
+        If a previous version of libportal is installed, move the
+        headers out of the way so that later packages do not encounter
+        conflicts (as the <systemitem role="username">root</systemitem>
+        user):
+      </para>
+<screen role="root"><userinput>if [ -e /usr/include/libportal ]; then
+    rm -rf /usr/include/libportal.old &amp;&amp;
+    mv -vf /usr/include/libportal{,.old}
+fi</userinput></screen>
+    </warning>
+
     <para>
       Install <application>libportal</application> by running the following
@@ -100 +116 @@
 cd    build &amp;&amp;
 
-meson --prefix=/usr --buildtype=release -Dgtk_doc=false .. &amp;&amp;
+meson --prefix=/usr --buildtype=release -Ddocs=false .. &amp;&amp;
 ninja</userinput></screen>
 
@@ -121 +137 @@
 
     <para>
-      <parameter>-Dgtk_doc=false</parameter>: Remove this parameter if
-      <application>GTK-Doc</application> is installed and you wish to rebuild
+      <parameter>-Ddocs=false</parameter>: Remove this parameter if
+      <application>gi-docgen</application> is installed and you wish to rebuild
       and install the API documentation.
+    </para>
+
+    <para>
+      <option>-Dbackends=gtk3,gtk4,qt5</option>: This switch allows you to set
+      the available backends. You can use it to disable the dependency on gtk-3,
+      gtk-4, or qt-5. Most applications that use libportal will use either
+      gtk-4 or gtk-3. The default is to build all three backends.
     </para>
 
@@ -140 +163 @@
         </seg>
         <seg>
-          libportal.so
+          libportal.so,
+          libportal-gtk3.so,
+          libportal-gtk4.so, and
+          libportal-qt5.so
         </seg>
         <seg>
@@ -165 +191 @@
         </listitem>
       </varlistentry>
+
+      <varlistentry id="libportal-gtk3">
+        <term><filename class="libraryfile">libportal-gtk3.so</filename></term>
+        <listitem>
+          <para>
+            provides GTK+-3 specific functions for interacting with Flatpak
+            portals.
+          </para>
+          <indexterm zone="libportal libportal-gtk3">
+            <primary sortas="c-libportal-gtk3">libportal-gtk3.so</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="libportal-gtk4">
+        <term><filename class="libraryfile">libportal-gtk4.so</filename></term>
+        <listitem>
+          <para>
+            provides GTK-4 specific functions for interacting with Flatpak
+            portals.
+          </para>
+          <indexterm zone="libportal libportal-gtk4">
+            <primary sortas="c-libportal-gtk4">libportal-gtk4.so</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="libportal-qt5">
+        <term><filename class="libraryfile">libportal-qt5.so</filename></term>
+        <listitem>
+          <para>
+            provides Qt5 specific functions for interacting with Flatpak
+            portals.
+          </para>
+          <indexterm zone="libportal libportal-qt5">
+            <primary sortas="c-libportal-qt5">libportal-qt5.so</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect2>