From 65bbd6c7618c17adcfe741d07ef1643e2ed8c685 Mon Sep 17 00:00:00 2001 From: Alexander Larsson Date: Wed, 2 Oct 2019 14:08:28 +0200 Subject: [PATCH] update-portal: Update docs Mention permission issue and progress guarantees. --- data/org.freedesktop.portal.Flatpak.xml | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/data/org.freedesktop.portal.Flatpak.xml b/data/org.freedesktop.portal.Flatpak.xml index 9752c805..655861b4 100644 --- a/data/org.freedesktop.portal.Flatpak.xml +++ b/data/org.freedesktop.portal.Flatpak.xml @@ -241,6 +241,12 @@ signals will be emitted to communicate the status and progress. + Note that updates are only allowed if the new version + has the same permissions (or less) than the currently installed + version. If the new version requires a new permission then the + operation will fail with the error org.freedesktop.DBus.Error.NotSupported + and updates has to be done with the system tools. + Currently, no options are accepted. --> @@ -255,7 +261,9 @@ Gets emitted to indicate progress of the installation. It's undefined exactly how often this is sent, but it will be emitted - at least once at the end with non-zero status field. + at least once at the end with non-zero status field. For each + successful operation in the update we're also guaranteed to send + one (and only one) signal with progress 100. The following fields may be included in the info: