From c21f9a8ab62679be5e8a1c4e7c30f3e263d86856 Mon Sep 17 00:00:00 2001 From: Gabriel Dougherty Date: Mon, 2 May 2022 12:24:56 -0400 Subject: [PATCH 1/3] Explain downgrade of per-user installs This improves the package downgrade documentation by explaining how to downgrade packages that were installed per-user. --- docs/tips-and-tricks.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/tips-and-tricks.rst b/docs/tips-and-tricks.rst index 3ab32157..2c49e076 100644 --- a/docs/tips-and-tricks.rst +++ b/docs/tips-and-tricks.rst @@ -41,6 +41,16 @@ Then you deploy the commit:: --commit=ec07ad6c54e803d1428e5580426a41315e50a14376af033458e7a65bfb2b64f0 \ org.gnome.Recipes +If the application is installed per-user, you will get the error:: + + error: org.gnome.Recipes not installed + +In that case, omit `sudo` from the command:: + + $ flatpak update \ + --commit=ec07ad6c54e803d1428e5580426a41315e50a14376af033458e7a65bfb2b64f0 \ + org.gnome.Recipes + If you have Flatpak 1.5.0 or later, you can also prevent the app from being included in updates (either manual or automatic):: From 5f1be7365919f8cbbe7f980321a94073ca3ed861 Mon Sep 17 00:00:00 2001 From: Gabriel Dougherty Date: Wed, 4 May 2022 09:17:41 -0400 Subject: [PATCH 2/3] Update docs/tips-and-tricks.rst Co-authored-by: Patrick --- docs/tips-and-tricks.rst | 12 ++---------- 1 file changed, 2 insertions(+), 10 deletions(-) diff --git a/docs/tips-and-tricks.rst b/docs/tips-and-tricks.rst index 2c49e076..2a8a7ce9 100644 --- a/docs/tips-and-tricks.rst +++ b/docs/tips-and-tricks.rst @@ -41,16 +41,8 @@ Then you deploy the commit:: --commit=ec07ad6c54e803d1428e5580426a41315e50a14376af033458e7a65bfb2b64f0 \ org.gnome.Recipes -If the application is installed per-user, you will get the error:: - - error: org.gnome.Recipes not installed - -In that case, omit `sudo` from the command:: - - $ flatpak update \ - --commit=ec07ad6c54e803d1428e5580426a41315e50a14376af033458e7a65bfb2b64f0 \ - org.gnome.Recipes - +.. note:: + The example here uses ``sudo`` for system installations because, unlike normal updates, downgrades are considered a privileged action. If the application is installed per-user you would run it as that user. If you have Flatpak 1.5.0 or later, you can also prevent the app from being included in updates (either manual or automatic):: From 550c9fd0d65a79b429a2cbb88aeb1a4aa763ae26 Mon Sep 17 00:00:00 2001 From: Patrick Date: Wed, 4 May 2022 10:52:57 -0500 Subject: [PATCH 3/3] Update docs/tips-and-tricks.rst --- docs/tips-and-tricks.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/tips-and-tricks.rst b/docs/tips-and-tricks.rst index 2a8a7ce9..a0e1250a 100644 --- a/docs/tips-and-tricks.rst +++ b/docs/tips-and-tricks.rst @@ -42,7 +42,9 @@ Then you deploy the commit:: org.gnome.Recipes .. note:: + The example here uses ``sudo`` for system installations because, unlike normal updates, downgrades are considered a privileged action. If the application is installed per-user you would run it as that user. + If you have Flatpak 1.5.0 or later, you can also prevent the app from being included in updates (either manual or automatic)::