Accepting request 1233591 from GNOME:Factory

OBS-URL: https://build.opensuse.org/request/show/1233591
OBS-URL: https://build.opensuse.org/package/show/openSUSE:Factory/xdg-desktop-portal?expand=0&rev=42

_multibuild

@@ -0,0 +1,3 @@
+<multibuild>
+  <package>docs</package>
+</multibuild>

xdg-desktop-portal-1.19.0.tar.xz

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7f0cf40bfa9633020854a431ed694a3c4038d2d3b2af92e8d99e255b65e395a1
+size 1145912

xdg-desktop-portal.changes

@@ -1,3 +1,68 @@
+-------------------------------------------------------------------
+Thu Dec 19 16:43:17 UTC 2024 - Frederic Crozat <fcrozat@suse.com>
+
+- Create a doc flavor for building developer documentation.
+
+-------------------------------------------------------------------
+Wed Dec 11 13:06:00 UTC 2024 - Frederic Crozat <fcrozat@suse.com>
+
+- Update to 1.19.0:
+  + The portals.conf parser is now able to handle fallback backends
+    better, and respects the order of backends in the config file.
+  + Try to use the xdg-desktop-portal-gtk backend as a last resort
+    backend, if everything else fails.
+  + Implement getlk and setlk, and honour O_NOFOLLOW, in the
+    Document portal's FUSE filesystem.
+  + Neutralize the Devices portal. Originally the Devices portal
+    was introduced so that services like PulseAudio or PipeWire
+    could request access to microphones and cameras on the behalf
+    of apps. It was not meant to be used by sandboxed apps
+    directly, which is unusual for a portal. Practically, however,
+    it didn't take off.
+  + Implement PID/TID mapping for host system apps.
+  + Add a new "supported_output_file_formats" option to the Print
+    portal. This can be used by apps like browsers to limit the
+    output file formats presented by the Print portal backend. For
+    example, an app can limit file printing to PDF files.
+  + Add a new "GetHostPaths" method to the Document portal, which
+    allows mapping file descriptors to paths on the host system.
+    This can be used by apps to show more meaningful file paths in
+    the user interface.
+  + Like the new method above, the Document portal sets the
+    "user.document-portal.host-path" xattr on files, pointing to
+    the host system file path. The use case is similar to
+    "GetHostPaths".
+  + Make the Background portal more robust when validating
+    autostart files.
+  + Clarify behavior of the File Chooser portal in the
+    documentation pages.
+  + Improve robustness against deleted o_path fds in the Document
+    portal.
+  + Fix a warning in some systems while trying to load Request
+    D-Bus object properties.
+  + Fix a physical inode leak in the Document portal.
+  + Various improvements to the test suite. Python-based tests now
+    run in parallel and are more careful when setting up the mock
+    D-Bus server. Tests also start dbus-monitor if necessary now.
+    FUSE tests of the Document portal have been made more
+    TAP-alike now.
+  + Memory leak fixes in a variety of portals and services,
+    including the permissions database, the Document portal, the
+    File Transfer portal, the Location portal, the Background
+    portal, tests, and the icon validator. And more. There's a lot
+    of memory leak fixes everywhere, really.
+  + Major refactorings of the icon validator. Icons are now
+    limited to 4MB files.
+  + Update XML specification specifying session handle type to
+    match current actual ABI in GlobalShortcuts, Inhibit,
+    RemoteDesktop, and ScreenCast portals.
+  + New and updated translations.
+- Adapt BuildRequires for new documentation build process:
+  + Add python3-Sphinx
+  + Add python3-furo
+  + Add python3-sphinxcontrib-copybutton
+  + Add python3-sphinxext-opengraph
+
 -------------------------------------------------------------------
 Sat May 18 15:53:53 UTC 2024 - Andreas Stieger <andreas.stieger@gmx.de>
 

xdg-desktop-portal.spec

@@ -1,7 +1,7 @@
 #
 # spec file for package xdg-desktop-portal
 #
-# Copyright (c) 2023 SUSE LLC
+# Copyright (c) 2024 SUSE LLC
 # Copyright (c) 2024 Andreas Stieger <Andreas.Stieger@gmx.de>
 #
 # All modifications and additions to the file contributed by third parties
@@ -17,18 +17,41 @@
 #
 
 
