Bug#1050928: enlightenment-data: please provide an enlightenment-portals.conf for xdg-desktop-portal

[Simon McVittie]

Package: enlightenment-data
Severity: normal
Tags: trixie sid
User: xdg-desktop-portal at packages.debian.org
Usertags: portals.conf

xdg-desktop-portal 1.17.x introduces a new way to select which portals will
be used for which desktop environments, modelled on mimeapps.list:

- each desktop environment should provide a file like
  /usr/share/xdg-desktop-portal/enlightenment-portals.conf

- the filename is ${DESKTOP}-portals.conf where ${DESKTOP} is the desktop
  environment's entry in $XDG_CURRENT_DESKTOP (the same as the DesktopNames
  from /usr/share/{x,wayland-}sessions/*.desktop), folded to lower case

- sysadmins and users can override this via files named portals.conf or
  ${DESKTOP}-portals.conf in various locations like /etc/xdg-desktop-portal
  and ~/.config/xdg-desktop-portal

Please see portals.conf(5) or its source code
https://github.com/flatpak/xdg-desktop-portal/blob/main/doc/portals-conf.rst
for full details.

If I'm reading its code correctly, I think Enlightenment asks the display manager
to set XDG_CURRENT_DESKTOP to "Enlightenment"? (But if I'm wrong, please
adjust my suggestions accordingly.)

As a backwards-compatibility mechanism, x-d-p will fall back to trying to
guess the most appropriate portals from the portals' deprecated UseIn=
fields, but it will log warnings when it does that, and anyway Debian
doesn't currently ship any portal backends that are flagged as suitable
for Enlightenment. Please add an enlightenment-portals.conf to tell x-d-p
more explicitly what backends Enlightenment is meant to be using by default.

At the moment x-d-p is hard-coded to fall back to the x-d-p-gtk backend
if nothing more suitable is found, but that's a short-term hack which
we should remove before trixie.

For example, if the intention is that Enlightenment should be using the
x-d-p-gtk backend, the way to write that would be:

[preferred]
default=gtk;

The desktop environment (either enlightenment-data or some larger
metapackage) should probably also have a Recommends, or at least a
Suggests, on whatever portals would be most appropriate for it.

Thanks,
    smcv

-- 
This is part of a mass bug filing:
https://lists.debian.org/debian-devel/2023/08/msg00311.html