mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-02-04 07:17:15 +08:00
283 lines
9.5 KiB
XML
283 lines
9.5 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;
|
|
|
|
<!ENTITY xdg-desktop-portal-download-http "https://github.com/flatpak/xdg-desktop-portal/releases/download/&xdg-desktop-portal-version;/xdg-desktop-portal-&xdg-desktop-portal-version;.tar.xz">
|
|
<!ENTITY xdg-desktop-portal-download-ftp " ">
|
|
<!ENTITY xdg-desktop-portal-md5sum "20e0b28c1528e57b13cc236ba7840e03">
|
|
<!ENTITY xdg-desktop-portal-size "683 KB">
|
|
<!ENTITY xdg-desktop-portal-buildsize "45 MB (with tests)">
|
|
<!ENTITY xdg-desktop-portal-time "?? SBU">
|
|
]>
|
|
|
|
<sect1 id="xdg-desktop-portal" xreflabel="xdg-desktop-portal-&xdg-desktop-portal-version;">
|
|
<?dbhtml filename="xdg-desktop-portal.html"?>
|
|
|
|
<title>xdg-desktop-portal-&xdg-desktop-portal-version;</title>
|
|
|
|
<indexterm zone="xdg-desktop-portal">
|
|
<primary sortas="a-xdg-desktop-portal">xdg-desktop-portal</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title>Introduction to xdg-desktop-portal</title>
|
|
|
|
<para>
|
|
<application>xdg-desktop-portal</application> is a D-Bus service that
|
|
allows applications to interact with the desktop in a safe way. Several
|
|
aspects of desktop interaction, like file chooser, desktop style, etc
|
|
are implmented in different D-Bus APIs, known as
|
|
<emphasis>portals</emphasis>. Sandboxed
|
|
applications benefit the most from this service since they don't need
|
|
special permissions to use the portal APIs, but any application can use
|
|
it. <application>xdg-desktop-portal</application> safeguards many
|
|
resources and features with a user-controlled permission system. This
|
|
service needs a backend implementing desktop-specific portal interfaces.
|
|
</para>
|
|
|
|
&lfs120_checked;
|
|
|
|
<bridgehead renderas="sect3">Package Information</bridgehead>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>
|
|
Download (HTTP): <ulink url="&xdg-desktop-portal-download-http;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download (FTP): <ulink url="&xdg-desktop-portal-download-ftp;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download MD5 sum: &xdg-desktop-portal-md5sum;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download size: &xdg-desktop-portal-size;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated disk space required: &xdg-desktop-portal-buildsize;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated build time: &xdg-desktop-portal-time;
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<!--
|
|
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>
|
|
Required patch:
|
|
<ulink url="&patch-root;/xdg-desktop-portal-&xdg-desktop-portal-version;-patch_name-patch_version.patch"/>
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
-->
|
|
<bridgehead renderas="sect3">xdg-desktop-portal Dependencies</bridgehead>
|
|
|
|
<bridgehead renderas="sect4">Required</bridgehead>
|
|
<para role="required">
|
|
<xref linkend="fuse3"/>,
|
|
<xref linkend="gdk-pixbuf"/>,
|
|
<xref linkend="json-glib"/>,
|
|
<xref linkend="pipewire"/>, and
|
|
<xref role="runtime" linkend="dbus"/> (at runtime)
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Recommended</bridgehead>
|
|
<para role="recommended">
|
|
<xref linkend="bubblewrap"/> and
|
|
<xref linkend="docutils"/> (for building the manual pages)
|
|
</para>
|
|
|
|
<note>
|
|
<para>
|
|
Although there is an option to build the package
|
|
without <application>bubblewrap</application>, upstream
|
|
developers and LFS editors alike highly recommend to not
|
|
use this possibility, that would create a big security
|
|
hole.
|
|
</para>
|
|
</note>
|
|
|
|
<bridgehead renderas="sect4">Optional</bridgehead>
|
|
<para role="optional">
|
|
<xref linkend="geoclue2"/> (for the <quote>location</quote> portal), and
|
|
<xref linkend="pytest"/> with
|
|
<xref linkend="libportal"/> (for running tests)
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Optional (for building
|
|
the documentation)</bridgehead>
|
|
<para role="optional">
|
|
<xref linkend="sphinx"/> with
|
|
<ulink url="https://pypi.org/project/sphinxext-opengraph/">sphinxext.opengraph</ulink>,
|
|
<ulink url="https://pypi.org/project/sphinx-copybutton/">sphinx_copybutton</ulink>,
|
|
<ulink url="https://pypi.org/project/furo/">furo</ulink>, and
|
|
<ulink url="https://github.com/flatpak/flatpak">flatpak</ulink>
|
|
</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of xdg-desktop-portal</title>
|
|
|
|
<para>
|
|
Install <application>xdg-desktop-portal</application> by running the
|
|
following commands:
|
|
</para>
|
|
|
|
<screen><userinput>mkdir build &&
|
|
cd build &&
|
|
|
|
meson setup .. --prefix=/usr &&
|
|
ninja</userinput></screen>
|
|
|
|
<para>
|
|
If you have installed the needed dependencies, you can test the results
|
|
with: <command>ninja test</command>.
|
|
</para>
|
|
|
|
<para>
|
|
Now, as the &root; user:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>ninja install</userinput></screen>
|
|
|
|
<para revision="sysv">
|
|
Remove systemd files that are useless: as the &root; user:
|
|
</para>
|
|
|
|
<screen role="root" revision="sysv"><userinput>rm -rvf /usr/lib/systemd</userinput></screen>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="configuration">
|
|
<title>Configuring xdg-desktop-portal</title>
|
|
|
|
<sect3 id="xdg-desktop-portal-config">
|
|
<title>Config Files</title>
|
|
<para>
|
|
The main configuration files are
|
|
<filename>~/.config/xdg-desktop-portal/portals.conf</filename>,
|
|
<filename>/etc/xdg-desktop-portal/portals.conf</filename>, and
|
|
<filename>/usr/share/xdg-desktop-portal/portals.conf</filename>.
|
|
Several other locations can be searched for configuration files. See
|
|
<filename>portals.conf(5)</filename>.
|
|
</para>
|
|
|
|
<indexterm zone="xdg-desktop-portal xdg-desktop-portal-config">
|
|
<primary sortas="e-AA.config-xdg-desktop-portal-portals.conf">~/.config/xdg-desktop-portal/portals.conf</primary>
|
|
</indexterm>
|
|
|
|
<indexterm zone="xdg-desktop-portal xdg-desktop-portal-config">
|
|
<primary
|
|
sortas="e-etc-xdg-desktop-portal-portals.conf">/etc/xdg-desktop-portal/portals.conf</primary>
|
|
</indexterm>
|
|
|
|
<indexterm zone="xdg-desktop-portal xdg-desktop-portal-config">
|
|
<primary
|
|
sortas="e-usr-share-xdg-desktop-portal-portals.conf">/usr/share/xdg-desktop-portal/portals.conf</primary>
|
|
</indexterm>
|
|
</sect3>
|
|
|
|
<sect3><title>Configuration Information</title>
|
|
|
|
<para>
|
|
The various configuration files are used to choose the backend
|
|
depending of various conditions. See
|
|
<filename>portals.conf(5)</filename> for details.
|
|
</para>
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="content">
|
|
<title>Contents</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed Programs</segtitle>
|
|
<segtitle>Installed Librar(y,ies)</segtitle>
|
|
<segtitle>Installed Director(y,ies)</segtitle>
|
|
|
|
<!-- If there were no programs, libraries, or directories created, then
|
|
we would list the section as "None". However, a decision must have
|
|
been made to change the "None" to just removing the whole section
|
|
because I've noticed that many packages have had the "None"
|
|
removed and the section completely removed as well. The reasoning
|
|
was that by putting "None", it appears as if we know there are none.
|
|
Without anything it appears as we are not sure. -->
|
|
|
|
<seglistitem>
|
|
<seg>
|
|
several daemons in /usr/libexec
|
|
</seg>
|
|
<seg>
|
|
None
|
|
</seg>
|
|
<seg>
|
|
None
|
|
</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
<!--
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<!- - If the program or library name conflicts with (is the same as) the
|
|
package name, add -prog or -lib to the varlistentry entity id
|
|
and the 2nd entry of the indexterm zone entity - ->
|
|
|
|
<varlistentry id="PROGRAM1">
|
|
<term><command>PROGRAM1</command></term>
|
|
<listitem>
|
|
<para>
|
|
does this ..... (no period at the end)
|
|
</para>
|
|
<indexterm zone="xdg-desktop-portal PROGRAM1">
|
|
<primary sortas="b-PROGRAM1">PROGRAM1</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="PROGRAM2">
|
|
<term><command>PROGRAM2</command></term>
|
|
<listitem>
|
|
<para>
|
|
does this ..... (no period at the end)
|
|
</para>
|
|
<indexterm zone="xdg-desktop-portal PROGRAM2">
|
|
<primary sortas="b-PROGRAM2">PROGRAM2</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libLIBRARY1">
|
|
<term><filename class="libraryfile">libLIBRARY1.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains functions that ..... (no period at the end)
|
|
</para>
|
|
<indexterm zone="xdg-desktop-portal libLIBRARY1">
|
|
<primary sortas="c-libLIBRARY1">libLIBRARY1.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
-->
|
|
</sect2>
|
|
</sect1>
|