-Name:           xdg-desktop-portal
+%global flavor @BUILD_FLAVOR@%{nil}
-Version:        1.18.4
+%if "%{flavor}" == "docs"
+%bcond_without  docs
+%define psuffix -devel-docs
+%else
+%bcond_with     docs
+%endif
+
+%define oname xdg-desktop-portal
+
+Name:           %{oname}%{?psuffix}
+Version:        1.19.0
 Release:        0
+%if "%{flavor}" == ""
 Summary:        A portal frontend service for Flatpak
-License:        LGPL-2.1-or-later
 Group:          System/Libraries
+%else
+Summary:        Development documentation for xdg-desktop-portal
+Group:          Documentation/HTML
+Supplements:    (%{oname}-devel and patterns-base-documentation)
+%endif
+License:        LGPL-2.1-or-later
 URL:            https://github.com/flatpak/xdg-desktop-portal
-Source0:        %{url}/releases/download/%{version}/%{name}-%{version}.tar.xz
+Source0:        %{url}/releases/download/%{version}/%{oname}-%{version}.tar.xz
 
 BuildRequires:  docutils
 BuildRequires:  meson >= 0.58
 BuildRequires:  pkgconfig
+
+%if %{with docs}
+BuildRequires:  python3-Sphinx
+BuildRequires:  python3-furo
+BuildRequires:  python3-sphinxcontrib-copybutton
+BuildRequires:  python3-sphinxext-opengraph
+%endif
 BuildRequires:  systemd-rpm-macros
 BuildRequires:  xmlto
 BuildRequires:  pkgconfig(flatpak)
@@ -44,10 +67,11 @@ BuildRequires:  pkgconfig(libportal)
 BuildRequires:  pkgconfig(libsystemd)
 # Break cycle: we buildrequire flatpak, and flatpak has a requires on xdg-desktop-portal
 #!BuildIgnore:  xdg-desktop-portal
-# xdg-dfesktop-portal calls out to fusermount3 (in $PATH) (boo#1197567)
+# xdg-desktop-portal calls out to fusermount3 (in $PATH) (boo#1197567)
 # document-portal/document-portal-fuse.c: char *umount_argv[] = { "fusermount3", "-u", "-z", (char *) path, NULL };
 Requires:       %{_bindir}/fusermount3
 
+%if "%{flavor}" == ""
 %description
 A portal frontend service for Flatpak and possibly other desktop containment frameworks.
 
@@ -69,13 +93,24 @@ a well-known name (org.freedesktop.portal.Desktop) and object path (/org/freedes
 
 This package contains convenience files for developers.
 
+%else
+
+%description
+A portal frontend service for Flatpak and possibly other desktop containment frameworks.
+
+xdg-desktop-portal works by exposing a series of D-Bus interfaces known as portals under
+a well-known name (org.freedesktop.portal.Desktop) and object path (/org/freedesktop/portal/desktop).
+
+This package contains convenience documentation for developers.
+%endif
+
 %lang_package
 
 %prep
-%autosetup -p1
+%autosetup -p1 -n %{oname}-%{version}
 
 %build
-%meson \
+%meson %{!?with_docs:-Ddocumentation=disabled} \
 	-Dpytest=disabled \
 	%{nil}
 %meson_build
@@ -85,9 +120,13 @@ This package contains convenience files for developers.
 
 # own the packaging directories
 install -d %{buildroot}%{_datadir}/xdg-desktop-portal/portals
+%if %{with docs}
+rm -fr %{buildroot}/%{_datadir}/{dbus-1,%{oname},locale,pkgconfig} %buildroot%{_userunitdir} %{buildroot}%{_mandir} %{buildroot}/%{_libdir} %{buildroot}/%{_libexecdir}
+%else
+%find_lang %{oname} %{?no_lang_C}
+%endif
 
-%find_lang %{name} %{?no_lang_C}
+%if "%{flavor}" == ""
-
 %post
 %systemd_user_post %{name}.service xdg-document-portal.service xdg-permission-store.service
 
@@ -118,7 +157,6 @@ install -d %{buildroot}%{_datadir}/xdg-desktop-portal/portals
 
 %files devel
 %license COPYING
-%doc %{_datadir}/doc/%{name}/
 %if %{pkg_vcmp meson < 0.62.0 }
 %{_libdir}/pkgconfig/%{name}.pc
 %else
@@ -128,4 +166,10 @@ install -d %{buildroot}%{_datadir}/xdg-desktop-portal/portals
 %files lang -f %{name}.lang
 %license COPYING
 
+%else
+
+%files
+%doc %{_vpath_builddir}/doc/html
+%endif
+
 %changelog