mirror/flatpak
1
0
Fork 0
mirror of https://github.com/flatpak/flatpak.git synced 2026-03-16 06:02:13 -04:00
Code Issues Packages Projects Releases Wiki Activity

FlatpakInstallation: Mark non-transaction install/update ops deprecated

Browse Source 
These versions still work, but they don't do neearly as much as you'd
want (depdendencies and whatnot), so document this.
This commit is contained in:
Alexander Larsson
2020-03-25 08:20:18 +01:00
parent 1117f0d872
commit 102c710b39
1 changed files with 40 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

40
common/flatpak-installation.c
View File

@@ -1285,6 +1285,10 @@ list_remotes_for_configured_remote (const gchar *remote_name,
*
* Lists only the remotes whose type is included in the @types argument.
*
* Since flatpak 1.7 this will never return any types except FLATPAK_REMOTE_TYPE_STATIC.
* Equivalent functionallity to FLATPAK_REMOTE_TYPE_USB can be had by listing remote refs
* with FLATPAK_QUERY_FLAGS_ONLY_SIDELOADED.
*
* Returns: (transfer container) (element-type FlatpakRemote): a GPtrArray of
* #FlatpakRemote instances
*/
@@ -1816,6 +1820,10 @@ flatpak_installation_load_app_overrides (FlatpakInstallation *self,
* @cancellable: (nullable): a #GCancellable
* @error: return location for a #GError
*
* This is and old deprecated function, you should use
* #FlatpakTransaction and flatpak_transaction_add_install_bundle()
* instead. It has a lot more interesting features.
*
* Install an application or runtime from an flatpak bundle file.
* See flatpak-build-bundle(1) for how to create bundles.
*
@@ -1874,6 +1882,10 @@ flatpak_installation_install_bundle (FlatpakInstallation *self,
* @cancellable: (nullable): a #GCancellable
* @error: return location for a #GError
*
* This is and old deprecated function, you should use
* #FlatpakTransaction and flatpak_transaction_add_install_flatpakref()
* instead. It has a lot more interesting features.
*
* Creates a remote based on the passed in .flatpakref file contents
* in @ref_file_data and returns the #FlatpakRemoteRef that can be used
* to install it.
@@ -1932,6 +1944,9 @@ flatpak_installation_install_ref_file (FlatpakInstallation *self,
* @cancellable: (nullable): a #GCancellable
* @error: return location for a #GError
*
* This is and old deprecated function, you should use
* #FlatpakTransaction and flatpak_transaction_add_install()
* instead. It has a lot more interesting features.
* Install a new application or runtime.
*
* Note that this function was originally written to always return a
@@ -2038,6 +2053,11 @@ flatpak_installation_install_full (FlatpakInstallation *self,
* @cancellable: (nullable): a #GCancellable
* @error: return location for a #GError
*
* This is and old deprecated function, you should use
* #FlatpakTransaction and flatpak_transaction_add_install()
* instead. It has a lot more interesting features.
* Install a new application or runtime.
*
* Install a new application or runtime.
*
* Note that this function was originally written to always return a
@@ -2082,6 +2102,11 @@ flatpak_installation_install (FlatpakInstallation *self,
* @cancellable: (nullable): a #GCancellable
* @error: return location for a #GError
*
* This is and old deprecated function, you should use
* #FlatpakTransaction and flatpak_transaction_add_update()
* instead. It has a lot more interesting features.
* Install a new application or runtime.
*
* Update an application or runtime.
*
* If the specified package is not installed, then %FLATPAK_ERROR_NOT_INSTALLED
@@ -2199,6 +2224,11 @@ flatpak_installation_update_full (FlatpakInstallation *self,
* @cancellable: (nullable): a #GCancellable
* @error: return location for a #GError
*
* This is and old deprecated function, you should use
* #FlatpakTransaction and flatpak_transaction_add_update()
* instead. It has a lot more interesting features.
* Install a new application or runtime.
*
* Update an application or runtime.
*
* If the specified package is not installed, then %FLATPAK_ERROR_NOT_INSTALLED
@@ -2240,6 +2270,11 @@ flatpak_installation_update (FlatpakInstallation *self,
* @cancellable: (nullable): a #GCancellable
* @error: return location for a #GError
*
* This is and old deprecated function, you should use
* #FlatpakTransaction and flatpak_transaction_add_unintstall()
* instead. It has a lot more interesting features.
* Install a new application or runtime.
*
* Uninstall an application or runtime.
*
* Returns: %TRUE on success
@@ -2276,6 +2311,11 @@ flatpak_installation_uninstall (FlatpakInstallation *self,
* @cancellable: (nullable): a #GCancellable
* @error: return location for a #GError
*
* This is and old deprecated function, you should use
* #FlatpakTransaction and flatpak_transaction_add_unintstall()
* instead. It has a lot more interesting features.
* Install a new application or runtime.
*
* Uninstall an application or runtime.
*
* Returns: %TRUE on success