summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthew Leeds <matthew.leeds@endlessm.com>2018-04-01 22:45:49 -0700
committerMatthew Leeds <matthew.leeds@endlessm.com>2018-04-01 22:46:39 -0700
commitbf8a33cda04da04a72b1083ba3a91cafa155a62e (patch)
tree1937a595db8966cfbd94f1729e8cc818a726ffbc
parentfaecb982477c30884bfd2b2ac96edaa0b74bc70d (diff)
downloadflatpak-bf8a33cda04da04a72b1083ba3a91cafa155a62e.tar.gz
Update docs to v0.11.3
Diffstat
-rw-r--r--flatpak-docs.html3273
-rw-r--r--reference/html/FlatpakInstallation.html1695
-rw-r--r--reference/html/FlatpakInstalledRef.html92
-rw-r--r--reference/html/FlatpakRef.html111
-rw-r--r--reference/html/FlatpakRemote.html437
-rw-r--r--reference/html/FlatpakRemoteRef.html26
-rw-r--r--reference/html/annotation-glossary.html13
-rw-r--r--reference/html/ch01.html9
-rw-r--r--reference/html/flatpak-Error-codes.html24
-rw-r--r--reference/html/flatpak-Version-information.html32
-rw-r--r--reference/html/flatpak-flatpak-bundle-ref.html85
-rw-r--r--reference/html/flatpak.devhelp256
-rw-r--r--reference/html/full-api-index.html176
-rw-r--r--reference/html/index.html11
-rw-r--r--reference/html/object-tree.html9
15 files changed, 4302 insertions, 1747 deletions
diff --git a/flatpak-docs.html b/flatpak-docs.html
index b24ad2aa..dcdc02c8 100644
--- a/flatpak-docs.html
+++ b/flatpak-docs.html
@@ -1,417 +1,696 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Flatpak Command Reference</title><link rel="stylesheet" type="text/css" href="docbook.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /></head><body><div class="reference"><div class="titlepage"><div><div><h1 class="title"><a id="idm45148834587072"></a>Flatpak Command Reference</h1></div><div><p class="releaseinfo">Version 0.6.13</p></div></div><hr /></div><div class="partintro"><div></div><p>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Flatpak Command Reference</title><link rel="stylesheet" type="text/css" href="docbook.css" /><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /></head><body><div class="reference"><div class="titlepage"><div><div><h1 class="title"><a id="idm140021667440656"></a>Flatpak Command Reference</h1></div><div><p class="releaseinfo">Version 0.11.3</p></div></div><hr /></div><div class="partintro"><div></div><p>
Flatpak comes with a rich commandline interface.
- </p><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="refentrytitle"><a href="#flatpak-install">flatpak install</a></span><span class="refpurpose"> — Install an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-update">flatpak update</a></span><span class="refpurpose"> — Update an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-uninstall">flatpak uninstall</a></span><span class="refpurpose"> — Uninstall an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-list">flatpak list</a></span><span class="refpurpose"> — List installed applications and/or runtimes</span></dt><dt><span class="refentrytitle"><a href="#flatpak-info">flatpak info</a></span><span class="refpurpose"> — Show information about installed application and/or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-run">flatpak run</a></span><span class="refpurpose"> — Run an application</span></dt><dt><span class="refentrytitle"><a href="#flatpak-override">flatpak override</a></span><span class="refpurpose"> — Override application requirements</span></dt><dt><span class="refentrytitle"><a href="#flatpak-enter">flatpak enter</a></span><span class="refpurpose"> — Enter an application</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-export">flatpak document-export</a></span><span class="refpurpose"> — Export a file to a sandboxed application</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-unexport">flatpak document-unexport</a></span><span class="refpurpose"> — Stop exporting a file</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-info">flatpak document-info</a></span><span class="refpurpose"> — Show information about exported files</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-list">flatpak document-list</a></span><span class="refpurpose"> — List exported files</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-add">flatpak remote-add</a></span><span class="refpurpose"> — Add a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-modify">flatpak remote-modify</a></span><span class="refpurpose"> — Modify a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-delete">flatpak remote-delete</a></span><span class="refpurpose"> — Delete a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-list">flatpak remote-list</a></span><span class="refpurpose"> — List remote repositories</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-ls">flatpak remote-ls</a></span><span class="refpurpose"> — Show available runtimes and applications</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-init">flatpak build-init</a></span><span class="refpurpose"> — Initialize a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build">flatpak build</a></span><span class="refpurpose"> — Build in a directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-finish">flatpak build-finish</a></span><span class="refpurpose"> — Finalize a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-export">flatpak build-export</a></span><span class="refpurpose"> — Create a repository from a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-bundle">flatpak build-bundle</a></span><span class="refpurpose"> — Create a single-file bundle from a local repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-import-bundle">flatpak build-import-bundle</a></span><span class="refpurpose"> — Import a file bundle into a local repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-update-repo">flatpak build-update-repo</a></span><span class="refpurpose"> — Create a repository from a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-export">flatpak build-sign</a></span><span class="refpurpose"> — Sign an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-builder">flatpak-builder</a></span><span class="refpurpose"> — Help build application dependencies</span></dt><dt><span class="refentrytitle"><a href="#flatpak-metadata">flatpak metadata</a></span><span class="refpurpose"> — Information about an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-flatpakrepo">flatpakrepo</a></span><span class="refpurpose"> — Reference to a remote</span></dt><dt><span class="refentrytitle"><a href="#flatpak-flatpakref">flatpakref</a></span><span class="refpurpose"> — Reference to a remote for an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-make-current">flatpak make-current</a></span><span class="refpurpose"> — Make a specific version of an app current</span></dt></dl></div></div><div class="refentry"><a id="flatpak-install"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-install — Install an application or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak install</code> [OPTION...] REMOTE REF... </p></div><div class="cmdsynopsis"><p><code class="command">flatpak install</code> [OPTION...] [ --bundle | --from ] FILENAME </p></div></div><div class="refsect1"><a id="idm45148826893504"></a><h2>Description</h2><p>
- Installs an application or runtime. REMOTE must name
- an existing remote and REF is a reference to the
- application or runtime to install.
+ </p><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="chapter"><a href="#idm140021667438432">Executables</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="#flatpak">flatpak</a></span><span class="refpurpose"> — Build, install and run applications and runtimes</span></dt></dl></dd><dt><span class="chapter"><a href="#idm140021665365120">Commands</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="#flatpak-build-bundle">flatpak build-bundle</a></span><span class="refpurpose"> — Create a single-file bundle from a local repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-commit-from">flatpak build-commit-from</a></span><span class="refpurpose"> — Create new commits based on existing one (possibly from another repository)</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-export">flatpak build-export</a></span><span class="refpurpose"> — Create a repository from a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-finish">flatpak build-finish</a></span><span class="refpurpose"> — Finalize a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-import-bundle">flatpak build-import-bundle</a></span><span class="refpurpose"> — Import a file bundle into a local repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-init">flatpak build-init</a></span><span class="refpurpose"> — Initialize a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-sign">flatpak build-sign</a></span><span class="refpurpose"> — Sign an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-update-repo">flatpak build-update-repo</a></span><span class="refpurpose"> — Create a repository from a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build">flatpak build</a></span><span class="refpurpose"> — Build in a directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-config">flatpak config</a></span><span class="refpurpose"> — Manage configuration</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-export">flatpak document-export</a></span><span class="refpurpose"> — Export a file to a sandboxed application</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-info">flatpak document-info</a></span><span class="refpurpose"> — Show information about exported files</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-list">flatpak document-list</a></span><span class="refpurpose"> — List exported files</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-unexport">flatpak document-unexport</a></span><span class="refpurpose"> — Stop exporting a file</span></dt><dt><span class="refentrytitle"><a href="#flatpak-enter">flatpak enter</a></span><span class="refpurpose"> — Enter an application</span></dt><dt><span class="refentrytitle"><a href="#flatpak-info">flatpak info</a></span><span class="refpurpose"> — Show information about installed application and/or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-install">flatpak install</a></span><span class="refpurpose"> — Install an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-list">flatpak list</a></span><span class="refpurpose"> — List installed applications and/or runtimes</span></dt><dt><span class="refentrytitle"><a href="#flatpak-make-current">flatpak make-current</a></span><span class="refpurpose"> — Make a specific version of an app current</span></dt><dt><span class="refentrytitle"><a href="#flatpak-override">flatpak override</a></span><span class="refpurpose"> — Override application requirements</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-add">flatpak remote-add</a></span><span class="refpurpose"> — Add a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-delete">flatpak remote-delete</a></span><span class="refpurpose"> — Delete a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-info">flatpak remote-info</a></span><span class="refpurpose"> — Show information about an application or runtime in a remote</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-ls">flatpak remote-ls</a></span><span class="refpurpose"> — Show available runtimes and applications</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-modify">flatpak remote-modify</a></span><span class="refpurpose"> — Modify a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remotes">flatpak remotes</a></span><span class="refpurpose"> — List remote repositories</span></dt><dt><span class="refentrytitle"><a href="#flatpak-repo">flatpak repo</a></span><span class="refpurpose"> — Show information about a local repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-run">flatpak run</a></span><span class="refpurpose"> — Run an application or open a shell in a runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-search">flatpak search</a></span><span class="refpurpose"> — Search for applications and runtimes</span></dt><dt><span class="refentrytitle"><a href="#flatpak-uninstall">flatpak uninstall</a></span><span class="refpurpose"> — Uninstall an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-update">flatpak update</a></span><span class="refpurpose"> — Update an application or runtime</span></dt></dl></dd><dt><span class="chapter"><a href="#idm140021667501760">File Formats</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="#flatpak-flatpakrepo">flatpakrepo</a></span><span class="refpurpose"> — Reference to a remote</span></dt><dt><span class="refentrytitle"><a href="#flatpak-flatpakref">flatpakref</a></span><span class="refpurpose"> — Reference to a remote for an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-installation">flatpak installation</a></span><span class="refpurpose"> — Configuration for an installation location</span></dt><dt><span class="refentrytitle"><a href="#flatpak-metadata">flatpak metadata</a></span><span class="refpurpose"> — Information about an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote">flatpak remote</a></span><span class="refpurpose"> — Configuration for a remote</span></dt></dl></dd></dl></div></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a id="idm140021667438432"></a>Executables</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="refentrytitle"><a href="#flatpak">flatpak</a></span><span class="refpurpose"> — Build, install and run applications and runtimes</span></dt></dl></div><div class="refentry"><a id="flatpak"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak — Build, install and run applications and runtimes</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak</code> [OPTION...] {COMMAND}</p></div></div><div class="refsect1"><a id="idm140021660049328"></a><h2>Description</h2><p>
+ flatpak is a tool for managing applications and the runtimes
+ they use. In the flatpak model, applications can be built and
+ distributed independently from the host system they are used
+ on, and they are isolated from the host system ('sandboxed')
+ to some degree, at runtime.
</p><p>
- Each REF arguments is a full or partial indentifier in the
- flatpak ref format, which looks like "(app|runtime)/ID/ARCH/BRANCH". All elements
- except ID are optional and can be left out, including the slashes,
- so most of the time you need only specify ID. Any part left out will be matched
- against what is in the remote, and if there are multiple matches an error message
- will list the alternatives.
+ flatpak can operate in system-wide or per-user mode. The system-wide
+ data (runtimes, applications and configuration) is located in
+ <code class="filename">$prefix/var/lib/flatpak/</code>, and the per-user
+ data is in <code class="filename">$HOME/.local/share/flatpak/</code>.
+ Below these locations, there is a local repository in the
+ <code class="filename">repo/</code> subdirectory and installed runtimes
+ and applications are in the corresponding <code class="filename">runtime/</code>
+ and <code class="filename">app/</code> subdirectories.
</p><p>
- By default this looks for both apps and runtime with the given REF in
- the specified REMOTE , but you can limit this by using the --app or
- --runtime option, or by supplying the initial element in the REF.
+ System-wide remotes can be statically preconfigured by dropping
+ config fragments into <code class="filename">/etc/flatpak/remotes.d/</code>.
</p><p>
- Note that flatpak allows one to have multiple branches of an application and runtimes
- installed and used at the same time. However, only version of an application one can be current,
- meaning its exported files (for instance desktop files and icons) are
- visible to the host. The last installed version is made current by
- default, but you can manually change with make-current.
+ In addition to the system-wide installation in <code class="filename">$prefix/var/lib/flatpak/</code>,
+ which is always considered the default one unless overridden, more
+ system-wide installations can be defined via configuration files in
+ <code class="filename">/etc/flatpak/installations.d/</code>, which must define
+ at least the id of the installation and the absolute path to it.
+ Other optional parameters like DisplayName ,
+ Priority or StorageType
+ are also supported.
</p><p>
- Unless overridden with the --user option, this command creates a
- system-wide installation.
- </p><p>
- The alternative form of the command installs an application from a
- single-file bundle or a flatpakref file instead of a configured remote.
- Bundles can be created with the flatpak build-bundle command, flatpakref
- files are simple references to a remote repo for an application.
- </p></div><div class="refsect1"><a id="idm45148826883696"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ flatpak uses OSTree to distribute and deploy data. The repositories
+ it uses are OSTree repositories and can be manipulated with the
+ <span class="command"><strong>ostree</strong></span> utility. Installed runtimes and
+ applications are OSTree checkouts.
+ </p></div><div class="refsect1"><a id="idm140021660036096"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">--bundle</code></span></dt><dd><p>
- Install from a bundle file instead
- of a configured remote.
- </p></dd><dt><span class="term"><code class="option">--from</code></span></dt><dd><p>
- Install from a flatpakref file instead
- of a configured remote.
- </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
- Create a per-user installation.
- </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
- Create a system-wide installation.
- </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
- The default architecture to install for, if not given explicitly in the REF .
- </p></dd><dt><span class="term"><code class="option">--subpath=PATH</code></span></dt><dd><p>
- Install only a subpath of the ref. This is mainly used to install a subset of locales.
- This can be added multiple times to install multiple subpaths.,
- </p></dd><dt><span class="term"><code class="option">--no-deploy</code></span></dt><dd><p>
- Download the latest version, but don't deploy it.
- </p></dd><dt><span class="term"><code class="option">--no-pull</code></span></dt><dd><p>
- Don't download the latest version, deploy whatever is locally available.
- </p></dd><dt><span class="term"><code class="option">--no-related</code></span></dt><dd><p>
- Don't download related extensions, such as the locale data.
- </p></dd><dt><span class="term"><code class="option">--no-deps</code></span></dt><dd><p>
- Don't verify runtime dependencies when installing.
- </p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
- Assume that all REF s are apps if not explicitly specified.
- </p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
- Assume that all REF s are runtimes if not explicitly specified.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
- Print debug information during command processing.
+ Print debug information during command processing. Use -vv for more detail.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148824465552"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak --user install test-repo org.gnome.GEdit</strong></span>
- </p></div><div class="refsect1"><a id="idm45148824463776"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-update</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-list</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-bundle</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-flatpakref</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-update"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-update — Update an application or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak update</code> [OPTION...] [REF...]</p></div></div><div class="refsect1"><a id="idm45148826184080"></a><h2>Description</h2><p>
- Updates applications and runtimes. REF is a reference to the
- application or runtime to install. If no REF is given, everything
- is updated.
- </p><p>
- Each REF arguments is a full or partial indentifier in the
- flatpak ref format, which looks like "(app|runtime)/ID/ARCH/BRANCH". All elements
- except ID are optional and can be left out, including the slashes,
- so most of the time you need only specify ID. Any part left out will be matched
- against what is installed, and if there are multiple matches an error message
- will list the alternatives.
- </p><p>
- By default this looks for both apps and runtime with the given REF in
- the specified REMOTE , but you can limit this by using the --app or
- --runtime option, or by supplying the initial element in the REF.
- </p><p>
- Normally, this command updates the application to the tip
- of its branch. But it is possible to check out another commit,
- with the --commit option.
- </p><p>
- Note that updating a runtime is different from installing
- a different branch, and runtime updates are expected to keep
- strict compatibility. If an application update does cause
- a problem, it is possible to go back to the previous
- version, with the --commit option.
+ </p></dd><dt><span class="term"><code class="option">--default-arch</code></span></dt><dd><p>
+ Print the default arch and exit.
+ </p></dd><dt><span class="term"><code class="option">--supported-arches</code></span></dt><dd><p>
+ Print the supported arches in priority order and exit.
+ </p></dd><dt><span class="term"><code class="option">--gl-drivers</code></span></dt><dd><p>
+ Print the list of active gl drivers and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021660021808"></a><h2>Commands</h2><p>Commands for managing installed applications and runtimes:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a class="citerefentry" href="#flatpak-install"><span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span></a></span></dt><dd><p>
+ Install an application or a runtime from a remote or bundle.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-update"><span class="citerefentry"><span class="refentrytitle">flatpak-update</span>(1)</span></a></span></dt><dd><p>
+ Update an installed application or runtime.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-uninstall"><span class="citerefentry"><span class="refentrytitle">flatpak-uninstall</span>(1)</span></a></span></dt><dd><p>
+ Uninstall an installed application or runtime.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-list"><span class="citerefentry"><span class="refentrytitle">flatpak-list</span>(1)</span></a></span></dt><dd><p>
+ List installed applications and/or runtimes.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-info"><span class="citerefentry"><span class="refentrytitle">flatpak-info</span>(1)</span></a></span></dt><dd><p>
+ Show information for an installed application or runtime.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-config"><span class="citerefentry"><span class="refentrytitle">flatpak-config</span>(1)</span></a></span></dt><dd><p>
+ Manage flatpak configuration.
+ </p></dd></dl></div><p>Commands for finding applications and runtimes:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a class="citerefentry" href="#flatpak-search"><span class="citerefentry"><span class="refentrytitle">flatpak-search</span>(1)</span></a></span></dt><dd><p>
+ Search for applications and runtimes.
+ </p></dd></dl></div><p>Commands for running applications:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a class="citerefentry" href="#flatpak-run"><span class="citerefentry"><span class="refentrytitle">flatpak-run</span>(1)</span></a></span></dt><dd><p>
+ Run an application.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-override"><span class="citerefentry"><span class="refentrytitle">flatpak-override</span>(1)</span></a></span></dt><dd><p>
+ Override permissions for an application.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-make-current"><span class="citerefentry"><span class="refentrytitle">flatpak-make-current</span>(1)</span></a></span></dt><dd><p>
+ Specify the default version to run.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-enter"><span class="citerefentry"><span class="refentrytitle">flatpak-enter</span>(1)</span></a></span></dt><dd><p>
+ Enter the namespace of a running application.
+ </p></dd></dl></div><p>Commands for managing file access:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a class="citerefentry" href="#flatpak-document-export"><span class="citerefentry"><span class="refentrytitle">flatpak-document-export</span>(1)</span></a></span></dt><dd><p>
+ Grant an application access to a specific file.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-document-unexport"><span class="citerefentry"><span class="refentrytitle">flatpak-document-unexport</span>(1)</span></a></span></dt><dd><p>
+ Revoke access to a specific file.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-document-info"><span class="citerefentry"><span class="refentrytitle">flatpak-document-info</span>(1)</span></a></span></dt><dd><p>
+ Show information about a specific file.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-document-list"><span class="citerefentry"><span class="refentrytitle">flatpak-document-list</span>(1)</span></a></span></dt><dd><p>
+ List exported files.
+ </p></dd></dl></div><p>Commands for managing remote repositories:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a class="citerefentry" href="#flatpak-remotes"><span class="citerefentry"><span class="refentrytitle">flatpak-remotes</span>(1)</span></a></span></dt><dd><p>
+ List all configured remote repositories.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-remote-add"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-add</span>(1)</span></a></span></dt><dd><p>
+ Add a new remote repository.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-remote-modify"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-modify</span>(1)</span></a></span></dt><dd><p>
+ Modify properties of a configured remote repository.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-remote-delete"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-delete</span>(1)</span></a></span></dt><dd><p>
+ Delete a configured remote repository.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-remote-ls"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-ls</span>(1)</span></a></span></dt><dd><p>
+ List contents of a configured remote repository.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-remote-info"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-info</span>(1)</span></a></span></dt><dd><p>
+ Show information about a ref in a configured remote repository.
+ </p></dd></dl></div><p>Commands for building applications:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a class="citerefentry" href="#flatpak-build-init"><span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span></a></span></dt><dd><p>
+ Initialize a build directory.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build"><span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span></a></span></dt><dd><p>
+ Run a build command in a build directory.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build-finish"><span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span></a></span></dt><dd><p>
+ Finalizes a build directory for export.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build-export"><span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span></a></span></dt><dd><p>
+ Export a build directory to a repository.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build-bundle"><span class="citerefentry"><span class="refentrytitle">flatpak-build-bundle</span>(1)</span></a></span></dt><dd><p>
+ Create a bundle file from a ref in a local repository.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build-import-bundle"><span class="citerefentry"><span class="refentrytitle">flatpak-build-import-bundle</span>(1)</span></a></span></dt><dd><p>
+ Import a file bundle into a local repository.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build-sign"><span class="citerefentry"><span class="refentrytitle">flatpak-build-sign</span>(1)</span></a></span></dt><dd><p>
+ Sign an application or runtime after its been exported.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build-update-repo"><span class="citerefentry"><span class="refentrytitle">flatpak-build-update-repo</span>(1)</span></a></span></dt><dd><p>
+ Update the summary file in a repository.
+ </p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build-commit-from"><span class="citerefentry"><span class="refentrytitle">flatpak-build-commit-from</span>(1)</span></a></span></dt><dd><p>
+ Create a new commit based on an existing ref.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021659953600"></a><h2>Environment</h2><p>
+ Besides standard environment variables such as <code class="envar">XDG_DATA_DIRS</code> and
+ <code class="envar">XDG_DATA_HOME</code>, flatpak is consulting some of its own.
+ </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="envar">FLATPAK_USER_DIR</code></span></dt><dd><p>
+ The location of the per-user installation. If this is not set,
+ <code class="filename">$XDG_DATA_HOME/flatpak</code> is used.
+ </p></dd><dt><span class="term"><code class="envar">FLATPAK_SYSTEM_DIR</code></span></dt><dd><p>
+ The location of the default system-wide installation. If this is not set,
+ <code class="filename">/var/lib/flatpak</code> is used (unless overridden at build
+ time by --localstatedir or --with-system-install-dir).
+ </p></dd><dt><span class="term"><code class="envar">FLATPAK_CONFIG_DIR</code></span></dt><dd><p>
+ The location of flatpak site configuration. If this is not set,
+ <code class="filename">/etc/flatpak</code> is used (unless overridden at build
+ time by --sysconfdir).
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021659943520"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#ostree"><span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span></a>,
+ <a class="citerefentry" href="#ostree.repo"><span class="citerefentry"><span class="refentrytitle">ostree.repo</span>(5)</span></a>,
+ <a class="citerefentry" href="#flatpak-remote"><span class="citerefentry"><span class="refentrytitle">flatpak-remote</span>(5)</span></a>,
+ </p></div></div></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a id="idm140021665365120"></a>Commands</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="refentrytitle"><a href="#flatpak-build-bundle">flatpak build-bundle</a></span><span class="refpurpose"> — Create a single-file bundle from a local repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-commit-from">flatpak build-commit-from</a></span><span class="refpurpose"> — Create new commits based on existing one (possibly from another repository)</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-export">flatpak build-export</a></span><span class="refpurpose"> — Create a repository from a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-finish">flatpak build-finish</a></span><span class="refpurpose"> — Finalize a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-import-bundle">flatpak build-import-bundle</a></span><span class="refpurpose"> — Import a file bundle into a local repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-init">flatpak build-init</a></span><span class="refpurpose"> — Initialize a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-sign">flatpak build-sign</a></span><span class="refpurpose"> — Sign an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-update-repo">flatpak build-update-repo</a></span><span class="refpurpose"> — Create a repository from a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build">flatpak build</a></span><span class="refpurpose"> — Build in a directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-config">flatpak config</a></span><span class="refpurpose"> — Manage configuration</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-export">flatpak document-export</a></span><span class="refpurpose"> — Export a file to a sandboxed application</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-info">flatpak document-info</a></span><span class="refpurpose"> — Show information about exported files</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-list">flatpak document-list</a></span><span class="refpurpose"> — List exported files</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-unexport">flatpak document-unexport</a></span><span class="refpurpose"> — Stop exporting a file</span></dt><dt><span class="refentrytitle"><a href="#flatpak-enter">flatpak enter</a></span><span class="refpurpose"> — Enter an application</span></dt><dt><span class="refentrytitle"><a href="#flatpak-info">flatpak info</a></span><span class="refpurpose"> — Show information about installed application and/or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-install">flatpak install</a></span><span class="refpurpose"> — Install an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-list">flatpak list</a></span><span class="refpurpose"> — List installed applications and/or runtimes</span></dt><dt><span class="refentrytitle"><a href="#flatpak-make-current">flatpak make-current</a></span><span class="refpurpose"> — Make a specific version of an app current</span></dt><dt><span class="refentrytitle"><a href="#flatpak-override">flatpak override</a></span><span class="refpurpose"> — Override application requirements</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-add">flatpak remote-add</a></span><span class="refpurpose"> — Add a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-delete">flatpak remote-delete</a></span><span class="refpurpose"> — Delete a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-info">flatpak remote-info</a></span><span class="refpurpose"> — Show information about an application or runtime in a remote</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-ls">flatpak remote-ls</a></span><span class="refpurpose"> — Show available runtimes and applications</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-modify">flatpak remote-modify</a></span><span class="refpurpose"> — Modify a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remotes">flatpak remotes</a></span><span class="refpurpose"> — List remote repositories</span></dt><dt><span class="refentrytitle"><a href="#flatpak-repo">flatpak repo</a></span><span class="refpurpose"> — Show information about a local repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-run">flatpak run</a></span><span class="refpurpose"> — Run an application or open a shell in a runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-search">flatpak search</a></span><span class="refpurpose"> — Search for applications and runtimes</span></dt><dt><span class="refentrytitle"><a href="#flatpak-uninstall">flatpak uninstall</a></span><span class="refpurpose"> — Uninstall an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-update">flatpak update</a></span><span class="refpurpose"> — Update an application or runtime</span></dt></dl></div><div class="refentry"><a id="flatpak-build-bundle"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-bundle — Create a single-file bundle from a local repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-bundle</code> [OPTION...] LOCATION FILENAME NAME [BRANCH]</p></div></div><div class="refsect1"><a id="idm140021660229504"></a><h2>Description</h2><p>
+ Creates a single-file named FILENAME
+ for the application (or runtime) named NAME
+ in the repository at LOCATION . If
+ a BRANCH is specified, this branch of
+ the application is used.
+
</p><p>
- Unless overridden with the --user option, this command updates
- a system-wide installation.
- </p></div><div class="refsect1"><a id="idm45148826110176"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ The format of the bundle file is that of an ostree static delta
+ (against an empty base) with some flatpak specific metadata for
+ the application icons and appdata.
+ </p></div><div class="refsect1"><a id="idm140021658496992"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
- Update a per-user installation.
- </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
- Update a system-wide installation.
- </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
- The architecture to update for.
- </p></dd><dt><span class="term"><code class="option">--subpath=PATH</code></span></dt><dd><p>
- Install only a subpath of the ref. This is mainly used to install a subset of locales.
- This can be added multiple times to install multiple subpaths.
- If this is not specified the subpaths specified at install time are reused.
- </p></dd><dt><span class="term"><code class="option">--commit=COMMIT</code></span></dt><dd><p>
- Update to this commit, instead of the tip of the branch.
- </p></dd><dt><span class="term"><code class="option">--no-deploy</code></span></dt><dd><p>
- Download the latest version, but don't deploy it.
- </p></dd><dt><span class="term"><code class="option">--no-pull</code></span></dt><dd><p>
- Don't download the latest version, deploy it whatever is locally available.
- </p></dd><dt><span class="term"><code class="option">--no-related</code></span></dt><dd><p>
- Don't download related extensions, such as the locale data.
- </p></dd><dt><span class="term"><code class="option">--no-deps</code></span></dt><dd><p>
- Don't update or install runtime dependencies when installing.
- </p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
- Only look for an app with the given name.
- </p></dd><dt><span class="term"><code class="option">--appstream</code></span></dt><dd><p>
- Update appstream for the remote.
</p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
- Only look for an runtime with the given name.
+ Export a runtime instead of an application.
+ </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
+ The arch to create a bundle for.
+ </p></dd><dt><span class="term"><code class="option">--repo-url=URL</code></span></dt><dd><p>
+ The URL for the repository from which the
+ application can be updated. Installing the
+ bundle will automatically configure a remote
+ for this URL.
+ </p></dd><dt><span class="term"><code class="option">--runtime-repo=URL</code></span></dt><dd><p>
+ The URL for a .flatpakrepo file that contains
+ the information about the repository that supplies
+ the runtimes required by the app.
+ </p></dd><dt><span class="term"><code class="option">--gpg-keys=FILE</code></span></dt><dd><p>
+ Add the GPG key from FILE (use - for stdin).
+ </p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
+ GPG Homedir to use when looking for keyrings.
+ </p></dd><dt><span class="term"><code class="option">--oci</code></span></dt><dd><p>
+ Export to an OCI image instead of a Flatpak bundle.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
- Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148826719664"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak --user update org.gnome.GEdit</strong></span>
- </p></div><div class="refsect1"><a id="idm45148834729696"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-list</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-uninstall"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-uninstall — Uninstall an application or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak uninstall</code> [OPTION...] [REF...]</p></div></div><div class="refsect1"><a id="idm45148828569392"></a><h2>Description</h2><p>
- Uninstalls an application or runtime. REF is a reference to the
- application or runtime to install. If no REF is given, everything
- is updated.
- </p><p>
- Each REF arguments is a full or partial indentifier in the
- flatpak ref format, which looks like "(app|runtime)/ID/ARCH/BRANCH". All elements
- except ID are optional and can be left out, including the slashes,
- so most of the time you need only specify ID. Any part left out will be matched
- against what is installed, and if there are multiple matches an error message
- will list the alternatives.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021661152768"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#ostree"><span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-init"><span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build"><span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-finish"><span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-import-bundle"><span class="citerefentry"><span class="refentrytitle">flatpak-build-import-bundle</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-update-repo"><span class="citerefentry"><span class="refentrytitle">flatpak-build-update-repo</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-commit-from"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-commit-from — Create new commits based on existing one (possibly from another repository)</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-commit-from</code> [OPTION...] DST-REPO DST-REF... </p></div></div><div class="refsect1"><a id="idm140021661141744"></a><h2>Description</h2><p>
+ Creates new commits on the DST-REF
+ branch in the DST-REPO , with the
+ contents (and most of the metadata) taken from another
+ branch, either from another repo, or from another branch in
+ the same repository.
+
</p><p>
- By default this looks for both installed apps and runtime
- with the given NAME , but you can
- limit this by using the --app or --runtime option.
- </p><p>
- Normally, this command removes the ref for this application/runtime from the
- local OSTree repository and purges and objects that are no longer
- needed to free up disk space. If the same application is later
- reinstalled, the objects will be pulled from the remote repository
- again. The --keep-ref option can be used to prevent this.
- </p><p>
- If all branches of the application/runtime are removed, this command
- also purges the data directory for the application.
+ This command is very useful when you want to maintain a branch
+ with a clean history that has no unsigned or broken commits.
+ For instance, you can import the head from a different repository
+ from an automatic builder when you've verified that it worked.
+ The new commit will have no parents or signatures from the
+ autobuilder, and can be properly signed with the official
+ key.
</p><p>
- Unless overridden with the --user option, this command updates
- a system-wide installation.
- </p></div><div class="refsect1"><a id="idm45148826666720"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Any deltas that affect the original commit and that match parent
+ commits in the destination repository are copied and rewritten
+ for the new commit id.
+ </p></div><div class="refsect1"><a id="idm140021661137344"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">--keep-ref</code></span></dt><dd><p>
- Keep the ref for the application and the objects belonging to it
- in the local repository.
- </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
- Remove a per-user installation.
- </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
- Remove a system-wide installation.
- </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
- The architecture to uninstall, instead of the architecture of
- the host system.
- </p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
- Only look for an app with the given name.
- </p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
- Only look for an runtime with the given name.
- </p></dd><dt><span class="term"><code class="option">--no-related</code></span></dt><dd><p>
- Don't uninstall related extensions, such as the locale data.
+ </p></dd><dt><span class="term"><code class="option">--src-repo=SRC-REPO</code></span></dt><dd><p>
+ The (local) repository to pull the source branch from. Defaults to the
+ destination repository.
+ </p></dd><dt><span class="term"><code class="option">--src-ref=SRC-REF</code></span></dt><dd><p>
+ The branch to use as the source for the new commit. Defaults to the same
+ as the destination ref, which is useful only if a different source repo
+ has been specified.
+ </p></dd><dt><span class="term"><code class="option">--untrusted</code></span></dt><dd><p>
+ The source repostory is not trusted, all objects are copied (not hardlinked) and
+ all checksums are verified.
+ </p></dd><dt><span class="term"><code class="option">-s</code>, </span><span class="term"><code class="option">--subject=SUBJECT</code></span></dt><dd><p>
+ One line subject for the commit message. If not specified, will be taken from the source commit.
+ </p></dd><dt><span class="term"><code class="option">-b</code>, </span><span class="term"><code class="option">--body=BODY</code></span></dt><dd><p>
+ Full description for the commit message. If not specified, will be taken from the source commit.
+ </p></dd><dt><span class="term"><code class="option">--update-appstream</code></span></dt><dd><p>
+ Update the appstream branch after the build.
+ </p></dd><dt><span class="term"><code class="option">--no-update-summary</code></span></dt><dd><p>
+ Don't update the summary file after the new commit is added. This means
+ the repository will not be useful for serving over http until build-update-repo
+ has been run. This is useful is you want to do multiple repo operations before
+ finally updating the summary.
+ </p></dd><dt><span class="term"><code class="option">--force</code></span></dt><dd><p>
+ Create new commit even if the content didn't change from the existing branch head.
+ </p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
+ Sign the commit with this GPG key.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
+ GPG Homedir to use when looking for keyrings
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148824644336"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak --user uninstall org.gnome.GEdit</strong></span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-list"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-list — List installed applications and/or runtimes</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak list</code> [OPTION...]</p></div></div><div class="refsect1"><a id="idm45148827419712"></a><h2>Description</h2><p>
- Lists the names of the installed applications and/or runtime.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021657704768"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak build-export ~/repos/gnome-calculator/ ~/build/gnome-calculator/ org.gnome.Calculator</strong></span>
+ </p><pre class="programlisting">
+Commit: 9d0044ea480297114d03aec85c3d7ae3779438f9d2cb69d717fb54237acacb8c
+Metadata Total: 605
+Metadata Written: 5
+Content Total: 1174
+Content Written: 1
+Content Bytes Written: 305
+</pre></div><div class="refsect1"><a id="idm140021657701744"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#ostree"><span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-init"><span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build"><span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-finish"><span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-sign"><span class="citerefentry"><span class="refentrytitle">flatpak-build-sign</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-update-repo"><span class="citerefentry"><span class="refentrytitle">flatpak-build-update-repo</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-export"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-export — Create a repository from a build directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-export</code> [OPTION...] LOCATION DIRECTORY [BRANCH]</p></div></div><div class="refsect1"><a id="idm140021658166880"></a><h2>Description</h2><p>
+ Creates or updates a repository with an application build.
+ LOCATION is the location of the
+ repository. DIRECTORY must be a
+ finalized build directory. If BRANCH
+ is not specified, it is assumed to be "master".
</p><p>
- By default, both per-user and system-wide installations
- are shown. Use the --user or --system options to change
- this.
+ If LOCATION exists, it is assumed to
+ be an OSTree repository, otherwise a new OSTree repository is
+ created at this location. The repository can be inspected with
+ the <span class="command"><strong>ostree</strong></span> tool.
</p><p>
- By default this lists the installed apps, but you can
- change this by using the --app or --runtime option.
- </p></div><div class="refsect1"><a id="idm45148827314880"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ The contents of DIRECTORY are committed
+ on the branch with name <code class="literal">app/APPNAME/ARCH/BRANCH</code>,
+ where ARCH is the architecture of the runtime that the application
+ is using. A commit filter is used to enforce that only the contents
+ of the <code class="filename">files/</code> and <code class="filename">export/</code>
+ subdirectories and the <code class="filename">metadata</code> file are included
+ in the commit, anything else is ignored.
+ </p><p>
+ The build-update-repo command should be used to update repository
+ metadata whenever application builds are added to a repository.
+ </p></div><div class="refsect1"><a id="idm140021657863856"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
- List per-user installations.
- </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
- List system-wide installations.
+ </p></dd><dt><span class="term"><code class="option">-s</code>, </span><span class="term"><code class="option">--subject=SUBJECT</code></span></dt><dd><p>
+ One line subject for the commit message.
+ </p></dd><dt><span class="term"><code class="option">-b</code>, </span><span class="term"><code class="option">--body=BODY</code></span></dt><dd><p>
+ Full description for the commit message.
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
- List installations for this architecture.
- </p></dd><dt><span class="term"><code class="option">--show-details</code></span></dt><dd><p>
- Show arches and branches, in addition to the application names.
- </p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
- List applications.
- </p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
- List runtimes.
+ Specify the architecture component of the branch to export. Only host compatible architectures can be specified.
+ </p></dd><dt><span class="term"><code class="option">--exclude=PATTERN</code></span></dt><dd><p>
+ Exclude files matching PATTERN from the commit.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--include=PATTERN</code></span></dt><dd><p>
+ Don't exclude files matching PATTERN from the commit, even if they match the --export patterns.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--metadata=FILENAME</code></span></dt><dd><p>
+ Use the specified filename as metadata in the exported app instead of
+ the default file (called <code class="filename">metadata</code>). This is useful
+ if you want to commit multiple things from a single build tree, typically
+ used in combination with --files and --exclude.
+ </p></dd><dt><span class="term"><code class="option">--files=SUBDIR</code></span></dt><dd><p>
+ Use the files in the specified subdirectory as the file contents, rather
+ than the regular <code class="filename">files</code> directory.
+ </p></dd><dt><span class="term"><code class="option">--timestamp=DATE</code></span></dt><dd><p>
+ Use the specified ISO 8601 formatted date in the commit metadata and, if <code class="option">--update-appstream</code> is used, the appstream data.
+ </p></dd><dt><span class="term"><code class="option">--update-appstream</code></span></dt><dd><p>
+ Update the appstream branch after the build.
+ </p></dd><dt><span class="term"><code class="option">--no-update-summary</code></span></dt><dd><p>
+ Don't update the summary file after the new commit is added. This means
+ the repository will not be useful for serving over http until build-update-repo
+ has been run. This is useful is you want to do multiple repo operations before
+ finally updating the summary.
+ </p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
+ Sign the commit with this GPG key.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
+ GPG Homedir to use when looking for keyrings
+ </p></dd><dt><span class="term"><code class="option">-r</code>, </span><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
+ Export a runtime instead for an app (this uses the usr subdir as files).
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148826410512"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak --user list</strong></span>
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021662098896"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak build-export ~/repos/gnome-calculator/ ~/build/gnome-calculator/ org.gnome.Calculator</strong></span>
</p><pre class="programlisting">
-org.gnome.Builder
-org.freedesktop.glxgears
-org.gnome.MyApp
-org.gnome.GEdit
-</pre></div><div class="refsect1"><a id="idm45148826407760"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-update</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-info"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-info — Show information about installed application and/or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak info</code> [OPTION...] NAME [BRANCH]</p></div></div><div class="refsect1"><a id="idm45148824749024"></a><h2>Description</h2><p>
- Show info about and installed application and/or runtime.
- </p><p>
- By default, both per-user and system-wide installations
- are queried. Use the --user or --system options to change
- this.
+Commit: 9d0044ea480297114d03aec85c3d7ae3779438f9d2cb69d717fb54237acacb8c
+Metadata Total: 605
+Metadata Written: 5
+Content Total: 1174
+Content Written: 1
+Content Bytes Written: 305
+</pre></div><div class="refsect1"><a id="idm140021662095872"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#ostree"><span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-init"><span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build"><span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-finish"><span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-sign"><span class="citerefentry"><span class="refentrytitle">flatpak-build-sign</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-update-repo"><span class="citerefentry"><span class="refentrytitle">flatpak-build-update-repo</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-finish"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-finish — Finalize a build directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-finish</code> [OPTION...] DIRECTORY </p></div></div><div class="refsect1"><a id="idm140021657712720"></a><h2>Description</h2><p>
+ Finalizes a build directory, to prepare it for exporting.
+ DIRECTORY is the name of the directory.
</p><p>
- By default this queries the installed apps and runtimes, but you can
- limit this by using the --app or --runtime option.
- </p></div><div class="refsect1"><a id="idm45148827401968"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
- Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
- Query per-user installations.
- </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
- Query system-wide installations.
- </p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
- Query for applications.
- </p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
- Query for runtimes.
- </p></dd><dt><span class="term"><code class="option">-r</code>, </span><span class="term"><code class="option">--show-ref</code></span></dt><dd><p>
- Show the installed ref.
- </p></dd><dt><span class="term"><code class="option">-o</code>, </span><span class="term"><code class="option">--show-origin</code></span></dt><dd><p>
- Show the remote the ref is installed from.
- </p></dd><dt><span class="term"><code class="option">-c</code>, </span><span class="term"><code class="option">--show-commit</code></span></dt><dd><p>
- Show the installed commit id.
- </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
- Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
- Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148825046656"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak --user list</strong></span>
- </p><pre class="programlisting">
-org.gnome.Builder
-org.freedesktop.glxgears
-org.gnome.MyApp
-org.gnome.GEdit
-</pre></div><div class="refsect1"><a id="idm45148825044016"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-update</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-run"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-run — Run an application</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak run</code> [OPTION...] APP [ARG...]</p></div></div><div class="refsect1"><a id="idm45148828134384"></a><h2>Description</h2><p>
- Runs an application in a sandboxed environment.
- APP must name an installed application.
- Extra arguments are passed on to the application.
+ The result of this command is that desktop files, icons and
+ D-Bus service files from the <code class="filename">files</code> subdirectory
+ are copied to a new <code class="filename">export</code> subdirectory. In the
+ <code class="filename">metadata</code> file, the command key is set in the
+ [Application] group, and the supported keys in the [Environment]
+ group are set according to the options.
</p><p>
- flatpak creates a sandboxed environment for the application to run in
- by mounting the right runtime at <code class="filename">/usr</code> and a writable
- directory at <code class="filename">/var</code>, whose content is preserved between
- application runs. The application itself is mounted at <code class="filename">/app</code>.
+ You should review the exported files and the application metadata
+ before creating and distributing an application bundle.
</p><p>
- The details of the sandboxed environment are controlled by the application
- metadata and various options like --share and --socket that are passed to the run
- command: Access is allowed if it was requested either in the application
- metadata file or with an option and the user hasn't overridden it.
- </p></div><div class="refsect1"><a id="idm45148825919344"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ It is an error to run build-finish on a directory that has not
+ been initialized as a build directory, or has already been finalized.
+ </p></div><div class="refsect1"><a id="idm140021658208352"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
- Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
- Print version information and exit.
- </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
- The architecture to install for.
</p></dd><dt><span class="term"><code class="option">--command=COMMAND</code></span></dt><dd><p>
- The command to run instead of the one listed in the application metadata.
- </p></dd><dt><span class="term"><code class="option">--branch=BRANCH</code></span></dt><dd><p>
- The branch to use.
- </p></dd><dt><span class="term"><code class="option">-d</code>, </span><span class="term"><code class="option">--devel</code></span></dt><dd><p>
- Use the devel runtime that is specified in the application metadata instead of the regular runtime, and use a seccomp profile that is less likely to break development tools.
- </p></dd><dt><span class="term"><code class="option">--runtime=RUNTIME</code></span></dt><dd><p>
- Use this runtime instead of the one that is specified in the application metadata.
- This is a full tuple, like for example org.freedesktop.Sdk/x86_64/1.2 , but
- partial tuples are allowed. Any empty or missing parts are filled in with the corresponding
- values specified by the app.
- </p></dd><dt><span class="term"><code class="option">--runtime-version=VERSION</code></span></dt><dd><p>
- Use this version of the runtime instead of the one that is specified in the application metadata.
- This overrides any version specified with the --runtime option.
+ The command to use. If this option is not specified,
+ the first executable found in <code class="filename">files/bin</code>
+ is used.
+ </p></dd><dt><span class="term"><code class="option">--require-version=MAJOR.MINOR.MICRO</code></span></dt><dd><p>
+ Require this version of later of flatpak to install/update to this build.
</p></dd><dt><span class="term"><code class="option">--share=SUBSYSTEM</code></span></dt><dd><p>
- Share a subsystem with the host session. This overrides
- the Context section from the application metadata.
+ Share a subsystem with the host session. This updates
+ the [Context] group in the metadata.
SUBSYSTEM must be one of: network, ipc.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--unshare=SUBSYSTEM</code></span></dt><dd><p>
- Don't share a subsystem with the host session. This overrides
- the Context section from the application metadata.
+ Don't share a subsystem with the host session. This updates
+ the [Context] group in the metadata.
SUBSYSTEM must be one of: network, ipc.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--socket=SOCKET</code></span></dt><dd><p>
- Expose a well known socket to the application. This overrides to
- the Context section from the application metadata.
- SOCKET must be one of: x11, wayland, pulseaudio, system-bus, session-bus.
+ Expose a well known socket to the application. This updates
+ the [Context] group in the metadata.
+ SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nosocket=SOCKET</code></span></dt><dd><p>
- Don't expose a well known socket to the application. This overrides to
- the Context section from the application metadata.
- SOCKET must be one of: x11, wayland, pulseaudio, system-bus, session-bus.
+ Don't expose a well known socket to the application. This updates
+ the [Context] group in the metadata.
+ SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--device=DEVICE</code></span></dt><dd><p>
- Expose a device to the application. This overrides to
- the Context section from the application metadata.
+ Expose a device to the application. This updates
+ the [Context] group in the metadata.
DEVICE must be one of: dri, kvm, all.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nodevice=DEVICE</code></span></dt><dd><p>
- Don't expose a device to the application. This overrides to
- the Context section from the application metadata.
+ Don't expose a device to the application. This updates
+ the [Context] group in the metadata.
DEVICE must be one of: dri, kvm, all.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--allow=FEATURE</code></span></dt><dd><p>
- Allow access to a specific feature. This overrides to
- the Context section from the application metadata.
+ Allow access to a specific feature. This updates
+ the [Context] group in the metadata.
FEATURE must be one of: devel, multiarch.
This option can be used multiple times.
+ </p><p>
+ The <code class="code">devel</code> feature allows the application to
+ access certain syscalls such as <code class="code">ptrace()</code>, and
+ <code class="code">perf_event_open()</code>.
+ </p><p>
+ The <code class="code">multiarch</code> feature allows the application to
+ execute programs compiled for an ABI other than the one supported
+ natively by the system. For example, for the <code class="code">x86_64</code>
+ architecture, 32-bit <code class="code">x86</code> binaries will be allowed as
+ well.
</p></dd><dt><span class="term"><code class="option">--disallow=FEATURE</code></span></dt><dd><p>
- Disallow access to a specific feature. This overrides to
- the Context section from the application metadata.
+ Disallow access to a specific feature. This updates
+ the [Context] group in the metadata.
FEATURE must be one of: devel, multiarch.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--filesystem=FS</code></span></dt><dd><p>
Allow the application access to a subset of the filesystem.
- This overrides to the Context section from the application metadata.
+ This updates the [Context] group in the metadata.
FS can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos, xdg-run,
- an absolute path, or a homedir-relative path like ~/dir or paths
- relative to the xdg dirs, like xdg-download/subdir.
+ xdg-config, xdg-cache, xdg-data, an absolute path, or a homedir-relative
+ path like ~/dir or paths relative to the xdg dirs, like xdg-download/subdir.
+ The optional :ro suffix indicates that the location will be read-only.
+ The optional :create suffix indicates that the location will be read-write and created if it doesn't exist.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--nofilesystem=FILESYSTEM</code></span></dt><dd><p>
+ Remove access to the specified subset of the filesystem from
+ the application. This overrides to the Context section from the
+ application metadata.
+ FILESYSTEM can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
+ xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
+ an absolute path, or a homedir-relative path like ~/dir.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--add-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
+ Add generic policy option. For example, "--add-policy=subsystem.key=v1 --add-policy=subsystem.key=v2" would map to this metadata:
+</p><pre class="programlisting">
+[Policy subsystem]
+key=v1;v2;
+</pre><p>
+ </p><p>
This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--remove-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
+ Remove generic policy option. This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--env=VAR=VALUE</code></span></dt><dd><p>
Set an environment variable in the application.
+ This updates the [Environment] group in the metadata.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--own-name=NAME</code></span></dt><dd><p>
Allow the application to own the well known name NAME on the session bus.
If NAME ends with .*, it allows the application to own all matching names.
- This overrides to the Context section from the application metadata.
+
+ This updates the [Session Bus Policy] group in the metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--talk-name=NAME</code></span></dt><dd><p>
Allow the application to talk to the well known name NAME on the session bus.
If NAME ends with .*, it allows the application to talk to all matching names.
- This overrides to the Context section from the application metadata.
+ This updates the [Session Bus Policy] group in the metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--system-own-name=NAME</code></span></dt><dd><p>
Allow the application to own the well known name NAME on the system bus.
If NAME ends with .*, it allows the application to own all matching names.
- This overrides to the Context section from the application metadata.
+ This updates the [System Bus Policy] group in the metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--system-talk-name=NAME</code></span></dt><dd><p>
Allow the application to talk to the well known name NAME on the system bus.
If NAME ends with .*, it allows the application to talk to all matching names.
- This overrides to the Context section from the application metadata.
+ This updates the [System Bus Policy] group in the metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--persist=FILENAME</code></span></dt><dd><p>
If the application doesn't have access to the real homedir, make the (homedir-relative) path
FILENAME a bind mount to the corresponding path in the per-application directory,
allowing that location to be used for persistent data.
- This overrides to the Context section from the application metadata.
+ This updates the [Context] group in the metadata.
This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--log-session-bus</code></span></dt><dd><p>
- Log session bus traffic. This can be useful to see what access you need to allow in
- your D-Bus policy.
- </p></dd><dt><span class="term"><code class="option">--log-system-bus</code></span></dt><dd><p>
- Log system bus traffic. This can be useful to see what access you need to allow in
- your D-Bus policy.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148824444320"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak run org.gnome.GEdit</strong></span>
+ </p></dd><dt><span class="term"><code class="option">--runtime=RUNTIME</code>, </span><span class="term"><code class="option">--sdk=SDK</code></span></dt><dd><p>
+ Change the runtime or sdk used by the app to the specified partial ref. Unspecified parts
+ of the ref are taken from the old values or defaults.
+ </p></dd><dt><span class="term"><code class="option">--metadata=GROUP=KEY[=VALUE]</code></span></dt><dd><p>
+ Set a generic key in the metadata file. If value is left out it will
+ be set to "true".
+ </p></dd><dt><span class="term"><code class="option">--extension=NAME=VARIABLE[=VALUE]</code></span></dt><dd><p>
+ Add extension point info.
+ </p></dd><dt><span class="term"><code class="option">--extension-priority=VALUE</code></span></dt><dd><p>
+ Set the priority (library override order) of the extension point.
+ Only useful for extensions. 0 is the default, and higher value means higher
+ priority.
+ </p></dd><dt><span class="term"><code class="option">--extra-data=NAME:SHA256:DOWNLOAD-SIZE:INSTALL-SIZE:URL</code></span></dt><dd><p>
+ Adds information about extra data uris to the app. These will be downloaded
+ and verified by the client when the app is installed and placed in the
+ /app/extra directory. You can also supply an /app/bin/apply_extra script
+ that will be run after the files are downloaded.
+ </p></dd><dt><span class="term"><code class="option">--no-exports</code></span></dt><dd><p>
+ Don't look for exports in the build.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
+ Print OSTree debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
+ Print version information and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021662060240"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak build-finish /build/my-app --socket=x11 --share=ipc</strong></span>
+ </p><pre class="programlisting">
+Exporting share/applications/gnome-calculator.desktop
+Exporting share/dbus-1/services/org.gnome.Calculator.SearchProvider.service
+More than one executable
+Using gcalccmd as command
+Please review the exported files and the metadata
+</pre></div><div class="refsect1"><a id="idm140021662057264"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-init"><span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build"><span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-export"><span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-import-bundle"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-import-bundle — Import a file bundle into a local repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-import-bundle</code> [OPTION...] LOCATION FILENAME </p></div></div><div class="refsect1"><a id="idm140021660436832"></a><h2>Description</h2><p>
+ Imports a bundle from a file named FILENAME
+ into the repository at LOCATION .
</p><p>
- <span class="command"><strong>$ flatpak run --devel --command=bash org.gnome.Builder</strong></span>
- </p></div><div class="refsect1"><a id="idm45148824441104"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-override</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-enter</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-override"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-override — Override application requirements</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak override</code> [OPTION...] APP </p></div></div><div class="refsect1"><a id="idm45148826536336"></a><h2>Description</h2><p>
- Overrides the application specified runtime requirements. This can be used
- to grant a sandboxed application more or less resources than it requested.
+ The format of the bundle file is that generated by build-bundle.
+ </p></div><div class="refsect1"><a id="idm140021659316368"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
+ Print OSTree debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--ref=REF</code></span></dt><dd><p>
+ Override the ref specified in the bundle.
+ </p></dd><dt><span class="term"><code class="option">--oci</code></span></dt><dd><p>
+ Import an OCI image instead of a Flatpak bundle.
+ </p></dd><dt><span class="term"><code class="option">--update-appstream</code></span></dt><dd><p>
+ Update the appstream branch after the build.
+ </p></dd><dt><span class="term"><code class="option">--no-update-summary</code></span></dt><dd><p>
+ Don't update the summary file after the new commit is added. This means
+ the repository will not be useful for serving over http until build-update-repo
+ has been run. This is useful is you want to do multiple repo operations before
+ finally updating the summary.
+ </p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
+ Sign the commit with this GPG key.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
+ GPG Homedir to use when looking for keyrings
+ </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
+ Print version information and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021661450496"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#ostree"><span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-bundle"><span class="citerefentry"><span class="refentrytitle">flatpak-build-bundle</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-update-repo"><span class="citerefentry"><span class="refentrytitle">flatpak-build-update-repo</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-init"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-init — Initialize a build directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-init</code> [OPTION...] DIRECTORY APPNAME SDK RUNTIME [BRANCH]</p></div></div><div class="refsect1"><a id="idm140021659386272"></a><h2>Description</h2><p>
+ Initializes a directory for building an application.
+ DIRECTORY is the name of the directory.
+ APPNAME is the application id of the app
+ that will be built.
+ SDK and RUNTIME
+ specify the sdk and runtime that the application should be built
+ against and run in.
+ </p><p>
+ The result of this command is that a <code class="filename">metadata</code>
+ file is created inside the given directory. Additionally, empty
+ <code class="filename">files</code> and <code class="filename">var</code> subdirectories
+ are created.
+ </p><p>
+ It is an error to run build-init on a directory that has already
+ been initialized as a build directory.
+ </p></div><div class="refsect1"><a id="idm140021661655680"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
+ The architecture to use.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--var=RUNTIME</code></span></dt><dd><p>
+ Initialize var from the named runtime.
+ </p></dd><dt><span class="term"><code class="option">-w</code>, </span><span class="term"><code class="option">--writable-sdk</code></span></dt><dd><p>
+ Initialize /usr with a copy of the sdk, which is writable during flatpak build. This can be used
+ if you need to install build tools in /usr during the build. This is stored in the
+ <code class="filename">usr</code> subdirectory of the app dir, but will not be part of the final
+ app.
+ </p></dd><dt><span class="term"><code class="option">--tag=TAG</code></span></dt><dd><p>
+ Add a tag to the metadata file.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--sdk-extension=EXTENSION</code></span></dt><dd><p>
+ When using --writable-sdk, in addition to the sdk, also install the specified extension.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--sdk-dir</code></span></dt><dd><p>
+ Specify a custom subdirectory to use instead of <code class="filename">usr</code> for --writable-sdk.
+ </p></dd><dt><span class="term"><code class="option">--update</code></span></dt><dd><p>
+ Re-initialize the sdk and var, don't fail if already initialized.
+ </p></dd><dt><span class="term"><code class="option">--base=APP</code></span></dt><dd><p>
+ Initialize the application with files from another specified application.
+ </p></dd><dt><span class="term"><code class="option">--base-version=VERSION</code></span></dt><dd><p>
+ Specify the version to use for --base. If not specified, will default to
+ "master".
+ </p></dd><dt><span class="term"><code class="option">--base-extension=EXTENSION</code></span></dt><dd><p>
+ When using --base, also install the specified extension from the app.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--type=TYPE</code></span></dt><dd><p>
+ This can be used to build different types of things. The default
+ is "app" which is a regular app, but "runtime" creates a runtime
+ based on an existing runtime, and "extension" creates an extension
+ for an app or runtime.
+ </p></dd><dt><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
+ Print version information and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021658856304"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak build-init /build/my-app org.gnome.Sdk org.gnome.Platform 3.16</strong></span>
+ </p></div><div class="refsect1"><a id="idm140021658854176"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build"><span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-finish"><span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-export"><span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-sign"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-sign — Sign an application or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-sign</code> [OPTION...] LOCATION ID [BRANCH]</p></div></div><div class="refsect1"><a id="idm140021658809232"></a><h2>Description</h2><p>
+ Signs the commit for a specified application or runtime in
+ a local repository. LOCATION is
+ the location of the repository. ID is the name of the application, or
+ runtime if --runtime is specified. If BRANCH is not specified, it is
+ assumed to be "master".
</p><p>
- By default the application gets access to the resources it
- requested when it is started. But the user can override it
- on a particular instance by specifying extra arguments to
- flatpak run, or every time by using flatpak override.
- </p></div><div class="refsect1"><a id="idm45148825305904"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Applications can also be signed during build-export, but
+ it is sometimes useful to add additional signatures later.
+ </p></div><div class="refsect1"><a id="idm140021658804336"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
+ Sign the commit with this GPG key.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
+ GPG Homedir to use when looking for keyrings
+ </p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
+ Sign a runtime instead of an app.
+ </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
+ The architecture to use.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
+ Print OSTree debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
+ Print version information and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021659080048"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak build-sign --gpg-sign=D8BA6573DDD2418027736F1BC33B315E53C1E9D6 /some/repo org.my.App</strong></span>
+ </p></div><div class="refsect1"><a id="idm140021657733632"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#ostree"><span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-export"><span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build"><span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span></a>,
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-update-repo"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-update-repo — Create a repository from a build directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-update-repo</code> [OPTION...] LOCATION </p></div></div><div class="refsect1"><a id="idm140021658879936"></a><h2>Description</h2><p>
+ Updates repository metadata for the repository at
+ LOCATION . This command generates
+ an OSTree summary file that lists the contents of the repository.
+ The summary is used by flatpak remote-ls and other commands
+ to display the contents of remote repositories.
+ </p><p>
+ After this command, LOCATION can be
+ used as the repository location for flatpak remote-add, either by
+ exporting it over http, or directly with a file: url.
+ </p></div><div class="refsect1"><a id="idm140021661290384"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">--redirect-url=URL</code></span></dt><dd><p>
+ Redirect this repo to a new URL.
+ </p></dd><dt><span class="term"><code class="option">--title=TITLE</code></span></dt><dd><p>
+ A title for the repository, e.g. for display in a UI.
+ The title is stored in the repository summary.
+ </p></dd><dt><span class="term"><code class="option">--default-branch=BRANCH</code></span></dt><dd><p>
+ A default branch for the repository, mainly for use in a UI.
+ </p></dd><dt><span class="term"><code class="option">--gpg-import=FILE</code></span></dt><dd><p>
+ Import a new default GPG public key from the
+ given file.
+ </p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
+ Sign the commit with this GPG key.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
+ GPG Homedir to use when looking for keyrings
+ </p></dd><dt><span class="term"><code class="option">--generate-static-deltas</code></span></dt><dd><p>
+ Generate static deltas for all references. This generates from-empty and
+ delta static files that allow for faster download.
+ </p></dd><dt><span class="term"><code class="option">--prune</code></span></dt><dd><p>
+ Remove unreferenced objects in repo.
+ </p></dd><dt><span class="term"><code class="option">--prune-depth</code></span></dt><dd><p>
+ Only keep at most this number of old versions for any particular ref. Default is -1 which means infinite.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
+ Print OSTree debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
+ Print version information and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021658546672"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#ostree"><span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remote-ls"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-ls</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-export"><span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build — Build in a directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build</code> [OPTION...] DIRECTORY [COMMAND [ARG...]]</p></div></div><div class="refsect1"><a id="idm140021661668896"></a><h2>Description</h2><p>
+ Runs a build command in a directory. DIRECTORY
+ must have been initialized with <span class="command"><strong>flatpak build-init</strong></span>.
+ </p><p>
+ The sdk that is specified in the <code class="filename">metadata</code> file
+ in the directory is mounted at <code class="filename">/usr</code> and the
+ <code class="filename">files</code> and <code class="filename">var</code> subdirectories
+ are mounted at <code class="filename">/app</code> and <code class="filename">/var</code>,
+ respectively. They are writable, and their contents are preserved between
+ build commands, to allow accumulating build artifacts there.
+ </p></div><div class="refsect1"><a id="idm140021659594224"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">-r</code>, </span><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
+ Use the non-devel runtime that is specified in the application metadata instead of the devel runtime.
+ </p></dd><dt><span class="term"><code class="option">-p</code>, </span><span class="term"><code class="option">--die-with-parent</code></span></dt><dd><p>
+ Kill the build process and all children when the launching process dies.
+ </p></dd><dt><span class="term"><code class="option">--bind-mount=DEST=SOURCE</code></span></dt><dd><p>
+ Add a custom bind mount in the build namespace. Can be specified multiple times.
+ </p></dd><dt><span class="term"><code class="option">--build-dir=PATH</code></span></dt><dd><p>
+ Start the build in this directory (default is in the current directory).
</p></dd><dt><span class="term"><code class="option">--share=SUBSYSTEM</code></span></dt><dd><p>
Share a subsystem with the host session. This overrides
the Context section from the application metadata.
@@ -425,12 +704,12 @@ org.gnome.GEdit
</p></dd><dt><span class="term"><code class="option">--socket=SOCKET</code></span></dt><dd><p>
Expose a well-known socket to the application. This overrides to
the Context section from the application metadata.
- SOCKET must be one of: x11, wayland, pulseaudio, system-bus, session-bus.
+ SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nosocket=SOCKET</code></span></dt><dd><p>
Don't expose a well-known socket to the application. This overrides to
the Context section from the application metadata.
- SOCKET must be one of: x11, wayland, pulseaudio, system-bus, session-bus.
+ SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--device=DEVICE</code></span></dt><dd><p>
Expose a device to the application. This overrides to
@@ -442,14 +721,57 @@ org.gnome.GEdit
the Context section from the application metadata.
DEVICE must be one of: dri, kvm, all.
This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--filesystem=FS</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="option">--allow=FEATURE</code></span></dt><dd><p>
+ Allow access to a specific feature. This updates
+ the [Context] group in the metadata.
+ FEATURE must be one of: devel, multiarch.
+ This option can be used multiple times.
+ </p><p>
+ The <code class="code">devel</code> feature allows the application to
+ access certain syscalls such as <code class="code">ptrace()</code>, and
+ <code class="code">perf_event_open()</code>.
+ </p><p>
+ The <code class="code">multiarch</code> feature allows the application to
+ execute programs compiled for an ABI other than the one supported
+ natively by the system. For example, for the <code class="code">x86_64</code>
+ architecture, 32-bit <code class="code">x86</code> binaries will be allowed as
+ well.
+ </p></dd><dt><span class="term"><code class="option">--disallow=FEATURE</code></span></dt><dd><p>
+ Disallow access to a specific feature. This updates
+ the [Context] group in the metadata.
+ FEATURE must be one of: devel, multiarch.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--filesystem=FILESYSTEM[:ro|:create]</code></span></dt><dd><p>
Allow the application access to a subset of the filesystem.
This overrides to the Context section from the application metadata.
- FS can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
+ FILESYSTEM can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos, xdg-run,
- an absolute path, or a homedir-relative path like ~/dir or paths
- relative to the xdg dirs, like xdg-download/subdir.
+ xdg-config, xdg-cache, xdg-data, an absolute path, or a homedir-relative
+ path like ~/dir or paths relative to the xdg dirs, like xdg-download/subdir.
+ The optional :ro suffix indicates that the location will be read-only.
+ The optional :create suffix indicates that the location will be read-write and created if it doesn't exist.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--nofilesystem=FILESYSTEM</code></span></dt><dd><p>
+ Remove access to the specified subset of the filesystem from
+ the application. This overrides to the Context section from the
+ application metadata.
+ FILESYSTEM can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
+ xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
+ an absolute path, or a homedir-relative path like ~/dir.
This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--with-appdir</code></span></dt><dd><p>
+ Expose and configure access to the per-app storage directory in $HOME/.var/app. This is
+ not normally useful when building, but helps when testing built apps.
+ </p></dd><dt><span class="term"><code class="option">--add-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
+ Add generic policy option. For example, "--add-policy=subsystem.key=v1 --add-policy=subsystem.key=v2" would map to this metadata:
+</p><pre class="programlisting">
+[Policy subsystem]
+key=v1;v2;
+</pre><p>
+ </p><p>
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--remove-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
+ Remove generic policy option. This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--env=VAR=VALUE</code></span></dt><dd><p>
Set an environment variable in the application.
This overrides to the Context section from the application metadata.
@@ -463,13 +785,11 @@ org.gnome.GEdit
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--system-own-name=NAME</code></span></dt><dd><p>
- Allow the application to own the well known name NAME on the system bus.
- If NAME ends with .*, it allows the application to own all matching names.
+ Allow the application to own the well-known name NAME on the system bus.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--system-talk-name=NAME</code></span></dt><dd><p>
- Allow the application to talk to the well known name NAME on the system bus.
- If NAME ends with .*, it allows the application to talk to all matching names.
+ Allow the application to talk to the well-known name NAME on the system bus.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--persist=FILENAME</code></span></dt><dd><p>
@@ -478,39 +798,60 @@ org.gnome.GEdit
allowing that location to be used for persistent data.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
- Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
- Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148824795008"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak override --nosocket=wayland org.gnome.GEdit</strong></span>
- </p><p>
- <span class="command"><strong>$ flatpak override --filesystem=home org.mozilla.Firefox</strong></span>
- </p></div><div class="refsect1"><a id="idm45148824791840"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-run</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-enter"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-enter — Enter an application</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak enter</code> [OPTION...] MONITORPID COMMAND [ARG...]</p></div></div><div class="refsect1"><a id="idm45148826366416"></a><h2>Description</h2><p>
- Enter a running sandbox.
- SANDBOXEDPID must be the pid of a process running in a flatpak sandbox.
- COMMAND is the command to run in the sandbox.
- Extra arguments are passed on to the command.
- </p><p>
- This creates a new process within the running sandbox, with the same environment. This is useful
- when you want to debug a problem with a running application.
- </p><p>
- This command requires extra privileges, so must be run as root or via e.g. sudo.
- </p></div><div class="refsect1"><a id="idm45148825258624"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="option">--sdk-dir=DIR</code></span></dt><dd><p>
+ Normally if there is a <code class="filename">usr</code> directory in the build dir, this is used
+ for the runtime files (this can be created by --writable-sdk or --type=runtime arguments
+ to build-init). If you specify --sdk-dir this directoryname will be used instead.
+ Use this if you passed --sdk-dir to build-init.
+ </p></dd><dt><span class="term"><code class="option">--readonly</code></span></dt><dd><p>
+ Mount the normally writable destination directories read-only. This can
+ be useful if you want to run something in the sandbox but guarantee that
+ it doesn't affect the build results. For example tests.
+ </p></dd><dt><span class="term"><code class="option">--metadata=FILE</code></span></dt><dd><p>
+ Use the specified filename as metadata in the exported app instead of
+ the default file (called <code class="filename">metadata</code>). This is useful
+ if you build multiple things from a single build tree (such as both a
+ platform and a sdk).
+ </p></dd><dt><span class="term"><code class="option">--log-session-bus</code></span></dt><dd><p>
+ Log session bus traffic. This can be useful to see what access you need to allow in
+ your D-Bus policy.
+ </p></dd><dt><span class="term"><code class="option">--log-system-bus</code></span></dt><dd><p>
+ Log system bus traffic. This can be useful to see what access you need to allow in
+ your D-Bus policy.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021657376048"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak build /build/my-app rpmbuild my-app.src.rpm</strong></span>
+ </p></div><div class="refsect1"><a id="idm140021657374016"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-init"><span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-finish"><span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-export"><span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-config"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-config — Manage configuration</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak config</code> [OPTION...] KEY VALUE </p></div></div><div class="refsect1"><a id="idm140021658621328"></a><h2>Description</h2><p>
+ Show and modify current configuration
+ </p></div><div class="refsect1"><a id="idm140021658620016"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
- Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
- Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148826648480"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak enter 15345 sh</strong></span>
- </p></div><div class="refsect1"><a id="idm45148827561344"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-run</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-document-export"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-document-export — Export a file to a sandboxed application</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak document-export</code> [OPTION...] FILE </p></div></div><div class="refsect1"><a id="idm45148829210992"></a><h2>Description</h2><p>
+ </p></dd><dt><span class="term"><code class="option">--list</code></span></dt><dd><p>
+ Print all keys and their values
+ </p></dd><dt><span class="term"><code class="option">--set</code></span></dt><dd><p>
+ Set key KEY to VALUE
+ </p></dd><dt><span class="term"><code class="option">--unset</code></span></dt><dd><p>
+ Unset key KEY
+ </p></dd><dt><span class="term"><code class="option">--get</code></span></dt><dd><p>
+ Print value of KEY.
+ </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
+ Configure per-user installation.
+ </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
+ Configure system-wide installation.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ Configure the system-wide installation
+ specified by NAME among those defined in
+ <code class="filename">/etc/flatpak/installations.d/</code>. Using
+ --installation=default is equivalent to using
+ --system .
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021661861776"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak config --set language sv;en;fi</strong></span>
+ </p></div><div class="refsect1"><a id="idm140021661859744"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-document-export"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-document-export — Export a file to a sandboxed application</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak document-export</code> [OPTION...] FILE </p></div></div><div class="refsect1"><a id="idm140021657514944"></a><h2>Description</h2><p>
Creates a document id for a local file that can be exposed to
sandboxed applications, allowing them access to files that they
would not otherwise see. The exported files are exposed in a
@@ -519,33 +860,35 @@ org.gnome.GEdit
This command also lets you modify the per-application
permissions of the documents, granting or revoking access
to the file on a per-application basis.
- </p></div><div class="refsect1"><a id="idm45148826038416"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ </p></div><div class="refsect1"><a id="idm140021661713728"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">--unique</code></span></dt><dd><p> Don't reuse an existing document id
+ </p></dd><dt><span class="term"><code class="option">-u</code>, </span><span class="term"><code class="option">--unique</code></span></dt><dd><p> Don't reuse an existing document id
for the file. This makes it safe to later remove the
document when you're finished with it.
- </p></dd><dt><span class="term"><code class="option">--transient</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="option">-t</code>, </span><span class="term"><code class="option">--transient</code></span></dt><dd><p>
The document will only exist for the length of
the session. This is useful for temporary grants.
- </p></dd><dt><span class="term"><code class="option">--app=APPID</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="option">-n</code>, </span><span class="term"><code class="option">--noexist</code></span></dt><dd><p>
+ Don't require the file to exist already.
+ </p></dd><dt><span class="term"><code class="option">-a</code>, </span><span class="term"><code class="option">--app=APPID</code></span></dt><dd><p>
Grant read access to the specified application. The
--allow and --forbid options can be used to grant
or remove additional privileges.
This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--allow-read</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="option">-r</code>, </span><span class="term"><code class="option">--allow-read</code></span></dt><dd><p>
Grant read access to the applications specified with --app.
This defaults to TRUE.
</p></dd><dt><span class="term"><code class="option">--forbid-read</code></span></dt><dd><p>
Revoke read access for the applications specified with --app.
- </p></dd><dt><span class="term"><code class="option">--allow-write</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="option">-w</code>, </span><span class="term"><code class="option">--allow-write</code></span></dt><dd><p>
Grant write access to the applications specified with --app.
</p></dd><dt><span class="term"><code class="option">--forbid-write</code></span></dt><dd><p>
Revoke write access for the applications specified with --app.
- </p></dd><dt><span class="term"><code class="option">--allow-delete</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="option">-d</code>, </span><span class="term"><code class="option">--allow-delete</code></span></dt><dd><p>
Grant the ability to remove the document from the document portal to the applications specified with --app.
</p></dd><dt><span class="term"><code class="option">--forbid-delete</code></span></dt><dd><p>
Revoke the ability to remove the document from the document portal from the applications specified with --app.
- </p></dd><dt><span class="term"><code class="option">--allow-grant-permission</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="option">-g</code>, </span><span class="term"><code class="option">--allow-grant-permission</code></span></dt><dd><p>
Grant the ability to grant further permissions to the applications specified with --app.
</p></dd><dt><span class="term"><code class="option">--forbid-grant-permission</code></span></dt><dd><p>
Revoke the ability to grant further permissions for the applications specified with --app.
@@ -553,44 +896,29 @@ org.gnome.GEdit
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148826387808"></a><h2>Examples</h2><p>
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021656917552"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak document-export --app=org.gnome.GEdit ~/test.txt</strong></span>
</p><pre class="programlisting">
/run/user/1000/doc/e52f9c6a/test.txt
-</pre></div><div class="refsect1"><a id="idm45148825768544"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-document-unexport</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-document-info</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-document-list</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-document-unexport"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-document-unexport — Stop exporting a file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak document-export</code> [OPTION...] FILE </p></div></div><div class="refsect1"><a id="idm45148825173872"></a><h2>Description</h2><p>
- Removes the document id for the file from the
- document portal. This will make the document unavailable
- to all sandboxed applications.
- </p></div><div class="refsect1"><a id="idm45148826181632"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
- Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
- Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
- Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148826094672"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-document-export</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-document-info</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-document-list</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-document-info"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-document-info — Show information about exported files</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak document-info</code> [OPTION...] FILE </p></div></div><div class="refsect1"><a id="idm45148829175424"></a><h2>Description</h2><p>
+</pre></div><div class="refsect1"><a id="idm140021656918704"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-document-unexport"><span class="citerefentry"><span class="refentrytitle">flatpak-document-unexport</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-document-info"><span class="citerefentry"><span class="refentrytitle">flatpak-document-info</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-document-list"><span class="citerefentry"><span class="refentrytitle">flatpak-document-list</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-document-info"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-document-info — Show information about exported files</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak document-info</code> [OPTION...] FILE </p></div></div><div class="refsect1"><a id="idm140021661851600"></a><h2>Description</h2><p>
Shows information about an exported file, such as the
document id, the fuse path, the original location in the
filesystem, and the per-application permissions.
</p><p>
FILE can either be a file in the fuse filesystem at /run/user/$UID/doc/,
or a file anywhere else.
- </p></div><div class="refsect1"><a id="idm45148828087280"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ </p></div><div class="refsect1"><a id="idm140021661849728"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148824882848"></a><h2>Examples</h2><p>
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021661731696"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak document-info ~/Sources/gtk/gail-3.0.pc</strong></span>
</p><pre class="programlisting">
id: dd32c34a
@@ -598,44 +926,450 @@ path: /run/user/1000/doc/dd32c34a/gail-3.0.pc
origin: /home/mclasen/Sources/gtk/gail-3.0.pc
permissions:
org.gnome.gedit read, write
-</pre></div><div class="refsect1"><a id="idm45148825239840"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-document-export</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-document-unexport</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-document-list</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-document-list"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-document-list — List exported files</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak document-list</code> [OPTION...] [APPID]</p></div></div><div class="refsect1"><a id="idm45148828096176"></a><h2>Description</h2><p>
+</pre></div><div class="refsect1"><a id="idm140021662003616"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-document-export"><span class="citerefentry"><span class="refentrytitle">flatpak-document-export</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-document-unexport"><span class="citerefentry"><span class="refentrytitle">flatpak-document-unexport</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-document-list"><span class="citerefentry"><span class="refentrytitle">flatpak-document-list</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-document-list"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-document-list — List exported files</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak document-list</code> [OPTION...] [APPID]</p></div></div><div class="refsect1"><a id="idm140021657626288"></a><h2>Description</h2><p>
Lists exported files, with their document id and the
full path to their origin. If an APPID is specified,
only the files exported to this app are listed.
- </p></div><div class="refsect1"><a id="idm45148828276624"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ </p></div><div class="refsect1"><a id="idm140021657624976"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148826334720"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-document-export</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-document-unexport</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-document-info</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-add"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-add — Add a remote repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remote-add</code> [OPTION...] NAME LOCATION </p></div></div><div class="refsect1"><a id="idm45148826162448"></a><h2>Description</h2><p>
- Adds a remote repository to the flatpak repository configuration.
- NAME is the name for the new remote, and
- LOCATION is the url or pathname for the repository.
- </p><p>
- Unless overridden with the --user option, this command changes
- the system-wide configuration.
- </p><p>
- The alternative form of the command adds a remote from a flatpakrepo
- file.
- </p></div><div class="refsect1"><a id="idm45148827304064"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021656615440"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-document-export"><span class="citerefentry"><span class="refentrytitle">flatpak-document-export</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-document-unexport"><span class="citerefentry"><span class="refentrytitle">flatpak-document-unexport</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-document-info"><span class="citerefentry"><span class="refentrytitle">flatpak-document-info</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-document-unexport"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-document-unexport — Stop exporting a file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak document-export</code> [OPTION...] FILE </p></div></div><div class="refsect1"><a id="idm140021659410032"></a><h2>Description</h2><p>
+ Removes the document id for the file from the
+ document portal. This will make the document unavailable
+ to all sandboxed applications.
+ </p></div><div class="refsect1"><a id="idm140021659408528"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
+ Print version information and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021656845536"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-document-export"><span class="citerefentry"><span class="refentrytitle">flatpak-document-export</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-document-info"><span class="citerefentry"><span class="refentrytitle">flatpak-document-info</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-document-list"><span class="citerefentry"><span class="refentrytitle">flatpak-document-list</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-enter"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-enter — Enter an application</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak enter</code> [OPTION...] MONITORPID COMMAND [ARG...]</p></div></div><div class="refsect1"><a id="idm140021661350128"></a><h2>Description</h2><p>
+ Enter a running sandbox.
+ SANDBOXEDPID must be the pid of a process running in a flatpak sandbox.
+ COMMAND is the command to run in the sandbox.
+ Extra arguments are passed on to the command.
+ </p><p>
+ This creates a new process within the running sandbox, with the same environment. This is useful
+ when you want to debug a problem with a running application.
+ </p><p>
+ This command requires extra privileges, so must be run as root or via e.g. sudo.
+ </p></div><div class="refsect1"><a id="idm140021661345824"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
+ Print version information and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021660744080"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak enter 15345 sh</strong></span>
+ </p></div><div class="refsect1"><a id="idm140021660742048"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-run"><span class="citerefentry"><span class="refentrytitle">flatpak-run</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-info"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-info — Show information about installed application and/or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak info</code> [OPTION...] NAME [BRANCH]</p></div></div><div class="refsect1"><a id="idm140021661276944"></a><h2>Description</h2><p>
+ Show info about and installed application and/or runtime.
+ </p><p>
+ By default, the output is formatted in a friendly format.
+ If you specify one of the options --show-ref, --show-commit,
+ --show-origin, --show-metadata or --show-size, the output is instead formatted
+ in a machine-readable format.
+ </p><p>
+ By default, both per-user and system-wide installations
+ are queried. Use the --user, --system or --installation
+ options to change this.
+ </p></div><div class="refsect1"><a id="idm140021656629264"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
+ Query per-user installations.
+ </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
+ Query the default system-wide installation.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ Query a system-wide installation by NAME among
+ those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
+ Using --installation=default is equivalent to using
+ --system .
+ </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
+ Query for this architecture.
+ </p></dd><dt><span class="term"><code class="option">-r</code>, </span><span class="term"><code class="option">--show-ref</code></span></dt><dd><p>
+ Show the installed ref.
+ </p></dd><dt><span class="term"><code class="option">-o</code>, </span><span class="term"><code class="option">--show-origin</code></span></dt><dd><p>
+ Show the remote the ref is installed from.
+ </p></dd><dt><span class="term"><code class="option">-c</code>, </span><span class="term"><code class="option">--show-commit</code></span></dt><dd><p>
+ Show the installed commit id.
+ </p></dd><dt><span class="term"><code class="option">-s</code>, </span><span class="term"><code class="option">--show-size</code></span></dt><dd><p>
+ Show the installed size.
+ </p></dd><dt><span class="term"><code class="option">-m</code>, </span><span class="term"><code class="option">--show-metadata</code></span></dt><dd><p>
+ Show the metadata.
+ </p></dd><dt><span class="term"><code class="option">-e</code>, </span><span class="term"><code class="option">--show-extensions</code></span></dt><dd><p>
+ Show the matching extensions.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
+ Print version information and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021661000864"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak info org.gnome.Builder//master</strong></span>
+ </p></div><div class="refsect1"><a id="idm140021660998944"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-install"><span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-update"><span class="citerefentry"><span class="refentrytitle">flatpak-update</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-install"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-install — Install an application or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p>Install from a configured remote:</p><div class="cmdsynopsis"><p><code class="command">flatpak install</code> [OPTION...] REMOTE-NAME REF... </p></div><p>Install from a .flatpakref file:</p><div class="cmdsynopsis"><p><code class="command">flatpak install</code> [OPTION...] [--from] LOCATION </p></div><p>Install from a .flatpak bundle:</p><div class="cmdsynopsis"><p><code class="command">flatpak install</code> [OPTION...] [--bundle] FILENAME </p></div></div><div class="refsect1"><a id="idm140021657017888"></a><h2>Description</h2><p>
+ Installs an application or runtime. The primary way to
+ install is to specify a [REMOTE]
+ name as the source and one ore more [REF]s to specify the
+ application or runtime to install.
+ </p><p>
+ Each REF argument is a full or partial indentifier in the
+ flatpak ref format, which looks like "(app|runtime)/ID/ARCH/BRANCH". All elements
+ except ID are optional and can be left out, including the slashes,
+ so most of the time you need only specify ID. Any part left out will be matched
+ against what is in the remote, and if there are multiple matches an error message
+ will list the alternatives.
+ </p><p>
+ By default this looks for both apps and runtimes with the given REF in
+ the specified REMOTE , but you can limit this by using the --app or
+ --runtime option, or by supplying the initial element in the REF.
+ </p><p>
+ If REMOTE is a uri or a path (absolute or relative starting with ./)
+ to a local repository, then that repository will be used as the source, and a temporary remote
+ will be created for the lifetime of the REF .
+ </p><p>
+ The alternative form of the command ([--from] or
+ [--bundle] allows you to
+ install directly from a source such as a .flatpak
+ single-file bundle, a .flatpakref app description. The options are optional if the first
+ argument have the right extension.
+ </p><p>
+ Note that flatpak allows one to have multiple branches of an application and runtimes
+ installed and used at the same time. However, only version of an application one can be current,
+ meaning its exported files (for instance desktop files and icons) are
+ visible to the host. The last installed version is made current by
+ default, but you can manually change with make-current.
+ </p><p>
+ Unless overridden with the --user or the --installation option, this command installs
+ the application or runtime in the default system-wide installation.
+ </p></div><div class="refsect1"><a id="idm140021656787904"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">--bundle</code></span></dt><dd><p>
+ Assume LOCATION is a .flatpak single-bundle file.
+ This is optional if the arguments ends with .flatpak.
</p></dd><dt><span class="term"><code class="option">--from</code></span></dt><dd><p>
- Add from a flatpakrepo file (local or http uri) instead of from commandline arguments. This means the LOCATION argument specifies the filename/uri of a flatpakref rather than a repo url.
+ Assume LOCATION is a .flatpakref file containing the details of the app to be installed.
+ This is optional if the arguments ends with .flatpakref.
+ </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
+ Install the application or runtime in a per-user installation.
+ </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
+ Install the application or runtime in the default system-wide installation.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ Install the application or runtime in a system-wide installation
+ specified by NAME among those defined in
+ <code class="filename">/etc/flatpak/installations.d/</code>. Using
+ --installation=default is equivalent to using
+ --system .
+ </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
+ The default architecture to install for, if not given explicitly in the REF .
+ </p></dd><dt><span class="term"><code class="option">--subpath=PATH</code></span></dt><dd><p>
+ Install only a subpath of the ref. This is mainly used to install a subset of locales.
+ This can be added multiple times to install multiple subpaths.,
+ </p></dd><dt><span class="term"><code class="option">--gpg-file=FILE</code></span></dt><dd><p>
+ Check bundle signatures with GPG key from FILE (- for stdin).
+ </p></dd><dt><span class="term"><code class="option">--no-deploy</code></span></dt><dd><p>
+ Download the latest version, but don't deploy it.
+ </p></dd><dt><span class="term"><code class="option">--no-pull</code></span></dt><dd><p>
+ Don't download the latest version, deploy whatever is locally available.
+ </p></dd><dt><span class="term"><code class="option">--no-related</code></span></dt><dd><p>
+ Don't download related extensions, such as the locale data.
+ </p></dd><dt><span class="term"><code class="option">--no-deps</code></span></dt><dd><p>
+ Don't verify runtime dependencies when installing.
+ </p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
+ Assume that all REF s are apps if not explicitly specified.
+ </p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
+ Assume that all REF s are runtimes if not explicitly specified.
+ </p></dd><dt><span class="term"><code class="option">-y</code>, </span><span class="term"><code class="option">--assumeyes</code></span></dt><dd><p>
+ Automatically answer yes to all questions (or pick the most prioritized answer). This is useful for automation.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
+ Print OSTree debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
+ Print version information and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021657342592"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak install gnome org.gnome.gedit2</strong></span>
+ </p><p>
+ <span class="command"><strong>$ flatpak --installation=default install gnome org.gnome.gedit2</strong></span>
+ </p><p>
+ <span class="command"><strong>$ flatpak --user install gnome org.gnome.gedit//3.22</strong></span>
+ </p><p>
+ <span class="command"><strong>$ flatpak --user install https://sdk.gnome.org/gedit.flatpakref</strong></span>
+ </p></div><div class="refsect1"><a id="idm140021657337152"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-update"><span class="citerefentry"><span class="refentrytitle">flatpak-update</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-list"><span class="citerefentry"><span class="refentrytitle">flatpak-list</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-build-bundle"><span class="citerefentry"><span class="refentrytitle">flatpak-build-bundle</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-flatpakref"><span class="citerefentry"><span class="refentrytitle">flatpak-flatpakref</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-list"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-list — List installed applications and/or runtimes</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak list</code> [OPTION...]</p></div></div><div class="refsect1"><a id="idm140021657876320"></a><h2>Description</h2><p>
+ Lists the names of the installed applications and/or runtime.
+ </p><p>
+ By default, both per-user and system-wide installations
+ are shown. Use the --user, --installation or --system
+ options to change this.
+ </p><p>
+ By default this lists both installed apps and runtime, but you can
+ change this by using the --app or --runtime option.
+ </p></div><div class="refsect1"><a id="idm140021656867920"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
+ List per-user installations.
+ </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
+ List the default system-wide installations.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ List a system-wide installation specified by NAME
+ among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
+ Using --installation=default is equivalent to using
+ --system .
+ </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
+ List installations for this architecture.
+ </p></dd><dt><span class="term"><code class="option">-d</code>, </span><span class="term"><code class="option">--show-details</code></span></dt><dd><p>
+ Show origin, sizes and other extra information.
+ </p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
+ List applications.
+ </p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
+ List runtimes.
+ </p></dd><dt><span class="term"><code class="option">--all</code>, </span><span class="term"><code class="option">-a</code></span></dt><dd><p>
+ List all installed runtimes, including locale and debug extensions. These are hidden by default.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
+ Print OSTree debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
+ Print version information and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021657587424"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak --user list</strong></span>
+ </p><pre class="programlisting">
+org.gnome.Builder
+org.freedesktop.glxgears
+org.gnome.MyApp
+org.gnome.GEdit
+</pre></div><div class="refsect1"><a id="idm140021658774752"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-install"><span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-update"><span class="citerefentry"><span class="refentrytitle">flatpak-update</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-make-current"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-make-current — Make a specific version of an app current</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak make-current</code> [OPTION...] APP BRANCH </p></div></div><div class="refsect1"><a id="idm140021659414192"></a><h2>Description</h2><p>
+ Makes a particular branch of an application current. Only the current branch
+ of an app has its exported files (such as desktop files and icons) made visible
+ to the host.
+ </p><p>
+ When a new branch is installed it will automatically be made current, so this
+ command is often not needed.
+ </p><p>
+ Unless overridden with the --user or --installation options, this command
+ changes the default system-wide installation.
+ </p></div><div class="refsect1"><a id="idm140021660985648"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
+ Update a per-user installation.
+ </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
+ Update the default system-wide installation.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ Updates a system-wide installation specified by NAME
+ among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
+ Using --installation=default is equivalent to using
+ --system .
+ </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
+ The architecture to install for.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
+ Print version information and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021659006320"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak --user make-current org.gnome.GEdit 3.14</strong></span>
+ </p></div><div class="refsect1"><a id="idm140021657150192"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-install"><span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-list"><span class="citerefentry"><span class="refentrytitle">flatpak-list</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-override"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-override — Override application requirements</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak override</code> [OPTION...] [APP]</p></div></div><div class="refsect1"><a id="idm140021657567920"></a><h2>Description</h2><p>
+ Overrides the application specified runtime requirements. This can be used
+ to grant a sandboxed application more or less resources than it requested.
+ </p><p>
+ By default the application gets access to the resources it
+ requested when it is started. But the user can override it
+ on a particular instance by specifying extra arguments to
+ flatpak run, or every time by using flatpak override.
+ </p><p>
+ If the application id is not specified then the overrides affect all applications,
+ but the per-application overrides can override the global overrides.
+ </p><p>
+ Unless overridden with the --user or --installation options, this command
+ changes the default system-wide installation.
+ </p></div><div class="refsect1"><a id="idm140021657565168"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
+ Update a per-user installation.
+ </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
+ Update the default system-wide installation.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ Updates a system-wide installation specified by NAME
+ among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
+ Using --installation=default is equivalent to using
+ --system .
+ </p></dd><dt><span class="term"><code class="option">--share=SUBSYSTEM</code></span></dt><dd><p>
+ Share a subsystem with the host session. This overrides
+ the Context section from the application metadata.
+ SUBSYSTEM must be one of: network, ipc.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--unshare=SUBSYSTEM</code></span></dt><dd><p>
+ Don't share a subsystem with the host session. This overrides
+ the Context section from the application metadata.
+ SUBSYSTEM must be one of: network, ipc.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--socket=SOCKET</code></span></dt><dd><p>
+ Expose a well-known socket to the application. This overrides to
+ the Context section from the application metadata.
+ SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--nosocket=SOCKET</code></span></dt><dd><p>
+ Don't expose a well-known socket to the application. This overrides to
+ the Context section from the application metadata.
+ SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--device=DEVICE</code></span></dt><dd><p>
+ Expose a device to the application. This overrides to
+ the Context section from the application metadata.
+ DEVICE must be one of: dri, kvm, all.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--nodevice=DEVICE</code></span></dt><dd><p>
+ Don't expose a device to the application. This overrides to
+ the Context section from the application metadata.
+ DEVICE must be one of: dri, kvm, all.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--allow=FEATURE</code></span></dt><dd><p>
+ Allow access to a specific feature. This updates
+ the [Context] group in the metadata.
+ FEATURE must be one of: devel, multiarch.
+ This option can be used multiple times.
+ </p><p>
+ The <code class="code">devel</code> feature allows the application to
+ access certain syscalls such as <code class="code">ptrace()</code>, and
+ <code class="code">perf_event_open()</code>.
+ </p><p>
+ The <code class="code">multiarch</code> feature allows the application to
+ execute programs compiled for an ABI other than the one supported
+ natively by the system. For example, for the <code class="code">x86_64</code>
+ architecture, 32-bit <code class="code">x86</code> binaries will be allowed as
+ well.
+ </p></dd><dt><span class="term"><code class="option">--disallow=FEATURE</code></span></dt><dd><p>
+ Disallow access to a specific feature. This updates
+ the [Context] group in the metadata.
+ FEATURE must be one of: devel, multiarch.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--filesystem=FS</code></span></dt><dd><p>
+ Allow the application access to a subset of the filesystem.
+ This overrides to the Context section from the application metadata.
+ FS can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
+ xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos, xdg-run,
+ xdg-config, xdg-cache, xdg-data,
+ an absolute path, or a homedir-relative path like ~/dir or paths
+ relative to the xdg dirs, like xdg-download/subdir.
+ The optional :ro suffix indicates that the location will be read-only.
+ The optional :create suffix indicates that the location will be read-write and created if it doesn't exist.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--nofilesystem=FILESYSTEM</code></span></dt><dd><p>
+ Remove access to the specified subset of the filesystem from
+ the application. This overrides to the Context section from the
+ application metadata.
+ FILESYSTEM can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
+ xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
+ an absolute path, or a homedir-relative path like ~/dir.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--add-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
+ Add generic policy option. For example, "--add-policy=subsystem.key=v1 --add-policy=subsystem.key=v2" would map to this metadata:
+</p><pre class="programlisting">
+[Policy subsystem]
+key=v1;v2;
+</pre><p>
+ </p><p>
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--remove-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
+ Remove generic policy option. This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--env=VAR=VALUE</code></span></dt><dd><p>
+ Set an environment variable in the application.
+ This overrides to the Context section from the application metadata.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--own-name=NAME</code></span></dt><dd><p>
+ Allow the application to own the well-known name NAME on the session bus.
+ This overrides to the Context section from the application metadata.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--talk-name=NAME</code></span></dt><dd><p>
+ Allow the application to talk to the well-known name NAME on the session bus.
+ This overrides to the Context section from the application metadata.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--system-own-name=NAME</code></span></dt><dd><p>
+ Allow the application to own the well known name NAME on the system bus.
+ If NAME ends with .*, it allows the application to own all matching names.
+ This overrides to the Context section from the application metadata.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--system-talk-name=NAME</code></span></dt><dd><p>
+ Allow the application to talk to the well known name NAME on the system bus.
+ If NAME ends with .*, it allows the application to talk to all matching names.
+ This overrides to the Context section from the application metadata.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--persist=FILENAME</code></span></dt><dd><p>
+ If the application doesn't have access to the real homedir, make the (homedir-relative) path
+ FILENAME a bind mount to the corresponding path in the per-application directory,
+ allowing that location to be used for persistent data.
+ This overrides to the Context section from the application metadata.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
+ Print version information and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021656254320"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak override --nosocket=wayland org.gnome.GEdit</strong></span>
+ </p><p>
+ <span class="command"><strong>$ flatpak override --filesystem=home org.mozilla.Firefox</strong></span>
+ </p></div><div class="refsect1"><a id="idm140021656251152"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-run"><span class="citerefentry"><span class="refentrytitle">flatpak-run</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-add"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-add — Add a remote repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p>Add from a .flatpakrepo file:</p><div class="cmdsynopsis"><p><code class="command">flatpak remote-add</code> [OPTION...] [--from] NAME LOCATION </p></div><p>Manually specify repo uri and options:</p><div class="cmdsynopsis"><p><code class="command">flatpak remote-add</code> [OPTION...] NAME LOCATION </p></div></div><div class="refsect1"><a id="idm140021656678352"></a><h2>Description</h2><p>
+ Adds a remote repository to the flatpak repository
+ configuration. [NAME] is the name for the new
+ remote, and [LOCATION] is a url or pathname. The
+ [LOCATION] is either a flatpak repository, or a
+ .flatpakrepo file which describes a repository. In the
+ former case you may also have to specify extra options,
+ such as the gpg key for the repo.
+ </p><p>
+ Unless overridden with the --user or --installation options, this command
+ changes the default system-wide installation.
+ </p></div><div class="refsect1"><a id="idm140021656673632"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">--from</code></span></dt><dd><p>
+ Assume the URI is a .flatpakrepo file rather than the repository itself. This is enabled
+ by default if the extension is .flatpakrepo, so generally you don't need this option.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Modify the per-user configuration.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
- Modify the system-wide configuration.
+ Modify the default system-wide configuration.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ Modify a system-wide installation specified by NAME
+ among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
+ Using --installation=default is equivalent to using
+ --system .
</p></dd><dt><span class="term"><code class="option">--no-gpg-verify</code></span></dt><dd><p>
Disable GPG verification for the added remote.
</p></dd><dt><span class="term"><code class="option">--prio=PRIO</code></span></dt><dd><p>
@@ -655,37 +1389,197 @@ permissions:
</p></dd><dt><span class="term"><code class="option">--title=TITLE</code></span></dt><dd><p>
A title for the remote, e.g. for display in a UI.
</p></dd><dt><span class="term"><code class="option">--default-branch=BRANCH</code></span></dt><dd><p>
- A default branch to for the remote, mainly for use in a UI.
+ A default branch for the remote, mainly for use in a UI.
</p></dd><dt><span class="term"><code class="option">--gpg-import=FILE</code></span></dt><dd><p>
Import gpg keys from the specified keyring file as
trusted for the new remote. If the file is - the
keyring is read from standard input.
+ </p></dd><dt><span class="term"><code class="option">--oci</code></span></dt><dd><p>
+ This is a OCI format registry rather than a regular
+ flatpak repository.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148823811776"></a><h2>Examples</h2><p>
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021657259264"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak remote-add gnome https://sdk.gnome.org/gnome.flatpakrepo</strong></span>
+ </p><p>
<span class="command"><strong>$ flatpak --user remote-add --no-gpg-verify test-repo https://people.gnome.org/~alexl/gnome-sdk/repo/</strong></span>
- </p></div><div class="refsect1"><a id="idm45148823809632"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-modify-remote</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-delete-remote</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-list-remotes</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-flatpakrepo</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-modify"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-modify — Modify a remote repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remote-modify</code> [OPTION...] NAME </p></div></div><div class="refsect1"><a id="idm45148827324096"></a><h2>Description</h2><p>
+ </p></div><div class="refsect1"><a id="idm140021656272320"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remote-modify"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-modify</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remote-delete"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-delete</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remotes"><span class="citerefentry"><span class="refentrytitle">flatpak-remotes</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-flatpakrepo"><span class="citerefentry"><span class="refentrytitle">flatpak-flatpakrepo</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-delete"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-delete — Delete a remote repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remote-delete</code> [OPTION...] NAME </p></div></div><div class="refsect1"><a id="idm140021656260544"></a><h2>Description</h2><p>
+ Removes a remote repository from the flatpak repository configuration.
+ NAME is the name of an existing remote.
+ </p><p>
+ Unless overridden with the --system, --user, or --installation options,
+ this command uses either the default system-wide installation or the
+ per-user one, depending on which has the specified
+ REMOTE .
+ </p></div><div class="refsect1"><a id="idm140021658586656"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
+ Modify the per-user configuration.
+ </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
+ Modify the default system-wide configuration.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ Modify a system-wide installation specified by NAME
+ among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
+ Using --installation=default is equivalent to using
+ --system .
+ </p></dd><dt><span class="term"><code class="option">--force</code></span></dt><dd><p>
+ Remove remote even if its in use by installed apps or runtimes.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
+ Print OSTree debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
+ Print version information and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021661699968"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak --user remote-delete dried-raisins</strong></span>
+ </p></div><div class="refsect1"><a id="idm140021661697936"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remote-add"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-add</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remote-modify"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-modify</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remotes"><span class="citerefentry"><span class="refentrytitle">flatpak-remotes</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-info"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-info — Show information about an application or runtime in a remote</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remote-info</code> [OPTION...] REMOTE REF </p></div></div><div class="refsect1"><a id="idm140021659785040"></a><h2>Description</h2><p>
+ Shows information about the runtime or application REF from the
+ remote repository with the name REMOTE .
+ You can find all configured remote repositories with flatpak remotes.
+ </p><p>
+ By default, the output is formatted in a friendly format.
+ If you specify one of the options --show-ref, --show-commit,
+ --show-parent, or --show-metadata, the output is instead formatted
+ in a machine-readable format.
+ </p><p>
+ Unless overridden with the --system, --user, or --installation options,
+ this command uses either the default system-wide installation or the
+ per-user one, depending on which has the specified
+ REMOTE .
+ </p></div><div class="refsect1"><a id="idm140021656459408"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
+ Use the per-user configuration.
+ </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
+ Use the default system-wide configuration.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ Use a system-wide installation specified by NAME
+ among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
+ Using --installation=default is equivalent to using
+ --system .
+ </p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
+ Assume that REF is a runtime if not explicitly specified.
+ </p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
+ Assume that REF is an app if not explicitly specified.
+ </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
+ The default architecture to look for, if not given explicitly in the REF .
+ </p></dd><dt><span class="term"><code class="option">--commit=COMMIT</code></span></dt><dd><p>
+ Show information about the specific commit, rather than the latest version.
+ </p></dd><dt><span class="term"><code class="option">--log</code></span></dt><dd><p>
+ Display a log of previous versions.
+ </p></dd><dt><span class="term"><code class="option">-r</code>, </span><span class="term"><code class="option">--show-ref</code></span></dt><dd><p>
+ Show the matched ref.
+ </p></dd><dt><span class="term"><code class="option">-c</code>, </span><span class="term"><code class="option">--show-commit</code></span></dt><dd><p>
+ Show the commit id.
+ </p></dd><dt><span class="term"><code class="option">-p</code>, </span><span class="term"><code class="option">--show-parent</code></span></dt><dd><p>
+ Show the parent commit id.
+ </p></dd><dt><span class="term"><code class="option">-m</code>, </span><span class="term"><code class="option">--show-metadata</code></span></dt><dd><p>
+ Show the metadata.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
+ Print OSTree debug information during command processing.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021657171776"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak --user remote-info flathub org.gnome.gedit</strong></span>
+ </p><pre class="programlisting">
+Ref: app/org.gnome.gedit/x86_64/stable
+ID: org.gnome.gedit
+Arch: x86_64
+Branch: stable
+Date: 2017-07-31 16:05:22 +0000
+Subject: Build org.gnome.gedit at 3ec291fc1ce4d78220527fa79576f4cc1481ebe5
+Commit: 3de7e9dde3bb8382aad9dfbbff20eccd9bf2100bc1887a3619ec0372e8066bf7
+Parent: -
+Download size: 3,4 MB
+Installed size: 11,1 MB
+Runtime: org.gnome.Platform/x86_64/3.24
+</pre></div><div class="refsect1"><a id="idm140021657169056"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remotes"><span class="citerefentry"><span class="refentrytitle">flatpak-remotes</span>(1)</span></a>
+ <a class="citerefentry" href="#flatpak-remote-ls"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-ls</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-ls"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-ls — Show available runtimes and applications</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remote-ls</code> [OPTION...] [REMOTE]</p></div></div><div class="refsect1"><a id="idm140021657479328"></a><h2>Description</h2><p>
+ Shows runtimes and applications that are available in the
+ remote repository with the name REMOTE ,
+ or all remotes if one isn't specified. You can find all configured
+ remote repositories with <a class="citerefentry" href="#flatpak-remotes"><span class="citerefentry"><span class="refentrytitle">flatpak-remotes</span>(1)</span></a>.
+ </p><p>
+ Unless overridden with the --system, --user, or --installation options,
+ this command uses either the default system-wide installation or the
+ per-user one, depending on which has the specified
+ REMOTE .
+ </p></div><div class="refsect1"><a id="idm140021661425136"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
+ </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
+ Use the per-user configuration.
+ </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
+ Use the default system-wide configuration.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ Use a system-wide installation specified by NAME
+ among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
+ Using --installation=default is equivalent to using
+ --system .
+ </p></dd><dt><span class="term"><code class="option">-d</code>, </span><span class="term"><code class="option">--show-details</code></span></dt><dd><p>
+ Show arches, branches and commit ids, in addition to the names.
+ </p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
+ Show only runtimes, omit applications.
+ </p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
+ Show only applications, omit runtimes.
+ </p></dd><dt><span class="term"><code class="option">--all</code>, </span><span class="term"><code class="option">-a</code></span></dt><dd><p> Show everything. By default locale and
+ debug extensions as well as secondary arches when the primary
+ arch in available are hidden.
+ </p></dd><dt><span class="term"><code class="option">--updates</code></span></dt><dd><p>
+ Show only those which have updates available.
+ </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
+ Show only those matching the specied architecture. By default, only
+ supported architectures are shown. Use --arch=* to show all archtectures.
+ </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
+ Print debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
+ Print OSTree debug information during command processing.
+ </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
+ Print version information and exit.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021656340544"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak --user remote-ls --app testrepo</strong></span>
+ </p><pre class="programlisting">
+org.gnome.Builder
+org.freedesktop.glxgears
+</pre></div><div class="refsect1"><a id="idm140021656337936"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remotes"><span class="citerefentry"><span class="refentrytitle">flatpak-remotes</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-modify"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-modify — Modify a remote repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remote-modify</code> [OPTION...] NAME </p></div></div><div class="refsect1"><a id="idm140021656742960"></a><h2>Description</h2><p>
Modifies options for an existing remote repository in the flatpak repository configuration.
NAME is the name for the remote.
</p><p>
- Unless overridden with the --user option, this command changes
- the system-wide configuration.
- </p></div><div class="refsect1"><a id="idm45148828541840"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Unless overridden with the --system, --user, or --installation options,
+ this command uses either the default system-wide installation or the
+ per-user one, depending on which has the specified
+ REMOTE .
+ </p></div><div class="refsect1"><a id="idm140021656739008"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Modify the per-user configuration.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
- Modify the system-wide configuration.
+ Modify the default system-wide configuration.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ Modify a system-wide installation specified by NAME
+ among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
+ Using --installation=default is equivalent to using
+ --system .
</p></dd><dt><span class="term"><code class="option">--no-gpg-verify</code></span></dt><dd><p>
Disable GPG verification for the added remote.
</p></dd><dt><span class="term"><code class="option">--gpg-verify</code></span></dt><dd><p>
@@ -715,6 +1609,8 @@ permissions:
A title for the remote, e.g. for display in a UI.
</p></dd><dt><span class="term"><code class="option">--default-branch=BRANCH</code></span></dt><dd><p>
A default branch to for the remote, mainly for use in a UI.
+ </p></dd><dt><span class="term"><code class="option">--url=URL</code></span></dt><dd><p>
+ Set a new URL.
</p></dd><dt><span class="term"><code class="option">--update-metadata</code></span></dt><dd><p>
A default branch to for the remote, mainly for use in a UI.
</p><p>
@@ -730,54 +1626,32 @@ permissions:
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148826810016"></a><h2>Examples</h2><p>
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021656955360"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak --user remote-modify --no-gpg-verify test-repo</strong></span>
- </p></div><div class="refsect1"><a id="idm45148824141408"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-remote-add</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-remote-delete</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-remote-list</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-delete"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-delete — Delete a remote repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remote-delete</code> [OPTION...] NAME </p></div></div><div class="refsect1"><a id="idm45148827265328"></a><h2>Description</h2><p>
- Removes a remote repository from the flatpak repository configuration.
- NAME is the name of an existing remote.
- </p><p>
- Unless overridden with the --user option, this command changes
- the system-wide configuration.
- </p></div><div class="refsect1"><a id="idm45148829064624"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
- Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
- Modify the per-user configuration.
- </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
- Modify the system-wide configuration.
- </p></dd><dt><span class="term"><code class="option">--force</code></span></dt><dd><p>
- Remove remote even if its in use by installed apps or runtimes.
- </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
- Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
- Print OSTree debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
- Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148828780416"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak --user remote-delete dried-raisins</strong></span>
- </p></div><div class="refsect1"><a id="idm45148828778384"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-add-remote</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-modify-remote</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-list-remotes</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-list"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-list — List remote repositories</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remote-list</code> [OPTION...]</p></div></div><div class="refsect1"><a id="idm45148825477232"></a><h2>Description</h2><p>
+ </p></div><div class="refsect1"><a id="idm140021656953328"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remote-add"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-add</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remote-delete"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-delete</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remotes"><span class="citerefentry"><span class="refentrytitle">flatpak-remotes</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remotes"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remotes — List remote repositories</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remotes</code> [OPTION...]</p></div></div><div class="refsect1"><a id="idm140021659797616"></a><h2>Description</h2><p>
Lists the known remote repositories, in priority order.
</p><p>
By default, both per-user and system-wide installations
- are shown. Use the --user or --system options to change
- this.
- </p></div><div class="refsect1"><a id="idm45148825332240"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ are shown. Use the --user, --system or --installation
+ options to change this.
+ </p></div><div class="refsect1"><a id="idm140021657001488"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Show the per-user configuration.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
- Show the system-wide configuration.
- </p></dd><dt><span class="term"><code class="option">--show-details</code></span></dt><dd><p>
- Show more information each repository in addition to the name.
+ Show the default system-wide configuration.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ Show a system-wide installation by NAME among
+ those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
+ Using --installation=default is equivalent to using
+ --system .
+ </p></dd><dt><span class="term"><code class="option">-d</code>, </span><span class="term"><code class="option">--show-details</code></span></dt><dd><p>
+ Show more information for each repository in addition to the name.
</p></dd><dt><span class="term"><code class="option">--show-disabled</code></span></dt><dd><p>
Show disabled repos.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
@@ -786,130 +1660,71 @@ permissions:
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148827869696"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak remote-list --user --show-details</strong></span>
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021657468032"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak remotes --user --show-details</strong></span>
</p><pre class="programlisting">
testrepo Test Repository http://209.132.179.91/repo/ no-gpg-verify
-</pre></div><div class="refsect1"><a id="idm45148825008864"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-add-remote</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-delete-remote</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-ls"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-ls — Show available runtimes and applications</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remote-ls</code> [OPTION...] REMOTE </p></div></div><div class="refsect1"><a id="idm45148827235904"></a><h2>Description</h2><p>
- Shows runtimes and applications that are available in the
- remote repository with the name REMOTE .
- You can find all configured remote repositories with flatpak remote-list.
- </p><p>
- Unless overridden with the --user option, this command uses
- the system-wide configuration.
- </p></div><div class="refsect1"><a id="idm45148825897840"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+</pre></div><div class="refsect1"><a id="idm140021657554096"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remote-add"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-add</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remote-delete"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-delete</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-repo"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-repo — Show information about a local repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak repo</code> [OPTION...] LOCATION </p></div></div><div class="refsect1"><a id="idm140021657560848"></a><h2>Description</h2><p>
+ Show information about a local repository.
+ </p></div><div class="refsect1"><a id="idm140021657559536"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
- Use the per-user configuration.
- </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
- Use the system-wide configuration.
- </p></dd><dt><span class="term"><code class="option">-d</code>, </span><span class="term"><code class="option">--show-details</code></span></dt><dd><p>
- Show arches, branches and commit ids, in addition to the names.
- </p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
- Show only runtimes, omit applications.
- </p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
- Show only applications, omit runtimes.
- </p></dd><dt><span class="term"><code class="option">--updates</code></span></dt><dd><p>
- Show only those which have updates available.
- </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
- Show only those matching the specied architecture. By default, only
- supported architectures are shown. Use --arch=* to show all archtectures.
- </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
- Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
- Print OSTree debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
- Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148828836160"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak --user remote-ls --only-apps testrepo</strong></span>
- </p><pre class="programlisting">
-org.gnome.Builder
-org.freedesktop.glxgears
-</pre></div><div class="refsect1"><a id="idm45148828833440"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-remote-list</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-init"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-init — Initialize a build directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-init</code> [OPTION...] DIRECTORY APPNAME SDK RUNTIME [BRANCH]</p></div></div><div class="refsect1"><a id="idm45148825874992"></a><h2>Description</h2><p>
- Initializes a directory for building an application.
- DIRECTORY is the name of the directory.
- APPNAME is the application id of the app
- that will be built.
- SDK and RUNTIME
- specify the sdk and runtime that the application should be built
- against and run in.
+ </p></dd><dt><span class="term"><code class="option">--info</code></span></dt><dd><p>
+ Print general information about a local repository.
+ </p></dd><dt><span class="term"><code class="option">--branches</code></span></dt><dd><p>
+ List the branches in a local repository.
+ </p></dd><dt><span class="term"><code class="option">--metadata=BRANCH</code></span></dt><dd><p>
+ Print metadata for a branch in the repository.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021662217440"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak repo --info ~/my-repo</strong></span>
+ </p></div><div class="refsect1"><a id="idm140021662215408"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-info"><span class="citerefentry"><span class="refentrytitle">flatpak-info</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-run"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-run — Run an application or open a shell in a runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak run</code> [OPTION...] REF [ARG...]</p></div></div><div class="refsect1"><a id="idm140021657329344"></a><h2>Description</h2><p>
+ If REF names an installed application,
+ flatpak runs the application in a sandboxed environment. Extra
+ arguments are passed on to the application.
</p><p>
- The result of this command is that a <code class="filename">metadata</code>
- file is created inside the given directory. Additionally, empty
- <code class="filename">files</code> and <code class="filename">var</code> subdirectories
- are created.
+ If REF names a runtime, a shell is opened in the
+ runtime. This is useful for development and testing.
</p><p>
- It is an error to run build-init on a directory that has already
- been initialized as a build directory.
- </p></div><div class="refsect1"><a id="idm45148828505024"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
- Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
- The architecture to use.
- </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--var=RUNTIME</code></span></dt><dd><p>
- Initialize var from the named runtime.
- </p></dd><dt><span class="term"><code class="option">-w</code>, </span><span class="term"><code class="option">--writable-sdk</code></span></dt><dd><p>
- Initialize /usr with a copy of the sdk, which is writable during flatpak build. This can be used
- if you need to install build tools in /usr during the build. This is stored in the
- <code class="filename">usr</code> subdirectory of the app dir, but will not be part of the final
- app.
- </p></dd><dt><span class="term"><code class="option">--tag=TAG</code></span></dt><dd><p>
- Add a tag to the metadata file.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--sdk-extension=EXTENSION</code></span></dt><dd><p>
- When using --writable-sdk, in addition to the sdk, also install the specified extension.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--sdk-dir</code></span></dt><dd><p>
- Specify a custom subdirectory to use instead of <code class="filename">usr</code> for --writable-sdk.
- </p></dd><dt><span class="term"><code class="option">--update</code></span></dt><dd><p>
- Re-initialize the sdk and var, don't fail if already initialized.
- </p></dd><dt><span class="term"><code class="option">--base=APP</code></span></dt><dd><p>
- Initialize the application with files from another specified application.
- </p></dd><dt><span class="term"><code class="option">--base-version=VERSION</code></span></dt><dd><p>
- Specify the version to use for --base. If not specified, will default to
- "master".
- </p></dd><dt><span class="term"><code class="option">--base-extension=EXTENSION</code></span></dt><dd><p>
- When using --base, also install the specified extension from the app.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
- Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
- Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148824934096"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak build-init /build/my-app org.gnome.Sdk org.gnome.Platform 3.16</strong></span>
- </p></div><div class="refsect1"><a id="idm45148828949136"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build — Build in a directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build</code> [OPTION...] DIRECTORY [COMMAND [ARG...]]</p></div></div><div class="refsect1"><a id="idm45148825649040"></a><h2>Description</h2><p>
- Runs a build command in a directory. DIRECTORY
- must have been initialized with <span class="command"><strong>flatpak build-init</strong></span>.
+ flatpak creates a sandboxed environment for the application to run in
+ by mounting the right runtime at <code class="filename">/usr</code> and a writable
+ directory at <code class="filename">/var</code>, whose content is preserved between
+ application runs. The application itself is mounted at <code class="filename">/app</code>.
</p><p>
- The sdk that is specified in the <code class="filename">metadata</code> file
- in the directory is mounted at <code class="filename">/usr</code> and the
- <code class="filename">files</code> and <code class="filename">var</code> subdirectories
- are mounted at <code class="filename">/app</code> and <code class="filename">/var</code>,
- respectively. They are writable, and their contents are preserved between
- build commands, to allow accumulating build artifacts there.
- </p></div><div class="refsect1"><a id="idm45148824098880"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ The details of the sandboxed environment are controlled by the application
+ metadata and various options like --share and --socket that are passed to the run
+ command: Access is allowed if it was requested either in the application
+ metadata file or with an option and the user hasn't overridden it.
+ </p><p>
+ The remaining arguments are passed to the command that gets run in the sandboxed
+ environment. See the <code class="option">--file-forwarding</code> for handling of file arguments.
+ </p></div><div class="refsect1"><a id="idm140021657221120"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
- </p></dd><dt><span class="term"><code class="option">-r</code>, </span><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
- Use the non-devel runtime that is specified in the application metadata instead of the devel runtime.
- </p></dd><dt><span class="term"><code class="option">--bind-mount=DEST=SOURCE</code></span></dt><dd><p>
- Add a custom bind mount in the build namespace. Can be specified multiple times.
- </p></dd><dt><span class="term"><code class="option">--build-dir=PATH</code></span></dt><dd><p>
- Start the build in this directory (default is in the current directory).
+ </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
+ The architecture to install for.
+ </p></dd><dt><span class="term"><code class="option">--command=COMMAND</code></span></dt><dd><p>
+ The command to run instead of the one listed in the application metadata.
+ </p></dd><dt><span class="term"><code class="option">--branch=BRANCH</code></span></dt><dd><p>
+ The branch to use.
+ </p></dd><dt><span class="term"><code class="option">-d</code>, </span><span class="term"><code class="option">--devel</code></span></dt><dd><p>
+ Use the devel runtime that is specified in the application metadata instead of the regular runtime, and use a seccomp profile that is less likely to break development tools.
+ </p></dd><dt><span class="term"><code class="option">--runtime=RUNTIME</code></span></dt><dd><p>
+ Use this runtime instead of the one that is specified in the application metadata.
+ This is a full tuple, like for example org.freedesktop.Sdk/x86_64/1.2 , but
+ partial tuples are allowed. Any empty or missing parts are filled in with the corresponding
+ values specified by the app.
+ </p></dd><dt><span class="term"><code class="option">--runtime-version=VERSION</code></span></dt><dd><p>
+ Use this version of the runtime instead of the one that is specified in the application metadata.
+ This overrides any version specified with the --runtime option.
</p></dd><dt><span class="term"><code class="option">--share=SUBSYSTEM</code></span></dt><dd><p>
Share a subsystem with the host session. This overrides
the Context section from the application metadata.
@@ -921,14 +1736,14 @@ org.freedesktop.glxgears
SUBSYSTEM must be one of: network, ipc.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--socket=SOCKET</code></span></dt><dd><p>
- Expose a well-known socket to the application. This overrides to
+ Expose a well known socket to the application. This overrides to
the Context section from the application metadata.
- SOCKET must be one of: x11, wayland, pulseaudio, system-bus, session-bus.
+ SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nosocket=SOCKET</code></span></dt><dd><p>
- Don't expose a well-known socket to the application. This overrides to
+ Don't expose a well known socket to the application. This overrides to
the Context section from the application metadata.
- SOCKET must be one of: x11, wayland, pulseaudio, system-bus, session-bus.
+ SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--device=DEVICE</code></span></dt><dd><p>
Expose a device to the application. This overrides to
@@ -940,13 +1755,26 @@ org.freedesktop.glxgears
the Context section from the application metadata.
DEVICE must be one of: dri, kvm, all.
This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--filesystem=FILESYSTEM[:ro]</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="option">--allow=FEATURE</code></span></dt><dd><p>
+ Allow access to a specific feature. This overrides to
+ the Context section from the application metadata.
+ FEATURE must be one of: devel, multiarch.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--disallow=FEATURE</code></span></dt><dd><p>
+ Disallow access to a specific feature. This overrides to
+ the Context section from the application metadata.
+ FEATURE must be one of: devel, multiarch.
+ This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--filesystem=FS</code></span></dt><dd><p>
Allow the application access to a subset of the filesystem.
This overrides to the Context section from the application metadata.
- FILESYSTEM can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
+ FS can be one of: home, host, xdg-desktop, xdg-documents, xdg-download,
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
- an absolute path, or a homedir-relative path like ~/dir.
+ xdg-run, xdg-config, xdg-cache, xdg-data,
+ an absolute path, or a homedir-relative path like ~/dir or paths
+ relative to the xdg dirs, like xdg-download/subdir.
The optional :ro suffix indicates that the location will be read-only.
+ The optional :create suffix indicates that the location will be read-write and created if it doesn't exist.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nofilesystem=FILESYSTEM</code></span></dt><dd><p>
Remove access to the specified subset of the filesystem from
@@ -956,634 +1784,303 @@ org.freedesktop.glxgears
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
an absolute path, or a homedir-relative path like ~/dir.
This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--env=VAR=VALUE</code></span></dt><dd><p>
- Set an environment variable in the application.
- This overrides to the Context section from the application metadata.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--own-name=NAME</code></span></dt><dd><p>
- Allow the application to own the well-known name NAME on the session bus.
- This overrides to the Context section from the application metadata.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--talk-name=NAME</code></span></dt><dd><p>
- Allow the application to talk to the well-known name NAME on the session bus.
- This overrides to the Context section from the application metadata.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--system-own-name=NAME</code></span></dt><dd><p>
- Allow the application to own the well-known name NAME on the system bus.
- This overrides to the Context section from the application metadata.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--system-talk-name=NAME</code></span></dt><dd><p>
- Allow the application to talk to the well-known name NAME on the system bus.
- This overrides to the Context section from the application metadata.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--persist=FILENAME</code></span></dt><dd><p>
- If the application doesn't have access to the real homedir, make the (homedir-relative) path
- FILENAME a bind mount to the corresponding path in the per-application directory,
- allowing that location to be used for persistent data.
- This overrides to the Context section from the application metadata.
- This option can be used multiple times.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148828614560"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak build /build/my-app rpmbuild my-app.src.rpm</strong></span>
- </p></div><div class="refsect1"><a id="idm45148828612528"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-finish"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-finish — Finalize a build directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-finish</code> [OPTION...] DIRECTORY </p></div></div><div class="refsect1"><a id="idm45148827764848"></a><h2>Description</h2><p>
- Finalizes a build directory, to prepare it for exporting.
- DIRECTORY is the name of the directory.
- </p><p>
- The result of this command is that desktop files, icons and
- D-Bus service files from the <code class="filename">files</code> subdirectory
- are copied to a new <code class="filename">export</code> subdirectory. In the
- <code class="filename">metadata</code> file, the command key is set in the
- [Application] group, and the supported keys in the [Environment]
- group are set according to the options.
- </p><p>
- You should review the exported files and the application metadata
- before creating and distributing an application bundle.
- </p><p>
- It is an error to run build-finish on a directory that has not
- been initialized as a build directory, or has already been finalized.
- </p></div><div class="refsect1"><a id="idm45148825410080"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
- Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">--command=COMMAND</code></span></dt><dd><p>
- The command to use. If this option is not specified,
- the first executable found in <code class="filename">files/bin</code>
- is used.
- </p></dd><dt><span class="term"><code class="option">--share=SUBSYSTEM</code></span></dt><dd><p>
- Share a subsystem with the host session. This updates
- the [Context] group in the metadata.
- SUBSYSTEM must be one of: network, ipc.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--unshare=SUBSYSTEM</code></span></dt><dd><p>
- Don't share a subsystem with the host session. This updates
- the [Context] group in the metadata.
- SUBSYSTEM must be one of: network, ipc.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--socket=SOCKET</code></span></dt><dd><p>
- Expose a well known socket to the application. This updates
- the [Context] group in the metadata.
- SOCKET must be one of: x11, wayland, pulseaudio, system-bus, session-bus.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--nosocket=SOCKET</code></span></dt><dd><p>
- Don't expose a well known socket to the application. This updates
- the [Context] group in the metadata.
- SOCKET must be one of: x11, wayland, pulseaudio, system-bus, session-bus.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--device=DEVICE</code></span></dt><dd><p>
- Expose a device to the application. This updates
- the [Context] group in the metadata.
- DEVICE must be one of: dri, kvm, all.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--nodevice=DEVICE</code></span></dt><dd><p>
- Don't expose a device to the application. This updates
- the [Context] group in the metadata.
- DEVICE must be one of: dri, kvm, all.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--allow=FEATURE</code></span></dt><dd><p>
- Allow access to a specific feature. This updates
- the [Context] group in the metadata.
- FEATURE must be one of: devel, multiarch.
- This option can be used multiple times.
- </p><p>
- The <code class="code">devel</code> feature allows the application to
- access certain syscalls such as <code class="code">ptrace()</code>, and
- <code class="code">perf_event_open()</code>.
+ </p></dd><dt><span class="term"><code class="option">--add-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
+ Add generic policy option. For example, "--add-policy=subsystem.key=v1 --add-policy=subsystem.key=v2" would map to this metadata:
+</p><pre class="programlisting">
+[Policy subsystem]
+key=v1;v2;
+</pre><p>
</p><p>
- The <code class="code">multiarch</code> feature allows the application to
- execute programs compiled for an ABI other than the one supported
- natively by the system. For example, for the <code class="code">x86_64</code>
- architecture, 32-bit <code class="code">x86</code> binaries will be allowed as
- well.
- </p></dd><dt><span class="term"><code class="option">--disallow=FEATURE</code></span></dt><dd><p>
- Disallow access to a specific feature. This updates
- the [Context] group in the metadata.
- FEATURE must be one of: devel, multiarch.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--filesystem=FS</code></span></dt><dd><p>
- Allow the application access to a subset of the filesystem.
- This updates the [Context] group in the metadata.
- FS can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
- xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos, xdg-run,
- an absolute path, or a homedir-relative path like ~/dir or paths
- relative to the xdg dirs, like xdg-download/subdir.
This option can be used multiple times.
+ </p></dd><dt><span class="term"><code class="option">--remove-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
+ Remove generic policy option. This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--env=VAR=VALUE</code></span></dt><dd><p>
Set an environment variable in the application.
- This updates the [Environment] group in the metadata.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--own-name=NAME</code></span></dt><dd><p>
Allow the application to own the well known name NAME on the session bus.
If NAME ends with .*, it allows the application to own all matching names.
-
- This updates the [Session Bus Policy] group in the metadata.
+ This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--talk-name=NAME</code></span></dt><dd><p>
Allow the application to talk to the well known name NAME on the session bus.
If NAME ends with .*, it allows the application to talk to all matching names.
- This updates the [Session Bus Policy] group in the metadata.
+ This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--system-own-name=NAME</code></span></dt><dd><p>
Allow the application to own the well known name NAME on the system bus.
If NAME ends with .*, it allows the application to own all matching names.
- This updates the [System Bus Policy] group in the metadata.
+ This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--system-talk-name=NAME</code></span></dt><dd><p>
Allow the application to talk to the well known name NAME on the system bus.
If NAME ends with .*, it allows the application to talk to all matching names.
- This updates the [System Bus Policy] group in the metadata.
+ This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--persist=FILENAME</code></span></dt><dd><p>
If the application doesn't have access to the real homedir, make the (homedir-relative) path
FILENAME a bind mount to the corresponding path in the per-application directory,
allowing that location to be used for persistent data.
- This updates the [Context] group in the metadata.
+ This overrides to the Context section from the application metadata.
This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--extra-data=NAME:SHA256:DOWNLOAD-SIZE:INSTALL-SIZE:URL</code></span></dt><dd><p>
- Adds information about extra data uris to the app. These will be downloaded
- and verified by the client when the app is installed and placed in the
- /app/extra directory. You can also supply an /app/bin/apply_extra script
- that will be run after the files are downloaded.
- </p></dd><dt><span class="term"><code class="option">--no-exports</code></span></dt><dd><p>
- Don't look for exports in the build.
+ </p></dd><dt><span class="term"><code class="option">--log-session-bus</code></span></dt><dd><p>
+ Log session bus traffic. This can be useful to see what access you need to allow in
+ your D-Bus policy.
+ </p></dd><dt><span class="term"><code class="option">--log-system-bus</code></span></dt><dd><p>
+ Log system bus traffic. This can be useful to see what access you need to allow in
+ your D-Bus policy.
+ </p></dd><dt><span class="term"><code class="option">--file-forwarding</code></span></dt><dd><p>
+ If this option is specified, the remaining arguments are scanned, and all arguments
+ that are enclosed between a pair of '@@' arguments are interpreted as file paths,
+ exported in the document store, and passed to the command in the form of the
+ resulting document path. Arguments between '@@u' and '@@' are considered uris,
+ and any file: uris are exported. The exports are non-persistent and with read and write
+ permissions for the application.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021656220608"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak run org.gnome.GEdit</strong></span>
+ </p><p>
+ <span class="command"><strong>$ flatpak run --devel --command=bash org.gnome.Builder</strong></span>
+ </p><p>
+ <span class="command"><strong>$ flatpak run --command=bash org.gnome.Sdk</strong></span>
+ </p></div><div class="refsect1"><a id="idm140021656216256"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-override"><span class="citerefentry"><span class="refentrytitle">flatpak-override</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-enter"><span class="citerefentry"><span class="refentrytitle">flatpak-enter</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-search"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-search — Search for applications and runtimes</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak search</code> TEXT </p></div></div><div class="refsect1"><a id="idm140021658054304"></a><h2>Description</h2><p>
+ Searches for applications and runtimes matching
+ TEXT . Note that this uses appstream data
+ that can be updated with <a class="citerefentry" href="#flatpak-update"><span class="citerefentry"><span class="refentrytitle">flatpak-update</span>(1)</span></a>.
+ The appstream data is updated automatically only if it's at least a day old.
+ </p></div><div class="refsect1"><a id="idm140021658051424"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
+ Only search through remotes in the per-user installation.
+ </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
+ Only search through remotes in the default system-wide installation.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ Show a system-wide installation by NAME among
+ those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
+ Using --installation=default is equivalent to using
+ --system .
+ </p></dd><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
- Print OSTree debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
- Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148824436720"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak build-finish /build/my-app --socket=x11 --share=ipc</strong></span>
- </p><pre class="programlisting">
-Exporting share/applications/gnome-calculator.desktop
-Exporting share/dbus-1/services/org.gnome.Calculator.SearchProvider.service
-More than one executable
-Using gcalccmd as command
-Please review the exported files and the metadata
-</pre></div><div class="refsect1"><a id="idm45148824433744"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-export"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-export — Create a repository from a build directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-export</code> [OPTION...] LOCATION DIRECTORY [BRANCH]</p></div></div><div class="refsect1"><a id="idm45148829021424"></a><h2>Description</h2><p>
- Creates or updates a repository with an application build.
- LOCATION is the location of the
- repository. DIRECTORY must be a
- finalized build directory. If BRANCH
- is not specified, it is assumed to be "master".
+ </p></dd></dl></div></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-uninstall"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-uninstall — Uninstall an application or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak uninstall</code> [OPTION...] [REF...]</p></div></div><div class="refsect1"><a id="idm140021656697280"></a><h2>Description</h2><p>
+ Uninstalls an application or runtime. REF is a reference to the
+ application or runtime to uninstall.
</p><p>
- If LOCATION exists, it is assumed to
- be an OSTree repository, otherwise a new OSTree repository is
- created at this location. The repository can be inspected with
- the <span class="command"><strong>ostree</strong></span> tool.
+ Each REF arguments is a full or partial indentifier in the
+ flatpak ref format, which looks like "(app|runtime)/ID/ARCH/BRANCH". All elements
+ except ID are optional and can be left out, including the slashes,
+ so most of the time you need only specify ID. Any part left out will be matched
+ against what is installed, and if there are multiple matches an error message
+ will list the alternatives.
</p><p>
- The contents of DIRECTORY are committed
- on the branch with name <code class="literal">app/APPNAME/ARCH/BRANCH</code>,
- where ARCH is the architecture of the runtime that the application
- is using. A commit filter is used to enforce that only the contents
- of the <code class="filename">files/</code> and <code class="filename">export/</code>
- subdirectories and the <code class="filename">metadata</code> file are included
- in the commit, anything else is ignored.
+ By default this looks for both installed apps and runtime
+ with the given NAME , but you can
+ limit this by using the --app or --runtime option.
</p><p>
- The repo-update command should be used to update repository
- metadata whenever application builds are added to a repository.
- </p></div><div class="refsect1"><a id="idm45148828697104"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Normally, this command removes the ref for this application/runtime from the
+ local OSTree repository and purges and objects that are no longer
+ needed to free up disk space. If the same application is later
+ reinstalled, the objects will be pulled from the remote repository
+ again. The --keep-ref option can be used to prevent this.
+ </p><p>
+ If all branches of the application/runtime are removed, this command
+ also purges the data directory for the application.
+ </p><p>
+ Unless overridden with the --user or the --installation option, this command updates
+ the default system-wide installation.
+ </p></div><div class="refsect1"><a id="idm140021658797824"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">-s</code>, </span><span class="term"><code class="option">--subject=SUBJECT</code></span></dt><dd><p>
- One line subject for the commit message.
- </p></dd><dt><span class="term"><code class="option">-b</code>, </span><span class="term"><code class="option">--body=BODY</code></span></dt><dd><p>
- Full description for the commit message.
+ </p></dd><dt><span class="term"><code class="option">--keep-ref</code></span></dt><dd><p>
+ Keep the ref for the application and the objects belonging to it
+ in the local repository.
+ </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
+ Updates a per-user installation.
+ </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
+ Updates the default system-wide installation.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ Updates a system-wide installation specified by NAME
+ among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
+ Using --installation=default is equivalent to using
+ --system .
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
- Specify the architecture component of the branch to export. Only host compatible architectures can be specified.
- </p></dd><dt><span class="term"><code class="option">--exclude=PATTERN</code></span></dt><dd><p>
- Exclude files matching PATTERN from the commit.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--include=PATTERN</code></span></dt><dd><p>
- Don't exclude files matching PATTERN from the commit, even if they match the --export patterns.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--metadata=FILENAME</code></span></dt><dd><p>
- Use the specified filename as metadata in the exported app instead of
- the default file (called <code class="filename">metadata</code>). This is useful
- if you want to commit multiple things from a single build tree, typically
- used in combination with --files and --exclude.
- </p></dd><dt><span class="term"><code class="option">--files=SUBDIR</code></span></dt><dd><p>
- Use the files in the specified subdirectory as the file contents, rather
- than the regular <code class="filename">files</code> directory.
- </p></dd><dt><span class="term"><code class="option">--update-appstream</code></span></dt><dd><p>
- Run appstream-builder and to update the appstream branch after build.
- </p></dd><dt><span class="term"><code class="option">--no-update-summary</code></span></dt><dd><p>
- Don't update the summary file after the new commit is added. This means
- the repository will not be useful for serving over http until build-repo-update
- has been run. This is useful is you want to do multiple repo operations before
- finally updating the summary.
- </p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
- Sign the commit with this GPG key.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
- GPG Homedir to use when looking for keyrings
+ The architecture to uninstall, instead of the architecture of
+ the host system.
+ </p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
+ Only look for an app with the given name.
</p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
- Export a runtime instead for an app (this uses the usr subdir as files).
+ Only look for a runtime with the given name.
+ </p></dd><dt><span class="term"><code class="option">--no-related</code></span></dt><dd><p>
+ Don't uninstall related extensions, such as the locale data.
+ </p></dd><dt><span class="term"><code class="option">--force-remove</code></span></dt><dd><p>
+ Remove files even if they're in use by a running application.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148828511424"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak build-export ~/repos/gnome-calculator/ ~/build/gnome-calculator/ org.gnome.Calculator</strong></span>
- </p><pre class="programlisting">
-Commit: 9d0044ea480297114d03aec85c3d7ae3779438f9d2cb69d717fb54237acacb8c
-Metadata Total: 605
-Metadata Written: 5
-Content Total: 1174
-Content Written: 1
-Content Bytes Written: 305
-</pre></div><div class="refsect1"><a id="idm45148824211072"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-sign</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-repo-update</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-bundle"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-bundle — Create a single-file bundle from a local repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-bundle</code> [OPTION...] LOCATION FILENAME NAME [BRANCH]</p></div></div><div class="refsect1"><a id="idm45148834670560"></a><h2>Description</h2><p>
- Creates a single-file named FILENAME
- for the application (or runtime) named NAME
- in the repository at LOCATION . If
- a BRANCH is specified, this branch of
- the application is used.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021657093344"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak --user uninstall org.gnome.GEdit</strong></span>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-update"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-update — Update an application or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak update</code> [OPTION...] [REF...]</p></div><div class="cmdsynopsis"><p><code class="command">flatpak update</code> [OPTION...] --appstream [REMOTE]</p></div></div><div class="refsect1"><a id="idm140021657600656"></a><h2>Description</h2><p>
+ Updates applications and runtimes. REF is a reference to the
+ application or runtime to update. If no REF is given, everything
+ is updated, as well as appstream info for all remotes.
</p><p>
- The format of the bundle file is that of an ostree static delta
- (against an empty base) with some flatpak specific metadata for
- the application icons and appdata.
- </p></div><div class="refsect1"><a id="idm45148825230176"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
- Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
- Export a runtime instead of an application.
- </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
- The arch to create a bundle for.
- </p></dd><dt><span class="term"><code class="option">--repo-url=URL</code></span></dt><dd><p>
- The URL for the repository from which the
- application can be updated. Installing the
- bundle will automatically configure a remote
- for this URL.
- </p></dd><dt><span class="term"><code class="option">--gpg-keys=FILE</code></span></dt><dd><p>
- Add the GPG key from FILE (use - for stdin).
- </p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
- GPG Homedir to use when looking for keyrings.
- </p></dd><dt><span class="term"><code class="option">--oci</code></span></dt><dd><p>
- Export to an OCI image instead of a Flatpak bundle.
- </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
- Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
- Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148825509488"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-import-bundle</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-repo-update</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-import-bundle"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-import-bundle — Import a file bundle into a local repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-import-bundle</code> [OPTION...] LOCATION FILENAME </p></div></div><div class="refsect1"><a id="idm45148834743376"></a><h2>Description</h2><p>
- Imports a bundle from a file named FILENAME
- into the repository at LOCATION .
+ Each REF arguments is a full or partial indentifier in the
+ flatpak ref format, which looks like "(app|runtime)/ID/ARCH/BRANCH". All elements
+ except ID are optional and can be left out, including the slashes,
+ so most of the time you need only specify ID. Any part left out will be matched
+ against what is installed, and if there are multiple matches an error message
+ will list the alternatives.
</p><p>
- The format of the bundle file is that generated by build-bundle.
- </p></div><div class="refsect1"><a id="idm45148827818624"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
- Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
- Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
- Print OSTree debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--ref=REF</code></span></dt><dd><p>
- Override the ref specified in the bundle.
- </p></dd><dt><span class="term"><code class="option">--oci</code></span></dt><dd><p>
- Import an OCI image instead of a Flatpak bundle.
- </p></dd><dt><span class="term"><code class="option">--update-appstream</code></span></dt><dd><p>
- Run appstream-builder and to update the appstream branch after build.
- </p></dd><dt><span class="term"><code class="option">--no-update-summary</code></span></dt><dd><p>
- Don't update the summary file after the new commit is added. This means
- the repository will not be useful for serving over http until build-repo-update
- has been run. This is useful is you want to do multiple repo operations before
- finally updating the summary.
- </p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
- Sign the commit with this GPG key.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
- GPG Homedir to use when looking for keyrings
- </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
- Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148823965952"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-bundle</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-repo-update</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-update-repo"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-update-repo — Create a repository from a build directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-update-repo</code> [OPTION...] LOCATION </p></div></div><div class="refsect1"><a id="idm45148827932992"></a><h2>Description</h2><p>
- Updates repository metadata for the repository at
- LOCATION . This command generates
- an OSTree summary file that lists the contents of the repository.
- The summary is used by flatpak repo-contents and other commands
- to display the contents of remote repositories.
+ By default this looks for both apps and runtimes with the given REF ,
+ but you can limit this by using the --app or --runtime option, or by supplying the initial
+ element in the REF.
</p><p>
- After this command, LOCATION can be
- used as the repository location for flatpak add-repo, either by
- exporting it over http, or directly with a file: url.
- </p></div><div class="refsect1"><a id="idm45148825604144"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
- Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">--title=TITLE</code></span></dt><dd><p>
- A title for the repository, e.g. for display in a UI.
- The title is stored in the repository summary.
- </p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
- Sign the commit with this GPG key.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
- GPG Homedir to use when looking for keyrings
- </p></dd><dt><span class="term"><code class="option">--generate-static-deltas</code></span></dt><dd><p>
- Generate static deltas for all references. This generates from-empty and
- delta static files that allow for faster download.
- </p></dd><dt><span class="term"><code class="option">--prune</code></span></dt><dd><p>
- Remove unreferences objects in repo.
- </p></dd><dt><span class="term"><code class="option">--prune-depth</code></span></dt><dd><p>
- Only keep at most this number of old versions for any particular ref. Default is -1 which means infinite.
- </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
- Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
- Print OSTree debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
- Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148828038640"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-repo-contents</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-export"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-sign — Sign an application or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-sign</code> [OPTION...] LOCATION ID [BRANCH]</p></div></div><div class="refsect1"><a id="idm45148826336688"></a><h2>Description</h2><p>
- Signs the commit for a specified application or runtime in
- a local repository. LOCATION is
- the location of the repository. ID is the name of the application, or
- runtime if --runtime is specified. If BRANCH is not specified, it is
- assumed to be "master".
+ Normally, this command updates the application to the tip
+ of its branch. But it is possible to check out another commit,
+ with the --commit option.
</p><p>
- Applications can also be signed during build-export, but
- it is sometimes useful to add additional signatures later.
- </p></div><div class="refsect1"><a id="idm45148824167984"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
+ Note that updating a runtime is different from installing
+ a different branch, and runtime updates are expected to keep
+ strict compatibility. If an application update does cause
+ a problem, it is possible to go back to the previous
+ version, with the --commit option.
+ </p><p>
+ Unless overridden with the --user, --system or --installation option, this command updates
+ any matching refs in the standard system-wide installation and the per-user one.
+ </p></div><div class="refsect1"><a id="idm140021656580288"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
- Sign the commit with this GPG key.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
- GPG Homedir to use when looking for keyrings
- </p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
- Sign a runtime instead of an app.
+ </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
+ Update a per-user installation.
+ </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
+ Update the default system-wide installation.
+ </p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
+ Updates a system-wide installation specified by NAME
+ among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
+ Using --installation=default is equivalent to using
+ --system .
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
- The architecture to use.
+ The architecture to update for.
+ </p></dd><dt><span class="term"><code class="option">--subpath=PATH</code></span></dt><dd><p>
+ Install only a subpath of the ref. This is mainly used to install a subset of locales.
+ This can be added multiple times to install multiple subpaths.
+ If this is not specified the subpaths specified at install time are reused.
+ </p></dd><dt><span class="term"><code class="option">--commit=COMMIT</code></span></dt><dd><p>
+ Update to this commit, instead of the tip of the branch.
+ </p></dd><dt><span class="term"><code class="option">--no-deploy</code></span></dt><dd><p>
+ Download the latest version, but don't deploy it.
+ </p></dd><dt><span class="term"><code class="option">--no-pull</code></span></dt><dd><p>
+ Don't download the latest version, deploy whatever is locally available.
+ </p></dd><dt><span class="term"><code class="option">--no-related</code></span></dt><dd><p>
+ Don't download related extensions, such as the locale data.
+ </p></dd><dt><span class="term"><code class="option">--no-deps</code></span></dt><dd><p>
+ Don't update or install runtime dependencies when installing.
+ </p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
+ Only look for an app with the given name.
+ </p></dd><dt><span class="term"><code class="option">--appstream</code></span></dt><dd><p>
+ Update appstream for REMOTE , or all remotes if no remote is specified.
+ </p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
+ Only look for a runtime with the given name.
+ </p></dd><dt><span class="term"><code class="option">-y</code>, </span><span class="term"><code class="option">--assumeyes</code></span></dt><dd><p>
+ Automatically answer yes to all questions (or pick the most prioritized answer). This is useful for automation.
+ </p></dd><dt><span class="term"><code class="option">--force-remove</code></span></dt><dd><p>
+ Remove old files even if they're in use by a running application.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148828943696"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak build-export ~/repos/gnome-calculator/ ~/build/gnome-calculator/ org.gnome.Calculator</strong></span>
- </p><pre class="programlisting">
-Commit: 9d0044ea480297114d03aec85c3d7ae3779438f9d2cb69d717fb54237acacb8c
-Metadata Total: 605
-Metadata Written: 5
-Content Total: 1174
-Content Written: 1
-Content Bytes Written: 305
-</pre></div><div class="refsect1"><a id="idm45148828940672"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span>,
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-builder"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-builder — Help build application dependencies</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak-builder</code> [OPTION...] DIRECTORY MANIFEST </p></div><div class="cmdsynopsis"><p><code class="command">flatpak-builder</code> --run [OPTION...] DIRECTORY MANIFEST COMMAND </p></div><div class="cmdsynopsis"><p><code class="command">flatpak-builder</code> --show-deps [OPTION...] MANIFEST </p></div></div><div class="refsect1"><a id="idm45148827276752"></a><h2>Description</h2><p>
- <span class="command"><strong>flatpak-builder</strong></span> is a wrapper around the <span class="command"><strong>flatpak build</strong></span> command
- that automates the building of applications and their dependencies. It is one option you can use
- to build applications.
- </p><p>
- The goal of <span class="command"><strong>flatpak-builder</strong></span> is to push as much knowledge about how to build modules to
- the individual upstream projects. It does this by assuming that the modules adhere to the Build API specified
- at https://github.com/cgwalters/build-api. This essentially means that it follows the <span class="command"><strong>./configure
- &amp;&amp; make &amp;&amp; make install</strong></span> scheme with an optional autogen script. If the upstream
- does not adhere to the API you can make it do so by adding patches and extra files.
- </p><p>
- An invocation of <span class="command"><strong>flatpak-builder</strong></span> proceeds in these stages, each being specified
- in detail in json format in MANIFEST :
- </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: bullet; "><li class="listitem" style="list-style-type: disc"><p>Download all sources</p></li><li class="listitem" style="list-style-type: disc"><p>Initialize the application directory with <span class="command"><strong>flatpak build-init</strong></span></p></li><li class="listitem" style="list-style-type: disc"><p>Build and install each module with <span class="command"><strong>flatpak build</strong></span></p></li><li class="listitem" style="list-style-type: disc"><p>Clean up the final build tree by removing unwanted files and e.g. stripping binaries</p></li><li class="listitem" style="list-style-type: disc"><p>Finish the application directory with <span class="command"><strong>flatpak build-finish</strong></span></p></li></ul></div><p>
-
- After this you will end up with a build of the application in DIRECTORY , which you can
- export to a repository with the <span class="command"><strong>flatpak build-export</strong></span> command. If you use the <code class="option">--repo</code>
- option, flatpack-builder will do the export for you at the end of the build process. When flatpak-builder does the
- export, it also stores the manifest that was used for the build in /app/manifest.json. The manifest is 'resolved',
- i.e. git branch names are replaced by the actual commit IDs that were used in the build.
- </p><p>
- At each of the above steps flatpak caches the result, and if you build the same file again, it will start
- of at the first step where something changes. For instance the first version controlled source that had
- new commits added, or the first module where some changes to the MANIFEST file caused
- the build environment to change. This makes flatpak-builder very efficient for incremental builds.
- </p></div><div class="refsect1"><a id="idm45148828752816"></a><h2>Manifest format</h2><div class="refsect2"><a id="idm45148828752080"></a><h3>Toplevel</h3><p>
- The top level of the json file describes global
- attributes of the application, and how it can be
- build, and the list of modules that need to be
- built.
- </p><p>
- These are the properties that are accepted:
- </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">id</code> or <code class="option">app-id</code> (string)</span></dt><dd><p>A string defining the application id.</p></dd><dt><span class="term"><code class="option">branch</code> (string)</span></dt><dd><p>The branch of the application, defaults to master.</p></dd><dt><span class="term"><code class="option">runtime</code> (string)</span></dt><dd><p>The name of the runtime that the application uses.</p></dd><dt><span class="term"><code class="option">runtime-version</code> (string)</span></dt><dd><p>The version of the runtime that the application uses, defaults to master.</p></dd><dt><span class="term"><code class="option">sdk</code> (string)</span></dt><dd><p>The name of the development runtime that the application builds with.</p></dd><dt><span class="term"><code class="option">var</code> (string)</span></dt><dd><p>Initialize the (otherwise empty) writable /var in the build with a copy of this runtime.</p></dd><dt><span class="term"><code class="option">metadata</code> (string)</span></dt><dd><p>Use this file as the base metadata file when finishing.</p></dd><dt><span class="term"><code class="option">command</code> (string)</span></dt><dd><p>The filename or path to the main binary of the application. Note that this is really just a single file, not a commandline. If you want to pass arguments, install a shell script wrapper and use that as the command.</p></dd><dt><span class="term"><code class="option">build-runtime</code> (boolean)</span></dt><dd><p>Build a new runtime instead of an application.</p></dd><dt><span class="term"><code class="option">separate-locales</code> (boolean)</span></dt><dd><p>Separate out locale files and translations to an extension runtime. Defaults to true.</p></dd><dt><span class="term"><code class="option">id-platform</code> (string)</span></dt><dd><p>When building a runtime sdk, also create a platform based on it with this id.</p></dd><dt><span class="term"><code class="option">metadata-platform</code> (string)</span></dt><dd><p>The metadata file to use for the platform we create.</p></dd><dt><span class="term"><code class="option">writable-sdk</code> (boolean)</span></dt><dd><p>If true, use a writable copy of the sdk for /usr.
- Defaults to true if --build-runtime is specified.</p></dd><dt><span class="term"><code class="option">appstream-compose</code> (boolean)</span></dt><dd><p>Run appstream-compose during cleanup phase. Defaults to true.</p></dd><dt><span class="term"><code class="option">sdk-extensions</code> (array of strings)</span></dt><dd><p>Install these extra sdk extensions in /usr.</p></dd><dt><span class="term"><code class="option">platform-extensions</code> (array of strings)</span></dt><dd><p>Install these extra sdk extensions when creating the platform.</p></dd><dt><span class="term"><code class="option">base</code> (string)</span></dt><dd><p>Start with the files from the specified application. This can be
- used to create applications that extend another application.</p></dd><dt><span class="term"><code class="option">base-version</code> (string)</span></dt><dd><p>Use this specific version of the application specified in base.
- If unspecified, this uses the value specified in branch</p></dd><dt><span class="term"><code class="option">base-extensions</code> (array of strings)</span></dt><dd><p>Install these extra extensions from the base application when initializing
- the application directory.</p></dd><dt><span class="term"><code class="option">tags</code> (array of strings)</span></dt><dd><p>Add these tags to the metadata file.</p></dd><dt><span class="term"><code class="option">build-options</code> (object)</span></dt><dd><p>Object specifying the build environment. See below for details.</p></dd><dt><span class="term"><code class="option">modules</code> (array of objects or string)</span></dt><dd><p>An array of objects specifying the modules to be built in order.
- String members in the array are interpreted as the name of a separate json file that contains a module.
- See below for details.</p></dd><dt><span class="term"><code class="option">cleanup</code> (array of strings)</span></dt><dd><p>An array of file patterns that should be removed at the end.
- Patterns starting with / are taken to be full pathnames (without the /app prefix), otherwise they just match
- the basename.</p></dd><dt><span class="term"><code class="option">cleanup-commands</code> (array of strings)</span></dt><dd><p>An array of commandlines that are run during the cleanup phase.</p></dd><dt><span class="term"><code class="option">cleanup-platform</code> (array of strings)</span></dt><dd><p>Extra files to clean up in the platform.</p></dd><dt><span class="term"><code class="option">finish-args</code> (array of strings)</span></dt><dd><p>An array of arguments passed to the <span class="command"><strong>flatpak build-finish</strong></span> command.</p></dd><dt><span class="term"><code class="option">rename-desktop-file</code> (string)</span></dt><dd><p>Any desktop file with this name will be renamed to a name based on id during the cleanup phase.</p></dd><dt><span class="term"><code class="option">rename-appdata-file</code> (string)</span></dt><dd><p>Any appdata file with this name will be renamed to a name based on id during the cleanup phase.</p></dd><dt><span class="term"><code class="option">rename-icon</code> (string)</span></dt><dd><p>Any icon with this name will be renamed to a name based on id during the cleanup phase.</p></dd><dt><span class="term"><code class="option">copy-icon</code> (boolean)</span></dt><dd><p>If rename-icon is set, keep a copy of the old icon file.</p></dd><dt><span class="term"><code class="option">desktop-file-name-prefix</code> (string)</span></dt><dd><p>This string will be prefixed to the Name key in the main application desktop file.</p></dd><dt><span class="term"><code class="option">desktop-file-name-suffix</code> (string)</span></dt><dd><p>This string will be suffixed to the Name key in the main application desktop file.</p></dd></dl></div></div><div class="refsect2"><a id="idm45148823480176"></a><h3>Build Options</h3><p>
- Build options specify the build environment of a module, and can be specified globally as
- well as per-module. Options can also be specified on a per-architecture basis using the arch property.
+ </p></dd></dl></div></div><div class="refsect1"><a id="idm140021655890688"></a><h2>Examples</h2><p>
+ <span class="command"><strong>$ flatpak --user update org.gnome.GEdit</strong></span>
+ </p></div><div class="refsect1"><a id="idm140021655888656"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-install"><span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-list"><span class="citerefentry"><span class="refentrytitle">flatpak-list</span>(1)</span></a>
+ </p></div></div></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a id="idm140021667501760"></a>File Formats</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="refentrytitle"><a href="#flatpak-flatpakrepo">flatpakrepo</a></span><span class="refpurpose"> — Reference to a remote</span></dt><dt><span class="refentrytitle"><a href="#flatpak-flatpakref">flatpakref</a></span><span class="refpurpose"> — Reference to a remote for an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-installation">flatpak installation</a></span><span class="refpurpose"> — Configuration for an installation location</span></dt><dt><span class="refentrytitle"><a href="#flatpak-metadata">flatpak metadata</a></span><span class="refpurpose"> — Information about an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote">flatpak remote</a></span><span class="refpurpose"> — Configuration for a remote</span></dt></dl></div><div class="refentry"><a id="flatpak-flatpakrepo"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-flatpakrepo — Reference to a remote</p></div><div class="refsect1"><a id="idm140021657833936"></a><h2>Description</h2><p>
+ Flatpak uses flatpakrepo files to share information about remotes.
+ The <code class="filename">flatpakrepo</code> file contains enough information
+ to add the remote. Use the <span class="command"><strong>flatpak remote-add --from</strong></span>
+ command to do so.
+ </p><p>
+ flatpakrepo files may also contain additional information that is useful
+ when displaying a remote to the user, e.g. in an app store.
+ </p><p>
+ The filename extension commonly used for flatpakrepo files is <code class="filename">.flatpakrepo</code>.
+ </p></div><div class="refsect1"><a id="idm140021660450752"></a><h2>File format</h2><p>
+ The flatpakrepo file is using the same .ini file format that is used for
+ systemd unit files or application .desktop files.
+ </p><div class="refsect2"><a id="idm140021659627648"></a><h3>[Flatpak Repo]</h3><p>
+ All the information is contained in the [Flatpak Repo] group.
</p><p>
- These are the properties that are accepted:
- </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">cflags</code> (string)</span></dt><dd><p>This is set in the environment variable CFLAGS during the build.</p></dd><dt><span class="term"><code class="option">cxxflags</code> (string)</span></dt><dd><p>This is set in the environment variable CXXFLAGS during the build.</p></dd><dt><span class="term"><code class="option">prefix</code> (string)</span></dt><dd><p>The build prefix for the modules (defaults to <code class="filename">/app</code> for
- applications and <code class="filename">/usr</code> for runtimes).</p></dd><dt><span class="term"><code class="option">env</code> (object)</span></dt><dd><p>This is a dictionary defining environment variables to be set during the build.</p></dd><dt><span class="term"><code class="option">build-args</code> (array of strings)</span></dt><dd><p>This is an array containing extra options to pass to flatpak build.</p></dd><dt><span class="term"><code class="option">strip</code> (boolean)</span></dt><dd><p>If this is true (the default is false) then all ELF files will be stripped after install.</p></dd><dt><span class="term"><code class="option">no-debuginfo</code> (boolean)</span></dt><dd><p>By default (if strip is not true) flatpak-builder extracts all debug info in ELF files to a separate files
- and puts this in an extension. If you want to disable this, set no-debuginfo to true.</p></dd><dt><span class="term"><code class="option">arch</code> (object)</span></dt><dd><p>This is a dictionary defining for each arch a separate build options object that override the main one.</p></dd></dl></div></div><div class="refsect2"><a id="idm45148823461968"></a><h3>Module</h3><p>
- Each module specifies a source that has to be separately built and installed. It contains
- the build options and a list of sources to download and extract before building.
+ The following keys can be present in this group:
+ </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">Version</code> (uint64)</span></dt><dd><p>The version of the file format, must be 1 if present.</p></dd><dt><span class="term"><code class="option">Url</code> (string)</span></dt><dd><p>The url for the remote. This key is mandatory.</p></dd><dt><span class="term"><code class="option">GPGKey</code> (string)</span></dt><dd><p>The base64-encoded gpg key for the remote.</p></dd><dt><span class="term"><code class="option">DefaultBranch</code> (string)</span></dt><dd><p>The default branch to use for this remote.</p></dd><dt><span class="term"><code class="option">Title</code> (string)</span></dt><dd><p>The title of the remote. This should be a user-friendly name that can be displayed e.g. in an app store.</p></dd><dt><span class="term"><code class="option">Comment</code> (string)</span></dt><dd><p>A short summary of the remote, for display e.g. in an app store.</p></dd><dt><span class="term"><code class="option">Description</code> (string)</span></dt><dd><p>A longer description of the remote, for display e.g. in an app store..</p></dd><dt><span class="term"><code class="option">Icon</code> (string)</span></dt><dd><p>The url for an icon that can be used to represent the remote.</p></dd><dt><span class="term"><code class="option">Homepage</code> (string)</span></dt><dd><p>The url of a webpage describing the remote.</p></dd></dl></div></div></div><div class="refsect1"><a id="idm140021661272880"></a><h2>Example</h2><pre class="programlisting">
+[Flatpak Repo]
+Title=GEdit
+Url=http://sdk.gnome.org/repo-apps/
+GPGKey=mQENBFUUCGcBCAC/K9WeV4xCaKr3NKRqPXeY5mpaXAJyasLqCtrDx92WUgbu0voWrhohNAKpqizod2dvzc/XTxm3rHyIxmNfdhz1gaGhynU75Qw4aJVcly2eghTIl++gfDtOvrOZo/VuAq30f32dMIgHQdRwEpgCwz7WyjpqZYltPAEcCNL4MTChAfiHJeeiQ5ibystNBW8W6Ymf7sO4m4g5+/aOxI54oCOzD9TwBAe+yXcJJWtc2rAhMCjtyPJzxd0ZVXqIzCe1xRvJ6Rq7YCiMbiM2DQFWXKnmYQbj4TGNMnwNdAajCdrcBWEMSbzq7EzuThIJRd8Ky4BkEe1St6tuqwFaMZz+F9eXABEBAAG0KEdub21lIFNESyAzLjE2IDxnbm9tZS1vcy1saXN0QGdub21lLm9yZz6JATgEEwECACIFAlUUCGcCGwMGCwkIBwMCBhUIAgkKCwQWAgMBAh4BAheAAAoJEArkz6VV0VKBa5cH/0vXa31YgEjNk78gGFXqnQxdD1WYA87OYxDi189l4lA802EFTF4wCBuZyDOqdd5BhS3Ab0cR778DmZXRUP2gwe+1zTJypU2JMnDpkwJ4NK1VP6/tE4SAPrznBtmb76BKaWBqUfZ9Wq1zg3ugvqkZB/Exq+usypIOwQVp1KL58TrjBRda0HvRctzkNhr0qYAtkfLFe0GvksBp4vBm8uGwAx7fw/HbhIjQ9pekTwvB+5GwDPO/tSip/1bQfCS+XJB8Ffa04HYPLGedalnWBrwhYY+G/kn5Zh9L/AC8xeLwTJTHM212rBjPa9CWs9C6a57MSaeGIEHLC1hEyiJJ15w8jmY=
+
+</pre></div><div class="refsect1"><a id="idm140021655448992"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-remote-add"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-add</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-flatpakref"><span class="citerefentry"><span class="refentrytitle">flatpak-flatpakref</span>(5)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-flatpakref"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-flatpakref — Reference to a remote for an application or runtime</p></div><div class="refsect1"><a id="idm140021659789984"></a><h2>Description</h2><p>
+ Flatpak uses flatpakref files to share information about a remote for
+ a single application. The <code class="filename">flatpakref</code> file contains
+ enough information to add the remote and install the application.
+ Use the <span class="command"><strong>flatpak install --from</strong></span> command to do so.
+ </p><p>
+ flatpakref files may also contain additional information that is useful
+ when displaying the application to the user, e.g. in an app store.
+ </p><p>
+ The filename extension commonly used for flatpakref files is <code class="filename">.flatpakref</code>.
+ </p><p>
+ A flatpakref file can also refer to a remote for a runtime.
+ </p></div><div class="refsect1"><a id="idm140021655403120"></a><h2>File format</h2><p>
+ The flatpakref file is using the same .ini file format that is used for
+ systemd unit files or application .desktop files.
+ </p><div class="refsect2"><a id="idm140021655401968"></a><h3>[Flatpak Ref]</h3><p>
+ All the information is contained in the [Flatpak Ref] group.
</p><p>
- Modules can be nested, in order to turn related modules on and off with a single key.
+ The following keys can be present in this group:
+ </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">Version</code> (uint64)</span></dt><dd><p>The version of the file format, must be 1 if present.</p></dd><dt><span class="term"><code class="option">Name</code> (string)</span></dt><dd><p>The fully qualified name of the runtime that is used by the application. This key is mandatory.</p></dd><dt><span class="term"><code class="option">Url</code> (string)</span></dt><dd><p>The url for the remote. This key is mandatory.</p></dd><dt><span class="term"><code class="option">Branch</code> (string)</span></dt><dd><p>The name of the branch from which to install the application or runtime. If this key is not specified, the "master" branch is used.</p></dd><dt><span class="term"><code class="option">Title</code> (string)</span></dt><dd><p>The title of the application or runtime. This should be a user-friendly name that can be displayed e.g. in an app store.</p></dd><dt><span class="term"><code class="option">Comment</code> (string)</span></dt><dd><p>A short summary of the application or runtime, for display e.g. in an app store.</p></dd><dt><span class="term"><code class="option">Description</code> (string)</span></dt><dd><p>A longer description of the application or runtime, for display e.g. in an app store..</p></dd><dt><span class="term"><code class="option">Icon</code> (string)</span></dt><dd><p>The url for an icon that can be used to represent the application or runtime.</p></dd><dt><span class="term"><code class="option">Homepage</code> (string)</span></dt><dd><p>The url of a webpage describing the application or runtime.</p></dd><dt><span class="term"><code class="option">IsRuntime</code> (boolean)</span></dt><dd><p>Whether this file refers to a runtime. If this key is not specified, the file is assumed to refer to an application.</p></dd><dt><span class="term"><code class="option">GPGKey</code> (string)</span></dt><dd><p>The base64-encoded gpg key for the remote.</p></dd><dt><span class="term"><code class="option">RuntimeRepo</code> (string)</span></dt><dd><p>The url for a .flatpakref file for the runtime.</p></dd></dl></div></div></div><div class="refsect1"><a id="idm140021662012576"></a><h2>Example</h2><pre class="programlisting">
+[Flatpak Ref]
+Title=GEdit
+Name=org.gnome.gedit
+Branch=stable
+Url=http://sdk.gnome.org/repo-apps/
+IsRuntime=False
+GPGKey=mQENBFUUCGcBCAC/K9WeV4xCaKr3NKRqPXeY5mpaXAJyasLqCtrDx92WUgbu0voWrhohNAKpqizod2dvzc/XTxm3rHyIxmNfdhz1gaGhynU75Qw4aJVcly2eghTIl++gfDtOvrOZo/VuAq30f32dMIgHQdRwEpgCwz7WyjpqZYltPAEcCNL4MTChAfiHJeeiQ5ibystNBW8W6Ymf7sO4m4g5+/aOxI54oCOzD9TwBAe+yXcJJWtc2rAhMCjtyPJzxd0ZVXqIzCe1xRvJ6Rq7YCiMbiM2DQFWXKnmYQbj4TGNMnwNdAajCdrcBWEMSbzq7EzuThIJRd8Ky4BkEe1St6tuqwFaMZz+F9eXABEBAAG0KEdub21lIFNESyAzLjE2IDxnbm9tZS1vcy1saXN0QGdub21lLm9yZz6JATgEEwECACIFAlUUCGcCGwMGCwkIBwMCBhUIAgkKCwQWAgMBAh4BAheAAAoJEArkz6VV0VKBa5cH/0vXa31YgEjNk78gGFXqnQxdD1WYA87OYxDi189l4lA802EFTF4wCBuZyDOqdd5BhS3Ab0cR778DmZXRUP2gwe+1zTJypU2JMnDpkwJ4NK1VP6/tE4SAPrznBtmb76BKaWBqUfZ9Wq1zg3ugvqkZB/Exq+usypIOwQVp1KL58TrjBRda0HvRctzkNhr0qYAtkfLFe0GvksBp4vBm8uGwAx7fw/HbhIjQ9pekTwvB+5GwDPO/tSip/1bQfCS+XJB8Ffa04HYPLGedalnWBrwhYY+G/kn5Zh9L/AC8xeLwTJTHM212rBjPa9CWs9C6a57MSaeGIEHLC1hEyiJJ15w8jmY=
+</pre></div><div class="refsect1"><a id="idm140021662011104"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-install"><span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span></a>
+ <a class="citerefentry" href="#flatpak-flatpakrepo"><span class="citerefentry"><span class="refentrytitle">flatpak-flatpakrepo</span>(5)</span></a>,
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-installation"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-installation — Configuration for an installation location</p></div><div class="refsect1"><a id="idm140021655947472"></a><h2>Description</h2><p>
+ flatpak can operate in system-wide or per-user mode. The system-wide data
+ is located in <code class="filename">$prefix/var/lib/flatpak/</code>, and the per-user data is in
+ <code class="filename">$HOME/.local/share/flatpak/</code>.
+ </p><p>
+ In addition to the default installation locations, more system-wide installations
+ can be defined via configuration files <code class="filename">/etc/flatpak/installations.d/</code>,
+ which must have the .conf extension and follow the format described below.
+ </p></div><div class="refsect1"><a id="idm140021655413488"></a><h2>File format</h2><p>
+ The installation config file format is using the same .ini file format that is used
+ for systemd unit files or application .desktop files.
+ </p><div class="refsect2"><a id="idm140021655412144"></a><h3>[Installation …]</h3><p>
+ All the configuration for the the installation location with name NAME is contained
+ in the [Installation "NAME"] group.
</p><p>
- These are the properties that are accepted:
- </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">name</code> (string)</span></dt><dd><p>The name of the module, used in e.g. build logs. The name is also used for constructing filenames and commandline arguments, therefore using spaces or '/' in this string is a bad idea.</p></dd><dt><span class="term"><code class="option">disabled</code> (boolean)</span></dt><dd><p>If true, skip this module</p></dd><dt><span class="term"><code class="option">sources</code> (array of objects)</span></dt><dd><p>An array of objects defining sources that will be downloaded and extracted in order</p></dd><dt><span class="term"><code class="option">config-opts</code> (array of strings)</span></dt><dd><p>An array of options that will be passed to configure</p></dd><dt><span class="term"><code class="option">make-args</code> (array of strings)</span></dt><dd><p>An array of arguments that will be passed to make</p></dd><dt><span class="term"><code class="option">make-install-args</code> (array of strings)</span></dt><dd><p>An array of arguments that will be passed to make install</p></dd><dt><span class="term"><code class="option">rm-configure</code> (boolean)</span></dt><dd><p>If true, remove the configure script before starting build</p></dd><dt><span class="term"><code class="option">no-autogen</code> (boolean)</span></dt><dd><p>Ignore the existence of an autogen script</p></dd><dt><span class="term"><code class="option">no-parallel-make</code> (boolean)</span></dt><dd><p>Don't call make with arguments to build in parallel</p></dd><dt><span class="term"><code class="option">no-python-timestamp-fix</code> (boolean)</span></dt><dd><p>Don't fix up the *.py[oc] header timestamps for ostree use.</p></dd><dt><span class="term"><code class="option">cmake</code> (boolean)</span></dt><dd><p>Use cmake instead of configure</p></dd><dt><span class="term"><code class="option">builddir</code> (boolean)</span></dt><dd><p>Use a build directory that is separate from the source directory</p></dd><dt><span class="term"><code class="option">subdir</code> (string)</span></dt><dd><p>Build inside this subdirectory of the extracted sources</p></dd><dt><span class="term"><code class="option">build-options</code> (object)</span></dt><dd><p>A build options object that can override global options</p></dd><dt><span class="term"><code class="option">post-install</code> (array of strings)</span></dt><dd><p>An array of shell commands that are run after the install phase. Can for example
- clean up the install dir, or install extra files.
- </p></dd><dt><span class="term"><code class="option">cleanup</code> (array of strings)</span></dt><dd><p>An array of file patterns that should be removed at the end.
- Patterns starting with / are taken to be full pathnames (without the /app prefix), otherwise they just match
- the basename. Note that any patterns will only match files installed by this module.
- </p></dd><dt><span class="term"><code class="option">cleanup-platform</code> (array of strings)</span></dt><dd><p>Extra files to clean up in the platform.</p></dd><dt><span class="term"><code class="option">modules</code> (array of objects or strings)</span></dt><dd><p>An array of objects specifying nested modules to be built before this one.
- String members in the array are interpreted as names of a separate json file that contains a module.</p></dd></dl></div></div><div class="refsect2"><a id="idm45148823426656"></a><h3>Sources</h3><p>
- These contain a pointer to the source that will be extracted into the source directory before
- the build starts. They can be of several types, distinguished by the type property.
- </p><div class="refsect3"><a id="idm45148823425264"></a><h4>Archive sources (tar, zip)</h4><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">type</code></span></dt><dd><p>"archive"</p></dd><dt><span class="term"><code class="option">path</code> (string)</span></dt><dd><p>The path of the archive</p></dd><dt><span class="term"><code class="option">url</code> (string)</span></dt><dd><p>The URL of a remote archive that will be downloaded. This overrides path if both are specified.</p></dd><dt><span class="term"><code class="option">sha256</code> (string)</span></dt><dd><p>The sha256 checksum of the file, verified after download</p></dd><dt><span class="term"><code class="option">strip-components</code> (integer)</span></dt><dd><p>The number of initial pathname components to strip during extraction. Defaults to 1.</p></dd><dt><span class="term"><code class="option">dest</code> (string)</span></dt><dd><p>Directory inside the source dir where the archive will be extracted.</p></dd></dl></div></div><div class="refsect3"><a id="idm45148823413232"></a><h4>Git sources</h4><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">type</code></span></dt><dd><p>"git"</p></dd><dt><span class="term"><code class="option">path</code> (string)</span></dt><dd><p>The path to a local checkout of the git repository. Due to how git-clone works, this will be much faster than specifying a URL of file:///...</p></dd><dt><span class="term"><code class="option">url</code> (string)</span></dt><dd><p>URL of the git repository. This overrides path if both are specified.</p></dd><dt><span class="term"><code class="option">branch</code> (string)</span></dt><dd><p>The branch/tag/commit to use from the git repository</p></dd><dt><span class="term"><code class="option">dest</code> (string)</span></dt><dd><p>Directory inside the source dir where the repository will be checked out.</p></dd></dl></div></div><div class="refsect3"><a id="idm45148823402960"></a><h4>Bzr sources</h4><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">type</code></span></dt><dd><p>"bzr"</p></dd><dt><span class="term"><code class="option">url</code> (string)</span></dt><dd><p>URL of the bzr repository</p></dd><dt><span class="term"><code class="option">revision</code> (string)</span></dt><dd><p>A specific revision to use in the branch</p></dd><dt><span class="term"><code class="option">dest</code> (string)</span></dt><dd><p>Directory inside the source dir where the repository will be checked out.</p></dd></dl></div></div><div class="refsect3"><a id="idm45148823394560"></a><h4>File sources</h4><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">type</code></span></dt><dd><p>"file"</p></dd><dt><span class="term"><code class="option">path</code> (string)</span></dt><dd><p>The path of a local file that will be copied into the source dir</p></dd><dt><span class="term"><code class="option">url</code> (string)</span></dt><dd><p>The URL of a remote file that will be downloaded and copied into the source dir. This overrides path if both are specified.</p></dd><dt><span class="term"><code class="option">sha256</code> (string)</span></dt><dd><p>The sha256 checksum of the file, verified after download. This is optional for local files.</p></dd><dt><span class="term"><code class="option">dest-filename</code> (string)</span></dt><dd><p>Filename to use inside the source dir, default to the basename of path.</p></dd><dt><span class="term"><code class="option">dest</code> (string)</span></dt><dd><p>Directory inside the source dir where the file will be copied.</p></dd></dl></div></div><div class="refsect3"><a id="idm45148823382448"></a><h4>Script sources</h4><p>
- This is a way to create a shell (/bin/sh) script from an inline set of commands.
- </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">type</code></span></dt><dd><p>"script"</p></dd><dt><span class="term"><code class="option">commands</code> (array of strings)</span></dt><dd><p>An array of shell commands that will be put in a shellscript file</p></dd><dt><span class="term"><code class="option">dest-filename</code> (string)</span></dt><dd><p>Filename to use inside the source dir, default to the basename of path.</p></dd><dt><span class="term"><code class="option">dest</code> (string)</span></dt><dd><p>Directory inside the source dir where the file will be copied.</p></dd></dl></div></div><div class="refsect3"><a id="idm45148823373408"></a><h4>Shell sources</h4><p>
- This is a way to create/modify the sources by running shell commands.
- </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">type</code></span></dt><dd><p>"shell"</p></dd><dt><span class="term"><code class="option">commands</code> (array of strings)</span></dt><dd><p>An array of shell commands that will be run during source extraction</p></dd></dl></div></div><div class="refsect3"><a id="idm45148823368048"></a><h4>Patch sources</h4><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">type</code></span></dt><dd><p>"patch"</p></dd><dt><span class="term"><code class="option">path</code> (string)</span></dt><dd><p>The path of a patch file that will be applied in the source dir</p></dd><dt><span class="term"><code class="option">strip-components</code> (integer)</span></dt><dd><p>The value of the -p argument to patch, defaults to 1.</p></dd><dt><span class="term"><code class="option">dest</code> (string)</span></dt><dd><p>Directory inside the source dir where the patch will be applied.</p></dd><dt><span class="term"><code class="option">use-git</code> (boolean)</span></dt><dd><p>Whether to use "git apply" rather than "patch" to apply the patch, required when the patch file contains binary diffs.</p></dd></dl></div></div></div></div><div class="refsect1"><a id="idm45148823357424"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
- Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
- Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
- Print version information and exit.
- </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
- Specify the machine architecture to build for. If no architecture is specified, the host architecture will be automatically detected. Only host compatible architectures can be specified.
- </p></dd><dt><span class="term"><code class="option">--disable-cache</code></span></dt><dd><p>
- Don't look at the existing cache for a previous build, instead always rebuild modules.
- </p></dd><dt><span class="term"><code class="option">--disable-download</code></span></dt><dd><p>
- Don't download any sources. This only works if some version of all sources are downloaded
- already. This is useful if you want to guarantee that no network i/o is done. However, the
- build will fail if some source is not locally available.
- </p></dd><dt><span class="term"><code class="option">--disable-updates</code></span></dt><dd><p>
- Download missing sources, but don't update local mirrors of version control repos. This is useful
- to rebuild things but without updating git or bzr repositories from the remote repository.
- </p></dd><dt><span class="term"><code class="option">--run</code></span></dt><dd><p>
- Run a command in a sandbox based on the build dir. This starts flatpak build, with some extra
- arguments to give the same environment as the build, and the same permissions the final app
- will have. The command to run must be the last argument passed to
- flatpak-builder, after the directory and the manifest.
- </p></dd><dt><span class="term"><code class="option">--show-deps</code></span></dt><dd><p>
- List all the (local) files that the manifest depends on.
- </p></dd><dt><span class="term"><code class="option">--download-only</code></span></dt><dd><p>
- Exit successfully after downloading the required sources.
- </p></dd><dt><span class="term"><code class="option">--build-only</code></span></dt><dd><p>
- Don't do the cleanup and finish stages, which is useful if you
- want to build more things into the app.
- </p></dd><dt><span class="term"><code class="option">--finish-only</code></span></dt><dd><p>
- Only do the cleanup, finish and export stages, picking up
- where a --build-only command left off.
- </p></dd><dt><span class="term"><code class="option">--require-changes</code></span></dt><dd><p>
- Do nothing, leaving a non-existent DIRECTORY if nothing changes since
- last cached build. If this is not specified, the latest version from the cache will be put
- into DIRECTORY .
- </p></dd><dt><span class="term"><code class="option">--keep-build-dirs</code></span></dt><dd><p>
- Don't remove the sources and build after having built and installed each module.
- This also creates a symlink to the build directory with a stable name ("build-modulename").
- </p></dd><dt><span class="term"><code class="option">--ccache</code></span></dt><dd><p>
- Enable use of ccache in the build (needs ccache in the sdk)
- </p></dd><dt><span class="term"><code class="option">--stop-at=MODULENAME</code></span></dt><dd><p>
- Stop building at the specified module, ignoring all the following ones.
- This is useful for debugging and development. For instance, you can
- build all the dependencies, but stop at the main application so that
- you can then do a build from a pre-existing checkout.
- Implies --build-only.
- </p></dd><dt><span class="term"><code class="option">--repo=DIR</code></span></dt><dd><p>
- When build is done, run export the result to this repository.
- </p></dd><dt><span class="term"><code class="option">-s</code>, </span><span class="term"><code class="option">--subject=SUBJECT</code></span></dt><dd><p>
- One line subject for the commit message.
- Used when exporting the build results.
- </p></dd><dt><span class="term"><code class="option">-b</code>, </span><span class="term"><code class="option">--body=BODY</code></span></dt><dd><p>
- Full description for the commit message.
- Used when exporting the build results.
- </p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
- Sign the commit with this GPG key.
- Used when exporting the build results.
- This option can be used multiple times.
- </p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
- GPG Homedir to use when looking for keyrings.
- Used when exporting the build results.
- </p></dd><dt><span class="term"><code class="option">--force-clean</code></span></dt><dd><p>
- Erase the previous contents of DIRECTORY if it is
- not empty.
- </p></dd><dt><span class="term"><code class="option">--sandbox</code></span></dt><dd><p>
- Disable the possibility to specify build-args that
- are passed to flatpak build. This means the build
- process can't break out of its sandbox, and is
- useful when building less trusted software.
- </p></dd><dt><span class="term"><code class="option">--allow-missing-runtimes</code></span></dt><dd><p>
- Do not immediately fail if the sdk or platform runtimes
- are not installed on this system. Attempting to build any
- manifest modules will still fail if the sdk is missing, but
- may be useful for apps that install files without a sandbox
- build.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148823308832"></a><h2>Caching</h2><p>
- flatpak-builder caches sources and partial build results in
- the .flatpak-builder subdirectory of the current directory. If you
- use <code class="option">--keep-build-dirs</code>, build directories for each
- module are also stored here.
- </p><p>
- It is safe to remove the contents of the .flatpak-builder
- directory. This will force a full build the next time you build.
- </p></div><div class="refsect1"><a id="idm45148823306224"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak-builder my-app-dir manifest.json</strong></span>
- </p><p>
- Example manifest file:
- </p><pre class="programlisting">
-{
- "id": "org.test.TestApp",
- "runtime": "org.freedesktop.Platform",
- "runtime-version": "1.2",
- "sdk": "org.freedesktop.Sdk",
- "command": "test",
- "clean": [ "/include", "*.la" ],
- "build-options" : {
- "cflags": "-O2 -g",
- "cxxflags": "-O2 -g",
- "env": {
- "V": "1"
- },
- "arch": {
- "x86_64": {
- "cflags": "-O3 -g",
- }
- }
- },
- "modules": [
- {
- "name": "pygobject",
- "config-opts": [ "--disable-introspection" ],
- "sources": [
- {
- "type": "archive",
- "url": "http://ftp.gnome.org/pub/GNOME/sources/pygobject/2.28/pygobject-2.28.6.tar.xz",
- "sha256": "fb8a1d4f665130a125011659bd347c7339c944232163dbb9a34fd0686577adb8"
- },
- {
- "type": "patch",
- "path": "required-pygobject-fix.patch"
- },
- {
- "type": "file",
- "path": "pygobject-extra-file",
- "dest-filename": "extra-file"
- }
- ]
- },
- {
- "name": "babl",
- "build-options" : { "cxxflags": "-O2 -g -std=c++11" },
- "cleanup": [ "/bin" ],
- "sources": [
- {
- "type": "git",
- "url": "git://git.gnome.org/babl"
- }
- ]
- },
- {
- "name": "testapp",
- "sources": [
- {
- "type": "bzr",
- "url": "lp:testapp"
- }
- ]
- }
- ]
-}
-</pre></div><div class="refsect1"><a id="idm45148823301344"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-metadata"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-metadata — Information about an application or runtime</p></div><div class="refsect1"><a id="idm45148826317856"></a><h2>Description</h2><p>
+ The following keys are recognized:
+ </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">Path</code> (string)</span></dt><dd><p>The path for this installation. This key is mandatory.</p></dd><dt><span class="term"><code class="option">DisplayName</code> (string)</span></dt><dd><p>The name to use when showing this installation in the UI.</p></dd><dt><span class="term"><code class="option">Priority</code> (integer)</span></dt><dd><p>A priority for this installation.</p></dd><dt><span class="term"><code class="option">StorageType</code> (string)</span></dt><dd><p>The type of storage used for this installation. Possible values include: network, mmc, sdcard, harddisk.</p></dd></dl></div></div></div><div class="refsect1"><a id="idm140021656013536"></a><h2>Examples</h2><pre class="programlisting">
+[Installation "extra"]
+Path=/location/of/sdcard
+DisplayName=Extra Installation
+StorageType=sdcard
+</pre></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-metadata"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-metadata — Information about an application or runtime</p></div><div class="refsect1"><a id="idm140021661165952"></a><h2>Description</h2><p>
Flatpak uses metadata files to describe applications and runtimes.
The <code class="filename">metadata</code> file for a deployed application or
runtime is placed in the toplevel deploy directory. For example, the
@@ -1596,16 +2093,33 @@ Content Bytes Written: 305
run command, or permanently with the flatpak override command.
</p><p>
A metadata file describing the effective configuration is available
- inside the running sandbox at <code class="filename">/run/user/$UID/flatpak-info</code>.
- </p></div><div class="refsect1"><a id="idm45148827935408"></a><h2>File format</h2><p>
+ inside the running sandbox at <code class="filename">/.flatpak-info</code>.
+ For compatibility with older Flatpak versions,
+ <code class="filename">/run/user/$UID/flatpak-info</code> is a symbolic
+ link to the same file.
+ </p></div><div class="refsect1"><a id="idm140021661719216"></a><h2>File format</h2><p>
The metadata file is using the same .ini file format that is used for
systemd unit files or application .desktop files.
- </p><div class="refsect2"><a id="idm45148828478416"></a><h3>[Application] or [Runtime]</h3><p>
+ </p><div class="refsect2"><a id="idm140021661718064"></a><h3>[Application] or [Runtime]</h3><p>
Metadata for applications starts with an [Application] group,
metadata for runtimes with a [Runtime] group.
</p><p>
The following keys can be present in these groups:
- </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">name</code> (string)</span></dt><dd><p>The name of the application or runtime. This key is mandatory.</p></dd><dt><span class="term"><code class="option">runtime</code> (string)</span></dt><dd><p>The fully qualified name of the runtime that is used by the application. This key is mandatory for applications.</p></dd><dt><span class="term"><code class="option">sdk</code> (string)</span></dt><dd><p>The fully qualified name of the sdk that matches the runtime.</p></dd><dt><span class="term"><code class="option">command</code> (string)</span></dt><dd><p>The command to run. Only relevant for applications.</p></dd></dl></div></div><div class="refsect2"><a id="idm45148824113904"></a><h3>[Context]</h3><p>
+ </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">name</code> (string)</span></dt><dd><p>The name of the application or runtime. This key is mandatory.</p></dd><dt><span class="term"><code class="option">runtime</code> (string)</span></dt><dd><p>The fully qualified name of the runtime that is used by the application. This key is mandatory for applications.</p></dd><dt><span class="term"><code class="option">sdk</code> (string)</span></dt><dd><p>
+ The fully qualified name of the sdk that matches the
+ runtime. Available since 0.1.</p></dd><dt><span class="term"><code class="option">command</code> (string)</span></dt><dd><p>
+ The command to run. Only relevant for applications.
+ Available since 0.1.
+ </p></dd><dt><span class="term"><code class="option">required-flatpak</code> (string)</span></dt><dd><p>
+ The required version of Flatpak to run this application
+ or runtime. For applications, this was available since
+ 0.8.0. For runtimes, this was available since 0.9.1,
+ and backported to 0.8.3 for the 0.8.x branch.
+ </p></dd><dt><span class="term"><code class="option">tags</code> (string list)</span></dt><dd><p>
+ Tags to include in AppStream XML.
+ Available since 0.4.12.
+
+ </p></dd></dl></div></div><div class="refsect2"><a id="idm140021657301728"></a><h3>[Context]</h3><p>
This group determines various system resources that may be shared
with the application when it is run in a flatpak sandbox.
</p><p>
@@ -1613,28 +2127,143 @@ Content Bytes Written: 305
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">shared</code> (list)</span></dt><dd><p>
List of subsystems to share with the host system.
Possible subsystems: network, ipc.
+ Available since 0.3.
</p></dd><dt><span class="term"><code class="option">sockets</code> (list)</span></dt><dd><p>
List of well-known sockets to make available in the sandbox.
- Possible sockets: x11, wayland, pulseaudio, session-bus, system-bus.
+ Possible sockets: x11, wayland, fallback-x11, pulseaudio, session-bus, system-bus.
When making a socket available, flatpak also sets
well-known environment variables like DISPLAY or
DBUS_SYSTEM_BUS_ADDRESS to let the application
find sockets that are not in a fixed location.
+ Available since 0.3.
</p></dd><dt><span class="term"><code class="option">devices</code> (list)</span></dt><dd><p>
List of devices to make available in the sandbox.
- Possible values: dri, kvm, all.
+ Possible values:
+ </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">dri</code></span></dt><dd><p>
+ Graphics direct rendering
+ (<code class="filename">/dev/dri</code>).
+ Available since 0.3.
+ </p></dd><dt><span class="term"><code class="option">kvm</code></span></dt><dd><p>
+ Virtualization
+ (<code class="filename">/dev/kvm</code>).
+ Available since 0.6.12.
+ </p></dd><dt><span class="term"><code class="option">all</code></span></dt><dd><p>
+ All device nodes in <code class="filename">/dev</code>.
+ Available since 0.6.6.
+ </p></dd></dl></div><p>
</p></dd><dt><span class="term"><code class="option">filesystems</code> (list)</span></dt><dd><p>
List of filesystem subsets to make available to the
- application. Possible values: home, host, xdg-desktop,
- xdg-documents, xdg-download xdg-music, xdg-pictures,
- xdg-public-share, xdg-templates, xdg-videos, xdg-run,
- an absolute path, or a homedir-relative path like
- ~/dir or paths relative to the xdg dirs, like
- xdg-download/subdir. The xdg-* arguments can also
- specify a subdirectory, such as xdg-pictures/screenshots.
- Each entry can have a suffix of
- :ro or :rw to indicate if the path should be shared
- read-only or read-write (default is read-write).
+ application. Possible values:
+ </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">home</code></span></dt><dd><p>
+ The entire home directory.
+ Available since 0.3.
+ </p></dd><dt><span class="term"><code class="option">host</code></span></dt><dd><p>
+ The entire host file system, except for
+ directories that are handled specially by
+ Flatpak.
+ In particular, this shares
+ <code class="filename">/home</code>,
+ <code class="filename">/media</code>,
+ <code class="filename">/opt</code>,
+ <code class="filename">/run/media</code> and
+ <code class="filename">/srv</code> if they exist.
+ </p><p>
+ <code class="filename">/dev</code> is not shared:
+ use <code class="option">devices=all;</code> instead.
+ </p><p>
+ Parts of <code class="filename">/sys</code> are always
+ shared. This option does not make additional
+ files in /sys available.
+ </p><p>
+ These other reserved directories are
+ currently excluded:
+ <code class="filename">/app</code>,
+ <code class="filename">/bin</code>,
+ <code class="filename">/boot</code>,
+ <code class="filename">/etc</code>,
+ <code class="filename">/lib</code>,
+ <code class="filename">/lib32</code>,
+ <code class="filename">/lib64</code>,
+ <code class="filename">/proc</code>,
+ <code class="filename">/root</code>,
+ <code class="filename">/run</code>,
+ <code class="filename">/sbin</code>,
+ <code class="filename">/tmp</code>,
+ <code class="filename">/usr</code>,
+ <code class="filename">/var</code>.
+ </p><p>
+ Available since 0.3.
+ </p></dd><dt><span class="term"><code class="option">xdg-desktop</code>,
+ <code class="option">xdg-documents</code>,
+ <code class="option">xdg-download</code>,
+ <code class="option">xdg-music</code>,
+ <code class="option">xdg-pictures</code>,
+ <code class="option">xdg-public-share</code>,
+ <code class="option">xdg-videos</code>,
+ <code class="option">xdg-templates</code>
+ </span></dt><dd><p>
+ <a class="ulink" href="https://www.freedesktop.org/wiki/Software/xdg-user-dirs/" target="_top">freedesktop.org special directories</a>.
+ Available since 0.3.
+ </p></dd><dt><span class="term"><code class="option">xdg-desktop/<em class="replaceable"><code>path</code></em></code>,
+ <code class="option">xdg-documents/<em class="replaceable"><code>path</code></em></code>,
+ etc.
+ </span></dt><dd><p>
+ Subdirectories of freedesktop.org special
+ directories. Available since 0.4.13.
+ </p></dd><dt><span class="term">
+ <code class="option">xdg-cache</code>,
+ <code class="option">xdg-config</code>,
+ <code class="option">xdg-data</code>
+ </span></dt><dd><p>
+ Directories defined by the
+ <a class="ulink" href="https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html" target="_top">freedesktop.org Base Directory
+ Specification</a>.
+ Available since 0.6.14.
+ </p></dd><dt><span class="term">
+ <code class="option">xdg-cache/<em class="replaceable"><code>path</code></em></code>,
+ <code class="option">xdg-config/<em class="replaceable"><code>path</code></em></code>,
+ <code class="option">xdg-data/<em class="replaceable"><code>path</code></em></code>
+ </span></dt><dd><p>
+ Subdirectories of directories defined by the
+ freedesktop.org Base Directory Specification.
+ Available since 0.6.14.
+ </p></dd><dt><span class="term">
+ <code class="option">xdg-run/<em class="replaceable"><code>path</code></em></code>
+ </span></dt><dd><p>
+ Subdirectories of the
+ <code class="envar">XDG_RUNTIME_DIR</code> defined by
+ the
+ <a class="ulink" href="https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html" target="_top">freedesktop.org Base Directory
+ Specification</a>. Note that
+ <code class="option">xdg-run</code> on its own is not
+ supported. Available since 0.4.13.
+ </p></dd><dt><span class="term">
+ <code class="option">/<em class="replaceable"><code>path</code></em></code>
+ </span></dt><dd><p>
+ An arbitrary absolute path. Available since 0.3.
+ </p></dd><dt><span class="term">
+ <code class="option">~/<em class="replaceable"><code>path</code></em></code>
+ </span></dt><dd><p>
+ An arbitrary path relative to the home
+ directory. Available since 0.3.
+ </p></dd><dt><span class="term">
+ One of the above followed by
+ <code class="option">:ro</code>
+ </span></dt><dd><p>
+ Make the given directory available read-only.
+ </p></dd><dt><span class="term">
+ One of the above followed by
+ <code class="option">:rw</code>
+ </span></dt><dd><p>
+ Make the given directory available read/write.
+ This is the default.
+ </p></dd><dt><span class="term">
+ One of the above followed by
+ <code class="option">:create</code>
+ </span></dt><dd><p>
+ Make the given directory available read/write,
+ and create it if it does not already exist.
+ </p></dd></dl></div><p>
</p></dd><dt><span class="term"><code class="option">persistent</code> (list)</span></dt><dd><p>
List of homedir-relative paths to make available at
the corresponding path in the per-application home directory,
@@ -1643,8 +2272,56 @@ Content Bytes Written: 305
For instance making ".myapp" persistent would make "~/.myapp"
in the sandbox a bind mount to "~/.var/app/org.my.App/.myapp",
thus allowing an unmodified application to save data in
- the per-application location.
- </p></dd></dl></div></div><div class="refsect2"><a id="idm45148828492768"></a><h3>[Session Bus Policy]</h3><p>
+ the per-application location. Available since 0.3.
+ </p></dd><dt><span class="term"><code class="option">features</code> (list)</span></dt><dd><p>
+ List of features available or unavailable to the
+ application, currently from the following list:
+ </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">devel</code></span></dt><dd><p>
+ Allow system calls used by development-oriented
+ tools such as <span class="command"><strong>perf</strong></span>,
+ <span class="command"><strong>strace</strong></span> and
+ <span class="command"><strong>gdb</strong></span>.
+ Available since 0.6.10.
+ </p></dd><dt><span class="term"><code class="option">multiarch</code></span></dt><dd><p>
+ Allow running multilib/multiarch binaries, for
+ example <code class="literal">i386</code> binaries in an
+ <code class="literal">x86_64</code> environment.
+ Available since 0.6.12.
+ </p></dd></dl></div><p>
+ A feature can be prefixed with <code class="option">!</code> to
+ indicate the absence of that feature, for example
+ <code class="option">!devel</code> if development and debugging
+ are not allowed.
+ </p></dd></dl></div></div><div class="refsect2"><a id="idm140021656110576"></a><h3>[Instance]</h3><p>
+ This group only appears in <code class="filename">/.flatpak-info</code>
+ for a running app, and not in the metadata files written by
+ application authors. It is filled in by Flatpak itself.
+ </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">app-path</code> (string)</span></dt><dd><p>
+ The absolute path on the host system of the app's
+ app files, as mounted at <code class="filename">/app</code>
+ inside the container. Available since 0.6.10.
+ </p></dd><dt><span class="term"><code class="option">branch</code> (string)</span></dt><dd><p>
+ The branch of the app, for example
+ <code class="literal">stable</code>. Available since
+ 0.6.10.
+ </p></dd><dt><span class="term"><code class="option">flatpak-version</code> (string)</span></dt><dd><p>
+ The version number of the Flatpak version that ran
+ this app. Available since 0.6.11.
+ </p></dd><dt><span class="term"><code class="option">runtime-path</code> (string)</span></dt><dd><p>
+ The absolute path on the host system of the app's
+ runtime files, as mounted at <code class="filename">/usr</code>
+ inside the container. Available since 0.6.10.
+ </p></dd><dt><span class="term"><code class="option">session-bus-proxy</code> (boolean)</span></dt><dd><p>
+ True if this app cannot access the D-Bus session bus
+ directly (either it goes via a proxy, or it cannot
+ access the session bus at all). Available since 0.8.0.
+
+ </p></dd><dt><span class="term"><code class="option">system-bus-proxy</code> (boolean)</span></dt><dd><p>
+ True if this app cannot access the D-Bus system bus
+ directly (either it goes via a proxy, or it cannot
+ access the system bus at all). Available since 0.8.0.
+
+ </p></dd></dl></div></div><div class="refsect2"><a id="idm140021655878384"></a><h3>[Session Bus Policy]</h3><p>
If the <code class="option">sockets</code> key is not allowing full access
to the D-Bus session bus, then flatpak provides filtered access.
</p><p>
@@ -1672,56 +2349,140 @@ Content Bytes Written: 305
access:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">none</code></span></dt><dd><p>
The bus name or names in question is invisible to the application.
+ Available since 0.2.
</p></dd><dt><span class="term"><code class="option">see</code></span></dt><dd><p>
The bus name or names can be enumerated by the application.
+ Available since 0.2.
</p></dd><dt><span class="term"><code class="option">talk</code></span></dt><dd><p>
The application can send messages/ and receive replies and signals from the bus name or names.
+ Available since 0.2.
</p></dd><dt><span class="term"><code class="option">own</code></span></dt><dd><p>
The application can own the bus name or names (as well as all the above).
- </p></dd></dl></div></div><div class="refsect2"><a id="idm45148823237696"></a><h3>[System Bus Policy]</h3><p>
+ Available since 0.2.
+ </p></dd></dl></div></div><div class="refsect2"><a id="idm140021655865808"></a><h3>[System Bus Policy]</h3><p>
If the <code class="option">sockets</code> key is not allowing full access
to the D-Bus system bus, then flatpak does not make the system
bus available unless the [System Bus Policy] group is present
- and provides a policy for filtered access.
+ and provides a policy for filtered access. Available since 0.2.
</p><p>
Entries in this group have the same form as for the [Session Bus Policy] group.
However, the app has no permissions by default.
- </p></div><div class="refsect2"><a id="idm45148823235040"></a><h3>[Environment]</h3><p>
+ </p></div><div class="refsect2"><a id="idm140021655863424"></a><h3>[Environment]</h3><p>
The [Environment] group specifies environment variables to set
- when running the application.
+ when running the application. Available since 0.3.
</p><p>
Entries in this group have the form <code class="option">VAR=VALUE</code>
where <code class="option">VAR</code> is the name of an environment variable
to set.
- </p></div><div class="refsect2"><a id="idm45148823232288"></a><h3>[Extension NAME]</h3><p>
- Runtimes and applications can define extensions, which are optional,
- additional runtimes to be mounted at a specified location inside
- the sandbox when they are present on the system. Typical uses for
- extensions include translations for applications, or debuginfo
- for sdks. The name of the extension is specified as part of the
+ </p></div><div class="refsect2"><a id="idm140021655860560"></a><h3>[Extension NAME]</h3><p>
+ Runtimes and applications can define extension points, which allow
+ optional, additional runtimes to be mounted at a specified location
+ inside the sandbox when they are present on the system. Typical uses
+ for extension points include translations for applications, or debuginfo
+ for sdks. The name of the extension point is specified as part of the
group heading.
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">directory</code> (string)</span></dt><dd><p>
The relative path at which the extension will be mounted in
- the sandbox. If the extension is for an application, the
+ the sandbox. If the extension point is for an application, the
path is relative to <code class="filename">/app</code>, otherwise
it is relative to <code class="filename">/usr</code>. This key
- is mandatory.
+ is mandatory. Available since 0.1.
</p></dd><dt><span class="term"><code class="option">version</code> (string)</span></dt><dd><p>
The branch to use when looking for the extension. If this is
not specified, it defaults to the branch of the application or
- runtime that the extension is for.
+ runtime that the extension point is for.
+ Available since 0.4.1.
+ </p></dd><dt><span class="term"><code class="option">versions</code> (string)</span></dt><dd><p>
+ The branches to use when looking for the extension. If this is
+ not specified, it defaults to the branch of the application or
+ runtime that the extension point is for. Available since
+ 0.9.1, and backported to the 0.8.x branch in 0.8.4.
+ </p></dd><dt><span class="term"><code class="option">add-ld-path</code> (string)</span></dt><dd><p>
+ A path relative to the extension point directory that will be appended
+ to LD_LIBRARY_PATH. Available since 0.9.1, and
+ backported to the 0.8.x branch in 0.8.3.
+ </p></dd><dt><span class="term"><code class="option">merge-dirs</code> (string)</span></dt><dd><p>
+ A list of relative paths of directories below the extension point directory
+ that will be merged. Available since 0.9.1, and
+ backported to the 0.8.x branch in 0.8.3.
+ </p></dd><dt><span class="term"><code class="option">download-if</code> (string)</span></dt><dd><p>
+ A condition that must be true for the extension to be auto-downloaded.
+ The only currently recognized value is active-gl-driver, which is true
+ if the name of the active GL driver matches the extension point basename.
+ Available since 0.9.1, and backported to the 0.8.x
+ branch in 0.8.3.
+ </p></dd><dt><span class="term"><code class="option">enable-if</code> (string)</span></dt><dd><p>
+ A condition that must be true for the extension to be enabled.
+ The only currently recognized value is active-gl-driver, which is true
+ if the name of the active GL driver matches the extension point basename.
+ Available since 0.9.1, and backported to the 0.8.x
+ branch in 0.8.3.
+ </p></dd><dt><span class="term"><code class="option">subdirectory-suffix</code> (string)</span></dt><dd><p>
+ A suffix that gets appended to the directory name. This is very
+ useful when the extension point naming scheme is "reversed". For example,
+ an extension point for GTK+ themes would be /usr/share/themes/$NAME/gtk-3.0,
+ which could be achieved using subdirectory-suffix=gtk-3.0.
+ Available since 0.9.1, and backported to the 0.8.x
+ branch in 0.8.3.
</p></dd><dt><span class="term"><code class="option">subdirectories</code> (boolean)</span></dt><dd><p>
If this key is set to true, then flatpak will look for
- extensions whose name is a prefix of the extension name, and
+ extensions whose name is a prefix of the extension point name, and
mount them at the corresponding name below the subdirectory.
+ Available since 0.1.
</p></dd><dt><span class="term"><code class="option">no-autodownload</code> (boolean)</span></dt><dd><p>
- Whether to automatically download this extension
- when updating or installing a 'related' application
- or runtime.
+ Whether to automatically download extensions matching this extension
+ point when updating or installing a 'related' application or runtime.
+ Available since 0.6.7.
+ </p></dd><dt><span class="term"><code class="option">locale-subset</code> (boolean)</span></dt><dd><p>
+ If set, then the extensions are partially downloaded by default,
+ based on the currently configured locales. This means that the extension
+ contents should be a set of directories with the language code as name.
+ Available since 0.9.13 (and 0.6.6 for any extensions called *.Locale)
</p></dd><dt><span class="term"><code class="option">autodelete</code> (boolean)</span></dt><dd><p>
- Whether to automatically delete this extension
- when deleting a 'related' application or runtime.
- </p></dd></dl></div></div></div><div class="refsect1"><a id="idm45148823280272"></a><h2>Example</h2><pre class="programlisting">
+ Whether to automatically delete extensions matching this extension
+ point when deleting a 'related' application or runtime.
+ Available since 0.6.7.
+ </p></dd></dl></div></div><div class="refsect2"><a id="idm140021655835216"></a><h3>[ExtensionOf]</h3><p>
+ This optional group may be present if the runtime is an extension.
+ </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">ref</code> (string)</span></dt><dd><p>
+ The ref of the runtime or application that this extension
+ belongs to. Available since 0.9.1.
+ </p></dd><dt><span class="term"><code class="option">priority</code> (integer)</span></dt><dd><p>
+ The priority to give this extension when looking for the
+ best match. Default is 0. Available since 0.9.1, and
+ backported to the 0.8.x branch in 0.8.3.
+ </p></dd></dl></div></div><div class="refsect2"><a id="idm140021655829456"></a><h3>[Extra Data]</h3><p>
+ This optional group may be present if the runtime or application uses
+ extra data that gets downloaded separately. The data in this group
+ gets merged into the repository summary, with the xa.extra-data-sources
+ key.
+ </p><p>
+ If multiple extra data sources are present, their uri, size and checksum
+ keys are grouped together by using the same suffix. If only one extra
+ data source is present, the suffix can be omitted.
+ </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">NoRuntime</code> (boolean)</span></dt><dd><p>
+ Whether to mount the runtime while running the /app/bin/apply_extra
+ script. Defaults to true, i.e. not mounting the runtime.
+ Available since 0.9.1, and backported to the 0.8.x
+ branch in 0.8.4.
+ </p></dd><dt><span class="term"><code class="option">uri<em class="replaceable"><code>X</code></em></code> (string)</span></dt><dd><p>
+ The uri for extra data source
+ <em class="replaceable"><code>X</code></em>. The only supported uri
+ schemes are http and https. Available since 0.6.13.
+ </p></dd><dt><span class="term"><code class="option">size<em class="replaceable"><code>X</code></em></code> (integer)</span></dt><dd><p>
+ The size for extra data source
+ <em class="replaceable"><code>X</code></em>. Available since 0.6.13.
+ </p></dd><dt><span class="term"><code class="option">checksum<em class="replaceable"><code>X</code></em></code> (string)</span></dt><dd><p>
+ The sha256 sum for extra data source
+ <em class="replaceable"><code>X</code></em>. Available since 0.6.13.
+ </p></dd></dl></div></div><div class="refsect2"><a id="idm140021655817552"></a><h3>[Policy SUBSYSTEM]</h3><p>
+ Subsystems can define their own policies to be placed in a group
+ whose name has this form. Their values are treated as lists,
+ in which items can have their meaning negated by prepending !
+ to the value. They are not otherwise parsed by Flatpak.
+ Available since 0.6.13.
+
+ </p></div></div><div class="refsect1"><a id="idm140021655815744"></a><h2>Example</h2><pre class="programlisting">
[Application]
name=org.gnome.Calculator
runtime=org.gnome.Platform/x86_64/3.20
@@ -1745,87 +2506,39 @@ subdirectories=true
[Extension org.gnome.Calculator.Debug]
directory=lib/debug
-</pre></div><div class="refsect1"><a id="idm45148823278192"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-run</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-override</span>(1)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-flatpakrepo"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-flatpakrepo — Reference to a remote</p></div><div class="refsect1"><a id="idm45148828811024"></a><h2>Description</h2><p>
- Flatpak uses flatpakrepo files to share information about remotes.
- The <code class="filename">flatpakrepo</code> file contains enough information
- to add the remote. Use the <span class="command"><strong>flatpak remote-add --from</strong></span>
- command to do so.
- </p><p>
- The filename extension commonly used for flatpakrepo files is <code class="filename">.flatpakrepo</code>.
- </p></div><div class="refsect1"><a id="idm45148824505792"></a><h2>File format</h2><p>
- The flatpakrepo file is using the same .ini file format that is used for
- systemd unit files or application .desktop files.
- </p><div class="refsect2"><a id="idm45148824688672"></a><h3>[Flatpak Repo]</h3><p>
- All the information is contained in the [Flatpak Repo] group.
- </p><p>
- The following keys can be present in this group:
- </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">Url</code> (string)</span></dt><dd><p>The url for the remote. This key is mandatory.</p></dd><dt><span class="term"><code class="option">Title</code> (string)</span></dt><dd><p>The title of the remote. This should be a user-friendly name that can be displayed e.g. in an app store.</p></dd><dt><span class="term"><code class="option">GPGKey</code> (string)</span></dt><dd><p>The base64-encoded gpg key for the remote.</p></dd></dl></div></div></div><div class="refsect1"><a id="idm45148824307056"></a><h2>Example</h2><pre class="programlisting">
-[Flatpak Repo]
-Title=GEdit
-Url=http://sdk.gnome.org/repo-apps/
-GPGKey=mQENBFUUCGcBCAC/K9WeV4xCaKr3NKRqPXeY5mpaXAJyasLqCtrDx92WUgbu0voWrhohNAKpqizod2dvzc/XTxm3rHyIxmNfdhz1gaGhynU75Qw4aJVcly2eghTIl++gfDtOvrOZo/VuAq30f32dMIgHQdRwEpgCwz7WyjpqZYltPAEcCNL4MTChAfiHJeeiQ5ibystNBW8W6Ymf7sO4m4g5+/aOxI54oCOzD9TwBAe+yXcJJWtc2rAhMCjtyPJzxd0ZVXqIzCe1xRvJ6Rq7YCiMbiM2DQFWXKnmYQbj4TGNMnwNdAajCdrcBWEMSbzq7EzuThIJRd8Ky4BkEe1St6tuqwFaMZz+F9eXABEBAAG0KEdub21lIFNESyAzLjE2IDxnbm9tZS1vcy1saXN0QGdub21lLm9yZz6JATgEEwECACIFAlUUCGcCGwMGCwkIBwMCBhUIAgkKCwQWAgMBAh4BAheAAAoJEArkz6VV0VKBa5cH/0vXa31YgEjNk78gGFXqnQxdD1WYA87OYxDi189l4lA802EFTF4wCBuZyDOqdd5BhS3Ab0cR778DmZXRUP2gwe+1zTJypU2JMnDpkwJ4NK1VP6/tE4SAPrznBtmb76BKaWBqUfZ9Wq1zg3ugvqkZB/Exq+usypIOwQVp1KL58TrjBRda0HvRctzkNhr0qYAtkfLFe0GvksBp4vBm8uGwAx7fw/HbhIjQ9pekTwvB+5GwDPO/tSip/1bQfCS+XJB8Ffa04HYPLGedalnWBrwhYY+G/kn5Zh9L/AC8xeLwTJTHM212rBjPa9CWs9C6a57MSaeGIEHLC1hEyiJJ15w8jmY=
-</pre></div><div class="refsect1"><a id="idm45148824304544"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-remote-add</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-flatpakref</span>(5)</span>
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-flatpakref"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-flatpakref — Reference to a remote for an application or runtime</p></div><div class="refsect1"><a id="idm45148824616640"></a><h2>Description</h2><p>
- Flatpak uses flatpakref files to share information about a remote for
- a single application. The <code class="filename">flatpakref</code> file contains
- enough information to add the remote and install the application.
- Use the <span class="command"><strong>flatpak install --from</strong></span> command to do so.
- </p><p>
- The filename extension commonly used for flatpakref files is <code class="filename">.flatpakref</code>.
- </p><p>
- A flatpakref file can also refer to a remote for a runtime.
- </p></div><div class="refsect1"><a id="idm45148825982128"></a><h2>File format</h2><p>
- The flatpakref file is using the same .ini file format that is used for
- systemd unit files or application .desktop files.
- </p><div class="refsect2"><a id="idm45148827776368"></a><h3>[Flatpak Ref]</h3><p>
- All the information is contained in the [Flatpak Ref] group.
+</pre></div><div class="refsect1"><a id="idm140021655814160"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-run"><span class="citerefentry"><span class="refentrytitle">flatpak-run</span>(1)</span></a>,
+ <a class="citerefentry" href="#flatpak-override"><span class="citerefentry"><span class="refentrytitle">flatpak-override</span>(1)</span></a>
+ </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote — Configuration for a remote</p></div><div class="refsect1"><a id="idm140021659644576"></a><h2>Description</h2><p>
+ Flatpak stores information about configured remotes for an installation location in
+ <code class="filename">$installation/repo/config</code>. For example, the remotes for the
+ default system-wide installation are in
+ <code class="filename">$prefix/var/lib/flatpak/repo/config</code>, and the remotes for the
+ per-user installation are in <code class="filename">$HOME/.local/share/flatpak/repo/config</code>.
+ </p><p>
+ Normally, it is not necessary to edit remote config files directly, the
+ flatpak remote-modify command should be used to change properties of remotes.
+ </p><p>
+ System-wide remotes can be statically preconfigured by dropping
+ config fragments into <code class="filename">/etc/flatpak/remotes.d/</code>.
+ </p></div><div class="refsect1"><a id="idm140021660511248"></a><h2>File format</h2><p>
+ The remote config file format is using the same .ini file format that is used for systemd
+ unit files or application .desktop files.
+ </p><div class="refsect2"><a id="idm140021658888240"></a><h3>[remote …]</h3><p>
+ All the configuration for the the remote with name NAME is contained in the
+ [remote "NAME"] group.
</p><p>
- The following keys can be present in this group:
- </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">Name</code> (string)</span></dt><dd><p>The fully qualified name of the runtime that is used by the application. This key is mandatory.</p></dd><dt><span class="term"><code class="option">Url</code> (string)</span></dt><dd><p>The url for the remote. This key is mandatory.</p></dd><dt><span class="term"><code class="option">Branch</code> (string)</span></dt><dd><p>The name of the branch from which to install the application or runtime. If this key is not specified, the "master" branch is used.</p></dd><dt><span class="term"><code class="option">Title</code> (string)</span></dt><dd><p>The title of the application or runtime. This should be a user-friendly name that can be displayed e.g. in an app store.</p></dd><dt><span class="term"><code class="option">IsRuntime</code> (boolean)</span></dt><dd><p>Whether this file refers to a runtime. If this key is not specified, the file is assumed to refer to an application.</p></dd><dt><span class="term"><code class="option">GPGKey</code> (string)</span></dt><dd><p>The base64-encoded gpg key for the remote.</p></dd></dl></div></div></div><div class="refsect1"><a id="idm45148824150144"></a><h2>Example</h2><pre class="programlisting">
-[Flatpak Ref]
-Title=GEdit
-Name=org.gnome.gedit
-Branch=stable
-Url=http://sdk.gnome.org/repo-apps/
-IsRuntime=False
-GPGKey=mQENBFUUCGcBCAC/K9WeV4xCaKr3NKRqPXeY5mpaXAJyasLqCtrDx92WUgbu0voWrhohNAKpqizod2dvzc/XTxm3rHyIxmNfdhz1gaGhynU75Qw4aJVcly2eghTIl++gfDtOvrOZo/VuAq30f32dMIgHQdRwEpgCwz7WyjpqZYltPAEcCNL4MTChAfiHJeeiQ5ibystNBW8W6Ymf7sO4m4g5+/aOxI54oCOzD9TwBAe+yXcJJWtc2rAhMCjtyPJzxd0ZVXqIzCe1xRvJ6Rq7YCiMbiM2DQFWXKnmYQbj4TGNMnwNdAajCdrcBWEMSbzq7EzuThIJRd8Ky4BkEe1St6tuqwFaMZz+F9eXABEBAAG0KEdub21lIFNESyAzLjE2IDxnbm9tZS1vcy1saXN0QGdub21lLm9yZz6JATgEEwECACIFAlUUCGcCGwMGCwkIBwMCBhUIAgkKCwQWAgMBAh4BAheAAAoJEArkz6VV0VKBa5cH/0vXa31YgEjNk78gGFXqnQxdD1WYA87OYxDi189l4lA802EFTF4wCBuZyDOqdd5BhS3Ab0cR778DmZXRUP2gwe+1zTJypU2JMnDpkwJ4NK1VP6/tE4SAPrznBtmb76BKaWBqUfZ9Wq1zg3ugvqkZB/Exq+usypIOwQVp1KL58TrjBRda0HvRctzkNhr0qYAtkfLFe0GvksBp4vBm8uGwAx7fw/HbhIjQ9pekTwvB+5GwDPO/tSip/1bQfCS+XJB8Ffa04HYPLGedalnWBrwhYY+G/kn5Zh9L/AC8xeLwTJTHM212rBjPa9CWs9C6a57MSaeGIEHLC1hEyiJJ15w8jmY=
-</pre></div><div class="refsect1"><a id="idm45148824147584"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span>
- <span class="citerefentry"><span class="refentrytitle">flatpak-flatpakrepo</span>(5)</span>,
- </p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-make-current"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-make-current — Make a specific version of an app current</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak make-current</code> [OPTION...] APP BRANCH </p></div></div><div class="refsect1"><a id="idm45148825640448"></a><h2>Description</h2><p>
- Makes a particular branch of an application current. Only the current branch
- of an app has its exported files (such as desktop files and icons) made visible
- to the host.
- </p><p>
- When a new branch is installed it will automatically be made current, so this
- command is often not needed.
- </p><p>
- Unless overridden with the --user option, this command creates a
- system-wide installation.
- </p></div><div class="refsect1"><a id="idm45148824683936"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
- Show help options and exit.
- </p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
- Create a per-user installation.
- </p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
- Create a system-wide installation.
- </p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
- The architecture to install for.
- </p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
- Print debug information during command processing.
- </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
- Print version information and exit.
- </p></dd></dl></div></div><div class="refsect1"><a id="idm45148824245936"></a><h2>Examples</h2><p>
- <span class="command"><strong>$ flatpak --user make-current org.gnome.GEdit 3.14</strong></span>
- </p></div><div class="refsect1"><a id="idm45148824243904"></a><h2>See also</h2><p>
- <span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span>,
- <span class="citerefentry"><span class="refentrytitle">flatpak-list</span>(1)</span>
- </p></div></div></div></body></html> \ No newline at end of file
+ The following keys are recognized by OSTree, among others:
+ </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">url</code> (string)</span></dt><dd><p>The url for the remote.</p></dd><dt><span class="term"><code class="option">gpg-verify</code> (boolean)</span></dt><dd><p>Whether to use GPG verification for content from this remote.</p></dd><dt><span class="term"><code class="option">gpg-verify-summary</code> (boolean)</span></dt><dd><p>Whether to use GPG verification for the summary of this remote.</p></dd></dl></div><p>
+ All flatpak-specific keys have a xa. prefix:
+ </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">xa.disable</code> (boolean)</span></dt><dd><p>Whether the remote is disabled. Defaults to false.</p></dd><dt><span class="term"><code class="option">xa.prio</code> (integer)</span></dt><dd><p>The priority for the remote. This is used when listing remotes. Defaults to 1.</p></dd><dt><span class="term"><code class="option">xa.noenumerate</code> (boolean)</span></dt><dd><p>Whether this remote should be used when presenting available contents. Defaults to true.</p></dd><dt><span class="term"><code class="option">xa.nodeps</code> (boolean)</span></dt><dd><p>Whether this remote should be used when searching for dependencies. Defaults to true.</p></dd><dt><span class="term"><code class="option">xa.title</code> (string)</span></dt><dd><p>An optional title to use when presenting this remote in a UI.</p></dd><dt><span class="term"><code class="option">xa.title-is-set</code> (boolean)</span></dt><dd><p>This key is set to true if <code class="option">xa.title</code> has been explicitly set.</p></dd><dt><span class="term"><code class="option">xa.default-branch</code> (string)</span></dt><dd><p>The default branch to use when installing from this remote.</p></dd><dt><span class="term"><code class="option">xa.default-branch-is-set</code> (boolean)</span></dt><dd><p>This key is set to true if <code class="option">xa.default-branch</code> has been explicitly set.</p></dd><dt><span class="term"><code class="option">xa.main-ref</code> (string)</span></dt><dd><p>The main reference served by this remote. This is used for origin remotes of applications installed via a flatpakref file.</p></dd><dt><span class="term"><code class="option">xa.oci</code> (boolean)</span></dt><dd><p>Whether this is an OCI remote. Defaults to false.</p></dd></dl></div></div></div><div class="refsect1"><a id="idm140021657038848"></a><h2>Examples</h2><pre class="programlisting">
+[remote "gnome-nightly-apps"]
+gpg-verify=true
+gpg-verify-summary=true
+
+url=https://sdk.gnome.org/nightly/repo-apps/
+xa.title=GNOME Applications
+</pre></div><div class="refsect1"><a id="idm140021655306016"></a><h2>See also</h2><p>
+ <a class="citerefentry" href="#flatpak-remote-modify"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-modify</span>(1)</span></a>
+ </p></div></div></div></div></body></html> \ No newline at end of file
diff --git a/reference/html/FlatpakInstallation.html b/reference/html/FlatpakInstallation.html
index 7f5623c9..0d1ed6c0 100644
--- a/reference/html/FlatpakInstallation.html
+++ b/reference/html/FlatpakInstallation.html
@@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>FlatpakInstallation: Flatpak Library Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Flatpak Library Reference Manual">
<link rel="up" href="ch01.html" title="Flatpak">
<link rel="prev" href="ch01.html" title="Flatpak">
<link rel="next" href="FlatpakRef.html" title="FlatpakRef">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -34,7 +34,7 @@
</tr></table></div>
<div class="refsect1">
<a name="FlatpakInstallation.functions"></a><h2>Functions</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
@@ -53,6 +53,14 @@
<a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="returnvalue">FlatpakInstallation</span></a> *
</td>
<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-new-system-with-id" title="flatpak_installation_new_system_with_id ()">flatpak_installation_new_system_with_id</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="returnvalue">FlatpakInstallation</span></a> *
+</td>
+<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-new-user" title="flatpak_installation_new_user ()">flatpak_installation_new_user</a> <span class="c_punctuation">()</span>
</td>
</tr>
@@ -66,7 +74,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-is-user" title="flatpak_installation_get_is_user ()">flatpak_installation_get_is_user</a> <span class="c_punctuation">()</span>
@@ -74,7 +82,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
+<span class="returnvalue">GFile</span> *
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-path" title="flatpak_installation_get_path ()">flatpak_installation_get_path</a> <span class="c_punctuation">()</span>
@@ -82,7 +90,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../gio/GFileMonitor.html#GFileMonitor-struct"><span class="returnvalue">GFileMonitor</span></a> *
+<span class="returnvalue">GFileMonitor</span> *
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-create-monitor" title="flatpak_installation_create_monitor ()">flatpak_installation_create_monitor</a> <span class="c_punctuation">()</span>
@@ -101,12 +109,28 @@
<a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="returnvalue">FlatpakInstalledRef</span></a> *
</td>
<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-install-full" title="flatpak_installation_install_full ()">flatpak_installation_install_full</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="returnvalue">FlatpakInstalledRef</span></a> *
+</td>
+<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-update" title="flatpak_installation_update ()">flatpak_installation_update</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="returnvalue">FlatpakInstalledRef</span></a> *
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-update-full" title="flatpak_installation_update_full ()">flatpak_installation_update_full</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-uninstall" title="flatpak_installation_uninstall ()">flatpak_installation_uninstall</a> <span class="c_punctuation">()</span>
@@ -114,7 +138,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-launch" title="flatpak_installation_launch ()">flatpak_installation_launch</a> <span class="c_punctuation">()</span>
@@ -129,6 +153,20 @@
</td>
</tr>
<tr>
+<td class="function_type">const <span class="returnvalue">char</span> *
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-display-name" title="flatpak_installation_get_display_name ()">flatpak_installation_get_display_name</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">const <span class="returnvalue">char</span> *
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-id" title="flatpak_installation_get_id ()">flatpak_installation_get_id</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
<td class="function_type">
<a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="returnvalue">FlatpakInstalledRef</span></a> *
</td>
@@ -138,7 +176,23 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
+<span class="returnvalue">gint</span>
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-priority" title="flatpak_installation_get_priority ()">flatpak_installation_get_priority</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a class="link" href="FlatpakInstallation.html#FlatpakStorageType" title="enum FlatpakStorageType"><span class="returnvalue">FlatpakStorageType</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-storage-type" title="flatpak_installation_get_storage_type ()">flatpak_installation_get_storage_type</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">GPtrArray</span> *
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-list-installed-refs" title="flatpak_installation_list_installed_refs ()">flatpak_installation_list_installed_refs</a> <span class="c_punctuation">()</span>
@@ -146,7 +200,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
+<span class="returnvalue">GPtrArray</span> *
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-list-installed-refs-by-kind" title="flatpak_installation_list_installed_refs_by_kind ()">flatpak_installation_list_installed_refs_by_kind</a> <span class="c_punctuation">()</span>
@@ -154,7 +208,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
+<span class="returnvalue">GPtrArray</span> *
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-list-installed-refs-for-update" title="flatpak_installation_list_installed_refs_for_update ()">flatpak_installation_list_installed_refs_for_update</a> <span class="c_punctuation">()</span>
@@ -162,7 +216,15 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
+<span class="returnvalue">GPtrArray</span> *
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-list-installed-related-refs-sync" title="flatpak_installation_list_installed_related_refs_sync ()">flatpak_installation_list_installed_related_refs_sync</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">GPtrArray</span> *
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-list-remote-refs-sync" title="flatpak_installation_list_remote_refs_sync ()">flatpak_installation_list_remote_refs_sync</a> <span class="c_punctuation">()</span>
@@ -170,7 +232,15 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
+<span class="returnvalue">GPtrArray</span> *
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-list-remote-related-refs-sync" title="flatpak_installation_list_remote_related_refs_sync ()">flatpak_installation_list_remote_related_refs_sync</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">GPtrArray</span> *
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-list-remotes" title="flatpak_installation_list_remotes ()">flatpak_installation_list_remotes</a> <span class="c_punctuation">()</span>
@@ -186,7 +256,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> *
+<span class="returnvalue">GBytes</span> *
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-fetch-remote-metadata-sync" title="flatpak_installation_fetch_remote_metadata_sync ()">flatpak_installation_fetch_remote_metadata_sync</a> <span class="c_punctuation">()</span>
@@ -202,7 +272,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-fetch-remote-size-sync" title="flatpak_installation_fetch_remote_size_sync ()">flatpak_installation_fetch_remote_size_sync</a> <span class="c_punctuation">()</span>
@@ -218,7 +288,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-update-appstream-sync" title="flatpak_installation_update_appstream_sync ()">flatpak_installation_update_appstream_sync</a> <span class="c_punctuation">()</span>
@@ -234,7 +304,15 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<a class="link" href="FlatpakRemoteRef.html" title="FlatpakRemoteRef"><span class="returnvalue">FlatpakRemoteRef</span></a> *
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-install-ref-file" title="flatpak_installation_install_ref_file ()">flatpak_installation_install_ref_file</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-drop-caches" title="flatpak_installation_drop_caches ()">flatpak_installation_drop_caches</a> <span class="c_punctuation">()</span>
@@ -242,7 +320,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-modify-remote" title="flatpak_installation_modify_remote ()">flatpak_installation_modify_remote</a> <span class="c_punctuation">()</span>
@@ -250,7 +328,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-remove-remote" title="flatpak_installation_remove_remote ()">flatpak_installation_remove_remote</a> <span class="c_punctuation">()</span>
@@ -258,13 +336,61 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="FlatpakInstallation.html#flatpak-installation-update-remote-sync" title="flatpak_installation_update_remote_sync ()">flatpak_installation_update_remote_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-cleanup-local-refs-sync" title="flatpak_installation_cleanup_local_refs_sync ()">flatpak_installation_cleanup_local_refs_sync</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">char</span> *
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-config" title="flatpak_installation_get_config ()">flatpak_installation_get_config</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-prune-local-repo" title="flatpak_installation_prune_local_repo ()">flatpak_installation_prune_local_repo</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-remove-local-ref-sync" title="flatpak_installation_remove_local_ref_sync ()">flatpak_installation_remove_local_ref_sync</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-set-config-sync" title="flatpak_installation_set_config_sync ()">flatpak_installation_set_config_sync</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-update-appstream-full-sync" title="flatpak_installation_update_appstream_full_sync ()">flatpak_installation_update_appstream_full_sync</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
<td class="function_type">const <span class="returnvalue">char</span> *
</td>
<td class="function_name">
@@ -272,6 +398,21 @@
</td>
</tr>
<tr>
+<td class="function_type">const <span class="returnvalue">char</span> *const *
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-get-supported-arches" title="flatpak_get_supported_arches ()">flatpak_get_supported_arches</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">GPtrArray</span> *
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakInstallation.html#flatpak-get-system-installations" title="flatpak_get_system_installations ()">flatpak_get_system_installations</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
@@ -284,7 +425,7 @@
</div>
<div class="refsect1">
<a name="FlatpakInstallation.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
@@ -298,12 +439,20 @@
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="FlatpakInstallation.html#FlatpakUpdateFlags" title="enum FlatpakUpdateFlags">FlatpakUpdateFlags</a></td>
</tr>
+<tr>
+<td class="datatype_keyword">enum</td>
+<td class="function_name"><a class="link" href="FlatpakInstallation.html#FlatpakInstallFlags" title="enum FlatpakInstallFlags">FlatpakInstallFlags</a></td>
+</tr>
+<tr>
+<td class="datatype_keyword">enum</td>
+<td class="function_name"><a class="link" href="FlatpakInstallation.html#FlatpakStorageType" title="enum FlatpakStorageType">FlatpakStorageType</a></td>
+</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="FlatpakInstallation.object-hierarchy"></a><h2>Object Hierarchy</h2>
-<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
+<pre class="screen"> GObject
<span class="lineart">╰──</span> FlatpakInstallation
</pre>
</div>
@@ -323,12 +472,12 @@ uninstall applications and runtimes.</p>
<div class="refsect2">
<a name="flatpak-installation-new-system"></a><h3>flatpak_installation_new_system ()</h3>
<pre class="programlisting"><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="returnvalue">FlatpakInstallation</span></a> *
-flatpak_installation_new_system (<em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+flatpak_installation_new_system (<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Creates a new <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> for the system-wide installation.</p>
<div class="refsect3">
<a name="flatpak-installation-new-system.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -337,12 +486,12 @@ flatpak_installation_new_system (<em class="parameter"><code><a href="../gio/GCa
<tbody>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -350,20 +499,64 @@ flatpak_installation_new_system (<em class="parameter"><code><a href="../gio/GCa
</div>
<div class="refsect3">
<a name="flatpak-installation-new-system.returns"></a><h4>Returns</h4>
-<p> a new <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a>. </p>
+<p>a new <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a>. </p>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-installation-new-system-with-id"></a><h3>flatpak_installation_new_system_with_id ()</h3>
+<pre class="programlisting"><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="returnvalue">FlatpakInstallation</span></a> *
+flatpak_installation_new_system_with_id
+ (<em class="parameter"><code>const <span class="type">char</span> *id</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Creates a new <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> for the system-wide installation <em class="parameter"><code>id</code></em>
+.</p>
+<div class="refsect3">
+<a name="flatpak-installation-new-system-with-id.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>id</p></td>
+<td class="parameter_description"><p>the ID of the system-wide installation. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-new-system-with-id.returns"></a><h4>Returns</h4>
+<p>a new <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
+<p class="since">Since: 0.8</p>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installation-new-user"></a><h3>flatpak_installation_new_user ()</h3>
<pre class="programlisting"><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="returnvalue">FlatpakInstallation</span></a> *
-flatpak_installation_new_user (<em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+flatpak_installation_new_user (<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Creates a new <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> for the per-user installation.</p>
<div class="refsect3">
<a name="flatpak-installation-new-user.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -372,12 +565,12 @@ flatpak_installation_new_user (<em class="parameter"><code><a href="../gio/GCanc
<tbody>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -385,7 +578,7 @@ flatpak_installation_new_user (<em class="parameter"><code><a href="../gio/GCanc
</div>
<div class="refsect3">
<a name="flatpak-installation-new-user.returns"></a><h4>Returns</h4>
-<p> a new <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a>. </p>
+<p>a new <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
@@ -393,15 +586,15 @@ flatpak_installation_new_user (<em class="parameter"><code><a href="../gio/GCanc
<div class="refsect2">
<a name="flatpak-installation-new-for-path"></a><h3>flatpak_installation_new_for_path ()</h3>
<pre class="programlisting"><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="returnvalue">FlatpakInstallation</span></a> *
-flatpak_installation_new_for_path (<em class="parameter"><code><a href="../gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *path</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> user</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+flatpak_installation_new_for_path (<em class="parameter"><code><span class="type">GFile</span> *path</code></em>,
+ <em class="parameter"><code><span class="type">gboolean</span> user</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Creates a new <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> for the installation at the given <em class="parameter"><code>path</code></em>
.</p>
<div class="refsect3">
<a name="flatpak-installation-new-for-path.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -410,7 +603,7 @@ flatpak_installation_new_for_path (<em class="parameter"><code><a href="../gio/G
<tbody>
<tr>
<td class="parameter_name"><p>path</p></td>
-<td class="parameter_description"><p>a <a href="../gio/GFile.html#GFile-struct"><span class="type">GFile</span></a></p></td>
+<td class="parameter_description"><p>a <span class="type">GFile</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@@ -420,12 +613,12 @@ flatpak_installation_new_for_path (<em class="parameter"><code><a href="../gio/G
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -433,19 +626,19 @@ flatpak_installation_new_for_path (<em class="parameter"><code><a href="../gio/G
</div>
<div class="refsect3">
<a name="flatpak-installation-new-for-path.returns"></a><h4>Returns</h4>
-<p> a new <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a>. </p>
+<p>a new <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installation-get-is-user"></a><h3>flatpak_installation_get_is_user ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
flatpak_installation_get_is_user (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>);</pre>
<p>Returns whether the installation is for a user-specific location.</p>
<div class="refsect3">
<a name="flatpak-installation-get-is-user.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -460,20 +653,20 @@ flatpak_installation_get_is_user (<em class="parameter"><code><a class="link" hr
</div>
<div class="refsect3">
<a name="flatpak-installation-get-is-user.returns"></a><h4>Returns</h4>
-<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>self</code></em>
+<p> <code class="literal">TRUE</code> if <em class="parameter"><code>self</code></em>
is a per-user installation</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installation-get-path"></a><h3>flatpak_installation_get_path ()</h3>
-<pre class="programlisting"><a href="../gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
+<pre class="programlisting"><span class="returnvalue">GFile</span> *
flatpak_installation_get_path (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>);</pre>
<p>Returns the installation location for <em class="parameter"><code>self</code></em>
.</p>
<div class="refsect3">
<a name="flatpak-installation-get-path.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -488,23 +681,23 @@ flatpak_installation_get_path (<em class="parameter"><code><a class="link" href=
</div>
<div class="refsect3">
<a name="flatpak-installation-get-path.returns"></a><h4>Returns</h4>
-<p> an <a href="../gio/GFile.html#GFile-struct"><span class="type">GFile</span></a>. </p>
+<p>an <span class="type">GFile</span>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installation-create-monitor"></a><h3>flatpak_installation_create_monitor ()</h3>
-<pre class="programlisting"><a href="../gio/GFileMonitor.html#GFileMonitor-struct"><span class="returnvalue">GFileMonitor</span></a> *
+<pre class="programlisting"><span class="returnvalue">GFileMonitor</span> *
flatpak_installation_create_monitor (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Gets monitor object for the installation. The returned file monitor will
-emit the <a href="../gio/GFileMonitor.html#GFileMonitor-changed"><span class="type">“changed”</span></a> signal whenever an application or runtime
+emit the <span class="type">“changed”</span> signal whenever an application or runtime
was installed, uninstalled or updated.</p>
<div class="refsect3">
<a name="flatpak-installation-create-monitor.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -518,12 +711,12 @@ was installed, uninstalled or updated.</p>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -531,7 +724,7 @@ was installed, uninstalled or updated.</p>
</div>
<div class="refsect3">
<a name="flatpak-installation-create-monitor.returns"></a><h4>Returns</h4>
-<p> a new <a href="../gio/GFileMonitor.html#GFileMonitor-struct"><span class="type">GFileMonitor</span></a> instance, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
+<p>a new <span class="type">GFileMonitor</span> instance, or <code class="literal">NULL</code> on error. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
@@ -546,13 +739,20 @@ flatpak_installation_install (<em class="parameter"><code><a class="link" href="
<em class="parameter"><code>const <span class="type">char</span> *arch</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *branch</code></em>,
<em class="parameter"><code><a class="link" href="FlatpakInstallation.html#FlatpakProgressCallback" title="FlatpakProgressCallback ()"><span class="type">FlatpakProgressCallback</span></a> progress</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_data</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">gpointer</span> progress_data</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Install a new application or runtime.</p>
+<p>Note that this function was originally written to always return a
+<a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="type">FlatpakInstalledRef</span></a>. Since 0.9.13, passing
+FLATPAK_INSTALL_FLAGS_NO_DEPLOY will only pull refs into the local flatpak
+repository without deploying them, however this function will
+be unable to provide information on the installed ref, so
+FLATPAK_ERROR_ONLY_PULLED will be set and the caller must respond
+accordingly.</p>
<div class="refsect3">
<a name="flatpak-installation-install.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -581,33 +781,33 @@ flatpak_installation_install (<em class="parameter"><code><a class="link" href="
</tr>
<tr>
<td class="parameter_name"><p>arch</p></td>
-<td class="parameter_description"><p> which architecture to fetch (default: current architecture). </p></td>
+<td class="parameter_description"><p>which architecture to fetch (default: current architecture). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>branch</p></td>
-<td class="parameter_description"><p> which branch to fetch (default: 'master'). </p></td>
+<td class="parameter_description"><p>which branch to fetch (default: 'master'). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>progress</p></td>
-<td class="parameter_description"><p> progress callback. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
+<td class="parameter_description"><p>progress callback. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>progress_data</p></td>
<td class="parameter_description"><p>user data passed to <em class="parameter"><code>progress</code></em>
-</p></td>
-<td class="parameter_annotations"> </td>
+. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> progress][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -615,7 +815,110 @@ flatpak_installation_install (<em class="parameter"><code><a class="link" href="
</div>
<div class="refsect3">
<a name="flatpak-installation-install.returns"></a><h4>Returns</h4>
-<p> The ref for the newly installed app or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure. </p>
+<p>The ref for the newly installed app or <code class="literal">NULL</code> on failure. </p>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-installation-install-full"></a><h3>flatpak_installation_install_full ()</h3>
+<pre class="programlisting"><a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="returnvalue">FlatpakInstalledRef</span></a> *
+flatpak_installation_install_full (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
+ <em class="parameter"><code><a class="link" href="FlatpakInstallation.html#FlatpakInstallFlags" title="enum FlatpakInstallFlags"><span class="type">FlatpakInstallFlags</span></a> flags</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *remote_name</code></em>,
+ <em class="parameter"><code><a class="link" href="FlatpakRef.html#FlatpakRefKind" title="enum FlatpakRefKind"><span class="type">FlatpakRefKind</span></a> kind</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *arch</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *branch</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> * const *subpaths</code></em>,
+ <em class="parameter"><code><a class="link" href="FlatpakInstallation.html#FlatpakProgressCallback" title="FlatpakProgressCallback ()"><span class="type">FlatpakProgressCallback</span></a> progress</code></em>,
+ <em class="parameter"><code><span class="type">gpointer</span> progress_data</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Install a new application or runtime.</p>
+<p>Note that this function was originally written to always return a
+<a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="type">FlatpakInstalledRef</span></a>. Since 0.9.13, passing
+FLATPAK_INSTALL_FLAGS_NO_DEPLOY will only pull refs into the local flatpak
+repository without deploying them, however this function will
+be unable to provide information on the installed ref, so
+FLATPAK_ERROR_ONLY_PULLED will be set and the caller must respond
+accordingly.</p>
+<div class="refsect3">
+<a name="flatpak-installation-install-full.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>flags</p></td>
+<td class="parameter_description"><p>set of <a class="link" href="FlatpakInstallation.html#FlatpakInstallFlags" title="enum FlatpakInstallFlags"><span class="type">FlatpakInstallFlags</span></a> flag</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>remote_name</p></td>
+<td class="parameter_description"><p>name of the remote to use</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>kind</p></td>
+<td class="parameter_description"><p>what this ref contains (an <a class="link" href="FlatpakRef.html#FlatpakRefKind" title="enum FlatpakRefKind"><span class="type">FlatpakRefKind</span></a>)</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>name</p></td>
+<td class="parameter_description"><p>name of the app/runtime to fetch</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>arch</p></td>
+<td class="parameter_description"><p>which architecture to fetch (default: current architecture). </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>branch</p></td>
+<td class="parameter_description"><p>which branch to fetch (default: 'master'). </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>subpaths</p></td>
+<td class="parameter_description"><p>A list of subpaths to fetch, or <code class="literal">NULL</code> for everything. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>progress</p></td>
+<td class="parameter_description"><p>progress callback. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>progress_data</p></td>
+<td class="parameter_description"><p>user data passed to <em class="parameter"><code>progress</code></em>
+. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> progress][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-install-full.returns"></a><h4>Returns</h4>
+<p>The ref for the newly installed app or <code class="literal">NULL</code> on failure. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
@@ -630,13 +933,17 @@ flatpak_installation_update (<em class="parameter"><code><a class="link" href="F
<em class="parameter"><code>const <span class="type">char</span> *arch</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *branch</code></em>,
<em class="parameter"><code><a class="link" href="FlatpakInstallation.html#FlatpakProgressCallback" title="FlatpakProgressCallback ()"><span class="type">FlatpakProgressCallback</span></a> progress</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_data</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">gpointer</span> progress_data</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Update an application or runtime.</p>
+<p>If the specified package is not installed, then <a class="link" href="flatpak-Error-codes.html#FLATPAK-ERROR-NOT-INSTALLED:CAPS"><code class="literal">FLATPAK_ERROR_NOT_INSTALLED</code></a>
+will be thrown.</p>
+<p>If no updates could be found on the remote end and the package is
+already up to date, then <a class="link" href="flatpak-Error-codes.html#FLATPAK-ERROR-ALREADY-INSTALLED:CAPS"><code class="literal">FLATPAK_ERROR_ALREADY_INSTALLED</code></a> will be thrown.</p>
<div class="refsect3">
<a name="flatpak-installation-update.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -665,33 +972,33 @@ flatpak_installation_update (<em class="parameter"><code><a class="link" href="F
</tr>
<tr>
<td class="parameter_name"><p>arch</p></td>
-<td class="parameter_description"><p> architecture of the app or runtime to update (default: current architecture). </p></td>
+<td class="parameter_description"><p>architecture of the app or runtime to update (default: current architecture). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>branch</p></td>
-<td class="parameter_description"><p> name of the branch of the app or runtime to update (default: master). </p></td>
+<td class="parameter_description"><p>name of the branch of the app or runtime to update (default: master). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>progress</p></td>
-<td class="parameter_description"><p> the callback. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
+<td class="parameter_description"><p>the callback. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>progress_data</p></td>
<td class="parameter_description"><p>user data passed to <em class="parameter"><code>progress</code></em>
-</p></td>
-<td class="parameter_annotations"> </td>
+. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> progress][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -699,27 +1006,121 @@ flatpak_installation_update (<em class="parameter"><code><a class="link" href="F
</div>
<div class="refsect3">
<a name="flatpak-installation-update.returns"></a><h4>Returns</h4>
-<p> The ref for the newly updated app (or the same if no update) or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure. </p>
+<p>The ref for the newly updated app or <code class="literal">NULL</code> on failure. </p>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-installation-update-full"></a><h3>flatpak_installation_update_full ()</h3>
+<pre class="programlisting"><a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="returnvalue">FlatpakInstalledRef</span></a> *
+flatpak_installation_update_full (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
+ <em class="parameter"><code><a class="link" href="FlatpakInstallation.html#FlatpakUpdateFlags" title="enum FlatpakUpdateFlags"><span class="type">FlatpakUpdateFlags</span></a> flags</code></em>,
+ <em class="parameter"><code><a class="link" href="FlatpakRef.html#FlatpakRefKind" title="enum FlatpakRefKind"><span class="type">FlatpakRefKind</span></a> kind</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *arch</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *branch</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> * const *subpaths</code></em>,
+ <em class="parameter"><code><a class="link" href="FlatpakInstallation.html#FlatpakProgressCallback" title="FlatpakProgressCallback ()"><span class="type">FlatpakProgressCallback</span></a> progress</code></em>,
+ <em class="parameter"><code><span class="type">gpointer</span> progress_data</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Update an application or runtime.</p>
+<p>If the specified package is not installed, then <a class="link" href="flatpak-Error-codes.html#FLATPAK-ERROR-NOT-INSTALLED:CAPS"><code class="literal">FLATPAK_ERROR_NOT_INSTALLED</code></a>
+will be thrown.</p>
+<p>If no updates could be found on the remote end and the package is
+already up to date, then <a class="link" href="flatpak-Error-codes.html#FLATPAK-ERROR-ALREADY-INSTALLED:CAPS"><code class="literal">FLATPAK_ERROR_ALREADY_INSTALLED</code></a> will be thrown.</p>
+<div class="refsect3">
+<a name="flatpak-installation-update-full.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>flags</p></td>
+<td class="parameter_description"><p>set of <a class="link" href="FlatpakInstallation.html#FlatpakUpdateFlags" title="enum FlatpakUpdateFlags"><span class="type">FlatpakUpdateFlags</span></a> flag</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>kind</p></td>
+<td class="parameter_description"><p>whether this is an app or runtime</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>name</p></td>
+<td class="parameter_description"><p>name of the app or runtime to update</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>arch</p></td>
+<td class="parameter_description"><p>architecture of the app or runtime to update (default: current architecture). </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>branch</p></td>
+<td class="parameter_description"><p>name of the branch of the app or runtime to update (default: master). </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>subpaths</p></td>
+<td class="parameter_description"><p>A list of subpaths to fetch, or <code class="literal">NULL</code> for everything. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>progress</p></td>
+<td class="parameter_description"><p>the callback. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>progress_data</p></td>
+<td class="parameter_description"><p>user data passed to <em class="parameter"><code>progress</code></em>
+. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> progress][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-update-full.returns"></a><h4>Returns</h4>
+<p>The ref for the newly updated app or <code class="literal">NULL</code> on failure. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installation-uninstall"></a><h3>flatpak_installation_uninstall ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
flatpak_installation_uninstall (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="FlatpakRef.html#FlatpakRefKind" title="enum FlatpakRefKind"><span class="type">FlatpakRefKind</span></a> kind</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *arch</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *branch</code></em>,
<em class="parameter"><code><a class="link" href="FlatpakInstallation.html#FlatpakProgressCallback" title="FlatpakProgressCallback ()"><span class="type">FlatpakProgressCallback</span></a> progress</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_data</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">gpointer</span> progress_data</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Uninstall an application or runtime.</p>
<div class="refsect3">
<a name="flatpak-installation-uninstall.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -753,23 +1154,23 @@ flatpak_installation_uninstall (<em class="parameter"><code><a class="link" href
</tr>
<tr>
<td class="parameter_name"><p>progress</p></td>
-<td class="parameter_description"><p> the callback. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
+<td class="parameter_description"><p>the callback. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>progress_data</p></td>
<td class="parameter_description"><p>user data passed to <em class="parameter"><code>progress</code></em>
-</p></td>
-<td class="parameter_annotations"> </td>
+. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> progress][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -777,20 +1178,20 @@ flatpak_installation_uninstall (<em class="parameter"><code><a class="link" href
</div>
<div class="refsect3">
<a name="flatpak-installation-uninstall.returns"></a><h4>Returns</h4>
-<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success</p>
+<p> <code class="literal">TRUE</code> on success</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installation-launch"></a><h3>flatpak_installation_launch ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
flatpak_installation_launch (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *arch</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *branch</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *commit</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Launch an installed application.</p>
<p>You can use <a class="link" href="FlatpakInstallation.html#flatpak-installation-get-installed-ref" title="flatpak_installation_get_installed_ref ()"><code class="function">flatpak_installation_get_installed_ref()</code></a> or
<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-current-installed-app" title="flatpak_installation_get_current_installed_app ()"><code class="function">flatpak_installation_get_current_installed_app()</code></a> to find out what builds
@@ -798,7 +1199,7 @@ are available, in order to get a value for <em class="parameter"><code>commit</c
.</p>
<div class="refsect3">
<a name="flatpak-installation-launch.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -817,28 +1218,28 @@ are available, in order to get a value for <em class="parameter"><code>commit</c
</tr>
<tr>
<td class="parameter_name"><p>arch</p></td>
-<td class="parameter_description"><p> which architecture to launch (default: current architecture). </p></td>
+<td class="parameter_description"><p>which architecture to launch (default: current architecture). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>branch</p></td>
-<td class="parameter_description"><p> which branch of the application (default: "master"). </p></td>
+<td class="parameter_description"><p>which branch of the application (default: "master"). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>commit</p></td>
-<td class="parameter_description"><p> the commit of <em class="parameter"><code>branch</code></em>
+<td class="parameter_description"><p>the commit of <em class="parameter"><code>branch</code></em>
to launch. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -846,7 +1247,7 @@ to launch. </p></td>
</div>
<div class="refsect3">
<a name="flatpak-installation-launch.returns"></a><h4>Returns</h4>
-<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, unless an error occurred</p>
+<p> <code class="literal">TRUE</code>, unless an error occurred</p>
</div>
</div>
<hr>
@@ -856,15 +1257,15 @@ to launch. </p></td>
flatpak_installation_get_current_installed_app
(<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Get the last build of reference <em class="parameter"><code>name</code></em>
that was installed with
-<a class="link" href="FlatpakInstallation.html#flatpak-installation-install" title="flatpak_installation_install ()"><code class="function">flatpak_installation_install()</code></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the reference has
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-install" title="flatpak_installation_install ()"><code class="function">flatpak_installation_install()</code></a>, or <code class="literal">NULL</code> if the reference has
never been installed locally.</p>
<div class="refsect3">
<a name="flatpak-installation-get-current-installed-app.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -883,12 +1284,12 @@ never been installed locally.</p>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -896,12 +1297,70 @@ never been installed locally.</p>
</div>
<div class="refsect3">
<a name="flatpak-installation-get-current-installed-app.returns"></a><h4>Returns</h4>
-<p> an <a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="type">FlatpakInstalledRef</span></a>. </p>
+<p>an <a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="type">FlatpakInstalledRef</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
+<a name="flatpak-installation-get-display-name"></a><h3>flatpak_installation_get_display_name ()</h3>
+<pre class="programlisting">const <span class="returnvalue">char</span> *
+flatpak_installation_get_display_name (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>);</pre>
+<p>Returns the display name of the system installation for <em class="parameter"><code>self</code></em>
+.</p>
+<div class="refsect3">
+<a name="flatpak-installation-get-display-name.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-get-display-name.returns"></a><h4>Returns</h4>
+<p>a string with the installation's display name. </p>
+<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+</div>
+<p class="since">Since: 0.8</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-installation-get-id"></a><h3>flatpak_installation_get_id ()</h3>
+<pre class="programlisting">const <span class="returnvalue">char</span> *
+flatpak_installation_get_id (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>);</pre>
+<p>Returns the ID of the system installation for <em class="parameter"><code>self</code></em>
+.</p>
+<div class="refsect3">
+<a name="flatpak-installation-get-id.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-get-id.returns"></a><h4>Returns</h4>
+<p>a string with the installation's ID. </p>
+<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+</div>
+<p class="since">Since: 0.8</p>
+</div>
+<hr>
+<div class="refsect2">
<a name="flatpak-installation-get-installed-ref"></a><h3>flatpak_installation_get_installed_ref ()</h3>
<pre class="programlisting"><a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="returnvalue">FlatpakInstalledRef</span></a> *
flatpak_installation_get_installed_ref
@@ -910,13 +1369,13 @@ flatpak_installation_get_installed_ref
<em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *arch</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *branch</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Returns information about an installed ref, such as the available builds,
its size, location, etc.</p>
<div class="refsect3">
<a name="flatpak-installation-get-installed-ref.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -940,22 +1399,22 @@ its size, location, etc.</p>
</tr>
<tr>
<td class="parameter_name"><p>arch</p></td>
-<td class="parameter_description"><p> which architecture to fetch (default: current architecture). </p></td>
+<td class="parameter_description"><p>which architecture to fetch (default: current architecture). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>branch</p></td>
-<td class="parameter_description"><p> which branch to fetch (default: "master"). </p></td>
+<td class="parameter_description"><p>which branch to fetch (default: "master"). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -963,22 +1422,78 @@ its size, location, etc.</p>
</div>
<div class="refsect3">
<a name="flatpak-installation-get-installed-ref.returns"></a><h4>Returns</h4>
-<p> an <a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="type">FlatpakInstalledRef</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if an error occurred. </p>
+<p>an <a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="type">FlatpakInstalledRef</span></a>, or <code class="literal">NULL</code> if an error occurred. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
+<a name="flatpak-installation-get-priority"></a><h3>flatpak_installation_get_priority ()</h3>
+<pre class="programlisting"><span class="returnvalue">gint</span>
+flatpak_installation_get_priority (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>);</pre>
+<p>Returns the numeric priority of the system installation for <em class="parameter"><code>self</code></em>
+.</p>
+<div class="refsect3">
+<a name="flatpak-installation-get-priority.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-get-priority.returns"></a><h4>Returns</h4>
+<p> an integer with the configured priority value</p>
+</div>
+<p class="since">Since: 0.8</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-installation-get-storage-type"></a><h3>flatpak_installation_get_storage_type ()</h3>
+<pre class="programlisting"><a class="link" href="FlatpakInstallation.html#FlatpakStorageType" title="enum FlatpakStorageType"><span class="returnvalue">FlatpakStorageType</span></a>
+flatpak_installation_get_storage_type (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>);</pre>
+<p>Returns the type of storage of the system installation for <em class="parameter"><code>self</code></em>
+.</p>
+<div class="refsect3">
+<a name="flatpak-installation-get-storage-type.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-get-storage-type.returns"></a><h4>Returns</h4>
+<p> a <a class="link" href="FlatpakInstallation.html#FlatpakStorageType" title="enum FlatpakStorageType"><span class="type">FlatpakStorageType</span></a></p>
+</div>
+<p class="since">Since: 0.8</p>
+</div>
+<hr>
+<div class="refsect2">
<a name="flatpak-installation-list-installed-refs"></a><h3>flatpak_installation_list_installed_refs ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
+<pre class="programlisting"><span class="returnvalue">GPtrArray</span> *
flatpak_installation_list_installed_refs
(<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Lists the installed references.</p>
<div class="refsect3">
<a name="flatpak-installation-list-installed-refs.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -992,12 +1507,12 @@ flatpak_installation_list_installed_refs
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1005,7 +1520,7 @@ flatpak_installation_list_installed_refs
</div>
<div class="refsect3">
<a name="flatpak-installation-list-installed-refs.returns"></a><h4>Returns</h4>
-<p> an GPtrArray of
+<p>an GPtrArray of
<a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="type">FlatpakInstalledRef</span></a> instances. </p>
<p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> FlatpakInstalledRef]</span></p>
</div>
@@ -1013,16 +1528,16 @@ flatpak_installation_list_installed_refs
<hr>
<div class="refsect2">
<a name="flatpak-installation-list-installed-refs-by-kind"></a><h3>flatpak_installation_list_installed_refs_by_kind ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
+<pre class="programlisting"><span class="returnvalue">GPtrArray</span> *
flatpak_installation_list_installed_refs_by_kind
(<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="FlatpakRef.html#FlatpakRefKind" title="enum FlatpakRefKind"><span class="type">FlatpakRefKind</span></a> kind</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Lists the installed references of a specific kind.</p>
<div class="refsect3">
<a name="flatpak-installation-list-installed-refs-by-kind.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1041,12 +1556,12 @@ flatpak_installation_list_installed_refs_by_kind
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1054,7 +1569,7 @@ flatpak_installation_list_installed_refs_by_kind
</div>
<div class="refsect3">
<a name="flatpak-installation-list-installed-refs-by-kind.returns"></a><h4>Returns</h4>
-<p> an GPtrArray of
+<p>an GPtrArray of
<a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="type">FlatpakInstalledRef</span></a> instances. </p>
<p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> FlatpakInstalledRef]</span></p>
</div>
@@ -1062,18 +1577,18 @@ flatpak_installation_list_installed_refs_by_kind
<hr>
<div class="refsect2">
<a name="flatpak-installation-list-installed-refs-for-update"></a><h3>flatpak_installation_list_installed_refs_for_update ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
+<pre class="programlisting"><span class="returnvalue">GPtrArray</span> *
flatpak_installation_list_installed_refs_for_update
(<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Lists the installed references that has a remote update that is not
locally available. However, even though an app is not returned by this
it can have local updates available that has not been deployed. Look
at commit vs latest_commit on installed apps for this.</p>
<div class="refsect3">
<a name="flatpak-installation-list-installed-refs-for-update.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1087,12 +1602,12 @@ at commit vs latest_commit on installed apps for this.</p>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1100,24 +1615,91 @@ at commit vs latest_commit on installed apps for this.</p>
</div>
<div class="refsect3">
<a name="flatpak-installation-list-installed-refs-for-update.returns"></a><h4>Returns</h4>
-<p> an GPtrArray of
+<p>an GPtrArray of
<a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="type">FlatpakInstalledRef</span></a> instances. </p>
<p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> FlatpakInstalledRef]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
+<a name="flatpak-installation-list-installed-related-refs-sync"></a><h3>flatpak_installation_list_installed_related_refs_sync ()</h3>
+<pre class="programlisting"><span class="returnvalue">GPtrArray</span> *
+flatpak_installation_list_installed_related_refs_sync
+ (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *remote_name</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *ref</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Lists all the locally installed refs from <em class="parameter"><code>remote_name</code></em>
+ that are
+related to <em class="parameter"><code>ref</code></em>
+. These are things that are interesting to install,
+update, or uninstall together with <em class="parameter"><code>ref</code></em>
+. For instance, locale data
+or debug information.</p>
+<p>This function is similar to flatpak_installation_list_remote_related_refs_sync,
+but instead of looking at what is available on the remote, it only looks
+at the locally installed refs. This is useful for instance when you're
+looking for related refs to uninstall, or when you're planning to use
+FLATPAK_UPDATE_FLAGS_NO_PULL to install previously pulled refs.</p>
+<div class="refsect3">
+<a name="flatpak-installation-list-installed-related-refs-sync.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>remote_name</p></td>
+<td class="parameter_description"><p>the name of the remote</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>ref</p></td>
+<td class="parameter_description"><p>the ref</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-list-installed-related-refs-sync.returns"></a><h4>Returns</h4>
+<p>an GPtrArray of
+<a class="link" href="FlatpakRelatedRef.html" title="FlatpakRelatedRef"><span class="type">FlatpakRelatedRef</span></a> instances. </p>
+<p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> FlatpakRelatedRef]</span></p>
+</div>
+<p class="since">Since: 0.6.7</p>
+</div>
+<hr>
+<div class="refsect2">
<a name="flatpak-installation-list-remote-refs-sync"></a><h3>flatpak_installation_list_remote_refs_sync ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
+<pre class="programlisting"><span class="returnvalue">GPtrArray</span> *
flatpak_installation_list_remote_refs_sync
(<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *remote_name</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Lists all the applications and runtimes in a remote.</p>
<div class="refsect3">
<a name="flatpak-installation-list-remote-refs-sync.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1136,12 +1718,12 @@ flatpak_installation_list_remote_refs_sync
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1149,23 +1731,91 @@ flatpak_installation_list_remote_refs_sync
</div>
<div class="refsect3">
<a name="flatpak-installation-list-remote-refs-sync.returns"></a><h4>Returns</h4>
-<p> an GPtrArray of
+<p>an GPtrArray of
<a class="link" href="FlatpakRemoteRef.html" title="FlatpakRemoteRef"><span class="type">FlatpakRemoteRef</span></a> instances. </p>
<p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> FlatpakRemoteRef]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
+<a name="flatpak-installation-list-remote-related-refs-sync"></a><h3>flatpak_installation_list_remote_related_refs_sync ()</h3>
+<pre class="programlisting"><span class="returnvalue">GPtrArray</span> *
+flatpak_installation_list_remote_related_refs_sync
+ (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *remote_name</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *ref</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Lists all the available refs on <em class="parameter"><code>remote_name</code></em>
+ that are related to
+<em class="parameter"><code>ref</code></em>
+, and the subpaths to use. These are things that are
+interesting to install, update, or uninstall together with
+<em class="parameter"><code>ref</code></em>
+. For instance, locale data or debug information.</p>
+<p>The returned list contains all available related refs, but not
+everyone should always be installed. For example,
+<a class="link" href="FlatpakRelatedRef.html#flatpak-related-ref-should-download" title="flatpak_related_ref_should_download ()"><code class="function">flatpak_related_ref_should_download()</code></a> returns TRUE if the
+reference should be installed/updated with the app, and
+<a class="link" href="FlatpakRelatedRef.html#flatpak-related-ref-should-delete" title="flatpak_related_ref_should_delete ()"><code class="function">flatpak_related_ref_should_delete()</code></a> returns TRUE if it
+should be uninstalled with the main ref.</p>
+<div class="refsect3">
+<a name="flatpak-installation-list-remote-related-refs-sync.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>remote_name</p></td>
+<td class="parameter_description"><p>the name of the remote</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>ref</p></td>
+<td class="parameter_description"><p>the ref</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-list-remote-related-refs-sync.returns"></a><h4>Returns</h4>
+<p>an GPtrArray of
+<a class="link" href="FlatpakRelatedRef.html" title="FlatpakRelatedRef"><span class="type">FlatpakRelatedRef</span></a> instances. </p>
+<p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> FlatpakRelatedRef]</span></p>
+</div>
+<p class="since">Since: 0.6.7</p>
+</div>
+<hr>
+<div class="refsect2">
<a name="flatpak-installation-list-remotes"></a><h3>flatpak_installation_list_remotes ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
+<pre class="programlisting"><span class="returnvalue">GPtrArray</span> *
flatpak_installation_list_remotes (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Lists the remotes, in priority (highest first) order. For same priority,
an earlier added remote comes before a later added one.</p>
<div class="refsect3">
<a name="flatpak-installation-list-remotes.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1179,12 +1829,12 @@ an earlier added remote comes before a later added one.</p>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1192,7 +1842,7 @@ an earlier added remote comes before a later added one.</p>
</div>
<div class="refsect3">
<a name="flatpak-installation-list-remotes.returns"></a><h4>Returns</h4>
-<p> an GPtrArray of
+<p>an GPtrArray of
<a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> instances. </p>
<p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> FlatpakRemote]</span></p>
</div>
@@ -1203,13 +1853,13 @@ an earlier added remote comes before a later added one.</p>
<pre class="programlisting"><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="returnvalue">FlatpakRemote</span></a> *
flatpak_installation_get_remote_by_name
(<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
- <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Looks up a remote by name.</p>
<div class="refsect3">
<a name="flatpak-installation-get-remote-by-name.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1228,12 +1878,12 @@ flatpak_installation_get_remote_by_name
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1241,24 +1891,24 @@ flatpak_installation_get_remote_by_name
</div>
<div class="refsect3">
<a name="flatpak-installation-get-remote-by-name.returns"></a><h4>Returns</h4>
-<p> a <a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> instances, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> error. </p>
+<p>a <a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> instances, or <code class="literal">NULL</code> error. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installation-fetch-remote-metadata-sync"></a><h3>flatpak_installation_fetch_remote_metadata_sync ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> *
+<pre class="programlisting"><span class="returnvalue">GBytes</span> *
flatpak_installation_fetch_remote_metadata_sync
(<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *remote_name</code></em>,
<em class="parameter"><code><a class="link" href="FlatpakRef.html" title="FlatpakRef"><span class="type">FlatpakRef</span></a> *ref</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Obtains the metadata file from a commit.</p>
<div class="refsect3">
<a name="flatpak-installation-fetch-remote-metadata-sync.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1282,12 +1932,12 @@ flatpak_installation_fetch_remote_metadata_sync
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1295,8 +1945,8 @@ flatpak_installation_fetch_remote_metadata_sync
</div>
<div class="refsect3">
<a name="flatpak-installation-fetch-remote-metadata-sync.returns"></a><h4>Returns</h4>
-<p> a <a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> containing the flatpak metadata file,
-or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if an error occurred. </p>
+<p>a <span class="type">GBytes</span> containing the flatpak metadata file,
+or <code class="literal">NULL</code> if an error occurred. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
@@ -1311,12 +1961,12 @@ flatpak_installation_fetch_remote_ref_sync
<em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *arch</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *branch</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Gets the current remote branch of a ref in the remote.</p>
<div class="refsect3">
<a name="flatpak-installation-fetch-remote-ref-sync.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1345,22 +1995,22 @@ flatpak_installation_fetch_remote_ref_sync
</tr>
<tr>
<td class="parameter_name"><p>arch</p></td>
-<td class="parameter_description"><p> which architecture to fetch (default: current architecture). </p></td>
+<td class="parameter_description"><p>which architecture to fetch (default: current architecture). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>branch</p></td>
-<td class="parameter_description"><p> which branch to fetch (default: 'master'). </p></td>
+<td class="parameter_description"><p>which branch to fetch (default: 'master'). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1368,22 +2018,22 @@ flatpak_installation_fetch_remote_ref_sync
</div>
<div class="refsect3">
<a name="flatpak-installation-fetch-remote-ref-sync.returns"></a><h4>Returns</h4>
-<p> a <a class="link" href="FlatpakRemoteRef.html" title="FlatpakRemoteRef"><span class="type">FlatpakRemoteRef</span></a> instance, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
+<p>a <a class="link" href="FlatpakRemoteRef.html" title="FlatpakRemoteRef"><span class="type">FlatpakRemoteRef</span></a> instance, or <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installation-fetch-remote-size-sync"></a><h3>flatpak_installation_fetch_remote_size_sync ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
flatpak_installation_fetch_remote_size_sync
(<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *remote_name</code></em>,
<em class="parameter"><code><a class="link" href="FlatpakRef.html" title="FlatpakRef"><span class="type">FlatpakRef</span></a> *ref</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a> *download_size</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a> *installed_size</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">guint64</span> *download_size</code></em>,
+ <em class="parameter"><code><span class="type">guint64</span> *installed_size</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Gets information about the maximum amount of data that needs to be transferred
to pull the ref from a remote repository, and about the amount of
local disk space that is required to check out this commit.</p>
@@ -1392,7 +2042,7 @@ for instance if you're doing an update then the real download size may be smalle
than what is returned here.</p>
<div class="refsect3">
<a name="flatpak-installation-fetch-remote-size-sync.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1416,22 +2066,22 @@ than what is returned here.</p>
</tr>
<tr>
<td class="parameter_name"><p>download_size</p></td>
-<td class="parameter_description"><p> return location for the (maximum) download size. </p></td>
+<td class="parameter_description"><p>return location for the (maximum) download size. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>installed_size</p></td>
-<td class="parameter_description"><p> return location for the installed size. </p></td>
+<td class="parameter_description"><p>return location for the installed size. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1439,7 +2089,7 @@ than what is returned here.</p>
</div>
<div class="refsect3">
<a name="flatpak-installation-fetch-remote-size-sync.returns"></a><h4>Returns</h4>
-<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, unless an error occurred</p>
+<p> <code class="literal">TRUE</code>, unless an error occurred</p>
</div>
</div>
<hr>
@@ -1449,12 +2099,12 @@ than what is returned here.</p>
flatpak_installation_load_app_overrides
(<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *app_id</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Loads the metadata overrides file for an application.</p>
<div class="refsect3">
<a name="flatpak-installation-load-app-overrides.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1473,12 +2123,12 @@ flatpak_installation_load_app_overrides
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1486,28 +2136,29 @@ flatpak_installation_load_app_overrides
</div>
<div class="refsect3">
<a name="flatpak-installation-load-app-overrides.returns"></a><h4>Returns</h4>
-<p> the contents of the overrides files,
-or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if an error occurred. </p>
+<p>the contents of the overrides files,
+or <code class="literal">NULL</code> if an error occurred. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installation-update-appstream-sync"></a><h3>flatpak_installation_update_appstream_sync ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
flatpak_installation_update_appstream_sync
(<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *remote_name</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *arch</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *out_changed</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">gboolean</span> *out_changed</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Updates the local copy of appstream for <em class="parameter"><code>remote_name</code></em>
for the specified <em class="parameter"><code>arch</code></em>
-.</p>
+.
+If you need progress feedback, use <a class="link" href="FlatpakInstallation.html#flatpak-installation-update-appstream-full-sync" title="flatpak_installation_update_appstream_full_sync ()"><code class="function">flatpak_installation_update_appstream_full_sync()</code></a>.</p>
<div class="refsect3">
<a name="flatpak-installation-update-appstream-sync.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1526,22 +2177,22 @@ flatpak_installation_update_appstream_sync
</tr>
<tr>
<td class="parameter_name"><p>arch</p></td>
-<td class="parameter_description"><p>Architecture to update, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the local machine arch</p></td>
+<td class="parameter_description"><p>Architecture to update, or <code class="literal">NULL</code> for the local machine arch</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>out_changed</p></td>
-<td class="parameter_description"><p> Set to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the contents of the appstream changed, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if nothing changed. </p></td>
+<td class="parameter_description"><p>Set to <code class="literal">TRUE</code> if the contents of the appstream changed, <code class="literal">FALSE</code> if nothing changed. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1549,7 +2200,7 @@ flatpak_installation_update_appstream_sync
</div>
<div class="refsect3">
<a name="flatpak-installation-update-appstream-sync.returns"></a><h4>Returns</h4>
-<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, or <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error</p>
+<p> <code class="literal">TRUE</code> on success, or <code class="literal">FALSE</code> on error</p>
</div>
</div>
<hr>
@@ -1557,16 +2208,16 @@ flatpak_installation_update_appstream_sync
<a name="flatpak-installation-install-bundle"></a><h3>flatpak_installation_install_bundle ()</h3>
<pre class="programlisting"><a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="returnvalue">FlatpakInstalledRef</span></a> *
flatpak_installation_install_bundle (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
- <em class="parameter"><code><a href="../gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *file</code></em>,
+ <em class="parameter"><code><span class="type">GFile</span> *file</code></em>,
<em class="parameter"><code><a class="link" href="FlatpakInstallation.html#FlatpakProgressCallback" title="FlatpakProgressCallback ()"><span class="type">FlatpakProgressCallback</span></a> progress</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_data</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">gpointer</span> progress_data</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Install an application or runtime from an flatpak bundle file.
-See flatpak-build-bundle(1) for how to create brundles.</p>
+See flatpak-build-bundle(1) for how to create bundles.</p>
<div class="refsect3">
<a name="flatpak-installation-install-bundle.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1580,28 +2231,28 @@ See flatpak-build-bundle(1) for how to create brundles.</p>
</tr>
<tr>
<td class="parameter_name"><p>file</p></td>
-<td class="parameter_description"><p>a <a href="../gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> that is an flatpak bundle</p></td>
+<td class="parameter_description"><p>a <span class="type">GFile</span> that is an flatpak bundle</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>progress</p></td>
-<td class="parameter_description"><p> progress callback. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
+<td class="parameter_description"><p>progress callback. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>progress_data</p></td>
<td class="parameter_description"><p>user data passed to <em class="parameter"><code>progress</code></em>
-</p></td>
-<td class="parameter_annotations"> </td>
+. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> progress][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1609,22 +2260,77 @@ See flatpak-build-bundle(1) for how to create brundles.</p>
</div>
<div class="refsect3">
<a name="flatpak-installation-install-bundle.returns"></a><h4>Returns</h4>
-<p> The ref for the newly installed app or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure. </p>
+<p>The ref for the newly installed app or <code class="literal">NULL</code> on failure. </p>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-installation-install-ref-file"></a><h3>flatpak_installation_install_ref_file ()</h3>
+<pre class="programlisting"><a class="link" href="FlatpakRemoteRef.html" title="FlatpakRemoteRef"><span class="returnvalue">FlatpakRemoteRef</span></a> *
+flatpak_installation_install_ref_file (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
+ <em class="parameter"><code><span class="type">GBytes</span> *ref_file_data</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Creates a remote based on the passed in .flatpakref file contents
+in <em class="parameter"><code>ref_file_data</code></em>
+ and returns the <a class="link" href="FlatpakRemoteRef.html" title="FlatpakRemoteRef"><span class="type">FlatpakRemoteRef</span></a> that can be used
+to install it.</p>
+<p>Note, the <a class="link" href="FlatpakRemoteRef.html" title="FlatpakRemoteRef"><span class="type">FlatpakRemoteRef</span></a> will not have the commit field set, to
+avoid unnecessary roundtrips. If you need that you have to resolve it
+explicitly with <a class="link" href="FlatpakInstallation.html#flatpak-installation-fetch-remote-ref-sync" title="flatpak_installation_fetch_remote_ref_sync ()"><code class="function">flatpak_installation_fetch_remote_ref_sync()</code></a>.</p>
+<div class="refsect3">
+<a name="flatpak-installation-install-ref-file.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>ref_file_data</p></td>
+<td class="parameter_description"><p>The ref file contents</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-install-ref-file.returns"></a><h4>Returns</h4>
+<p>a <a class="link" href="FlatpakRemoteRef.html" title="FlatpakRemoteRef"><span class="type">FlatpakRemoteRef</span></a> if the remote has been added successfully, <code class="literal">NULL</code>
+on error. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
+<p class="since">Since: 0.6.10</p>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installation-drop-caches"></a><h3>flatpak_installation_drop_caches ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
flatpak_installation_drop_caches (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Drops all internal (in-memory) caches. For instance, this may be needed to pick up new or changed
remotes configured outside this installation instance.</p>
<div class="refsect3">
<a name="flatpak-installation-drop-caches.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1638,12 +2344,12 @@ remotes configured outside this installation instance.</p>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1651,22 +2357,22 @@ remotes configured outside this installation instance.</p>
</div>
<div class="refsect3">
<a name="flatpak-installation-drop-caches.returns"></a><h4>Returns</h4>
-<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error</p>
+<p> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> on error</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installation-modify-remote"></a><h3>flatpak_installation_modify_remote ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
flatpak_installation_modify_remote (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *remote</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Saves changes in the <em class="parameter"><code>remote</code></em>
object.</p>
<div class="refsect3">
<a name="flatpak-installation-modify-remote.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1685,12 +2391,12 @@ flatpak_installation_modify_remote (<em class="parameter"><code><a class="link"
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1698,21 +2404,21 @@ flatpak_installation_modify_remote (<em class="parameter"><code><a class="link"
</div>
<div class="refsect3">
<a name="flatpak-installation-modify-remote.returns"></a><h4>Returns</h4>
-<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the modifications have been committed successfully</p>
+<p> <code class="literal">TRUE</code> if the modifications have been committed successfully</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installation-remove-remote"></a><h3>flatpak_installation_remove_remote ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
flatpak_installation_remove_remote (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Removes the remote with the given name from the installation.</p>
<div class="refsect3">
<a name="flatpak-installation-remove-remote.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1731,12 +2437,12 @@ flatpak_installation_remove_remote (<em class="parameter"><code><a class="link"
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1744,24 +2450,24 @@ flatpak_installation_remove_remote (<em class="parameter"><code><a class="link"
</div>
<div class="refsect3">
<a name="flatpak-installation-remove-remote.returns"></a><h4>Returns</h4>
-<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the remote has been removed successfully</p>
+<p> <code class="literal">TRUE</code> if the remote has been removed successfully</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installation-update-remote-sync"></a><h3>flatpak_installation_update_remote_sync ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
flatpak_installation_update_remote_sync
(<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Updates the local configuration of a remote repository by fetching
the related information from the summary file in the remote OSTree
repository and committing the changes to the local installation.</p>
<div class="refsect3">
<a name="flatpak-installation-update-remote-sync.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1780,12 +2486,12 @@ repository and committing the changes to the local installation.</p>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -1793,12 +2499,344 @@ repository and committing the changes to the local installation.</p>
</div>
<div class="refsect3">
<a name="flatpak-installation-update-remote-sync.returns"></a><h4>Returns</h4>
-<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the remote has been updated successfully</p>
+<p> <code class="literal">TRUE</code> if the remote has been updated successfully</p>
</div>
<p class="since">Since: 0.6.13</p>
</div>
<hr>
<div class="refsect2">
+<a name="flatpak-installation-cleanup-local-refs-sync"></a><h3>flatpak_installation_cleanup_local_refs_sync ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+flatpak_installation_cleanup_local_refs_sync
+ (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Remove all OSTree refs from the local flatpak repository which are not
+in a deployed state. The next time the underlying OSTree repo is pruned,
+objects which were attached to that ref will be removed. This is useful if
+you pulled a flatpak refs using <a class="link" href="FlatpakInstallation.html#flatpak-installation-install-full" title="flatpak_installation_install_full ()"><code class="function">flatpak_installation_install_full()</code></a> and
+specified <a class="link" href="FlatpakInstallation.html#FLATPAK-INSTALL-FLAGS-NO-DEPLOY:CAPS"><code class="literal">FLATPAK_INSTALL_FLAGS_NO_DEPLOY</code></a> but then decided not to
+deploy the refs later on and want to remove the local refs to prevent them
+from taking up disk space. Note that this will not remove the objects
+referred to by <em class="parameter"><code>ref</code></em>
+ from the underlying OSTree repo, you should use
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-prune-local-repo" title="flatpak_installation_prune_local_repo ()"><code class="function">flatpak_installation_prune_local_repo()</code></a> to do that.</p>
+<div class="refsect3">
+<a name="flatpak-installation-cleanup-local-refs-sync.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-cleanup-local-refs-sync.returns"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> on success</p>
+</div>
+<p class="since">Since: 0.10.0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-installation-get-config"></a><h3>flatpak_installation_get_config ()</h3>
+<pre class="programlisting"><span class="returnvalue">char</span> *
+flatpak_installation_get_config (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *key</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Get a global configuration option for the remote, see
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-set-config-sync" title="flatpak_installation_set_config_sync ()"><code class="function">flatpak_installation_set_config_sync()</code></a> for supported keys.</p>
+<div class="refsect3">
+<a name="flatpak-installation-get-config.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>key</p></td>
+<td class="parameter_description"><p>the name of the key to get</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-get-config.returns"></a><h4>Returns</h4>
+<p> The (newly allocated) value, or <code class="literal">NULL</code> on error (<code class="literal">G_KEY_FILE_ERROR_KEY_NOT_FOUND</code> error if key is not set)</p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-installation-prune-local-repo"></a><h3>flatpak_installation_prune_local_repo ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+flatpak_installation_prune_local_repo (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Remove all orphaned OSTree objects from the underlying OSTree repo in
+<em class="parameter"><code>installation</code></em>
+.</p>
+<div class="refsect3">
+<a name="flatpak-installation-prune-local-repo.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-prune-local-repo.returns"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> on success</p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-installation-remove-local-ref-sync"></a><h3>flatpak_installation_remove_local_ref_sync ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+flatpak_installation_remove_local_ref_sync
+ (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *remote_name</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *ref</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Remove the OSTree ref given by <em class="parameter"><code>remote_name</code></em>
+:<em class="parameter"><code>ref</code></em>
+ from the local flatpak
+repository. The next time the underlying OSTree repo is pruned, objects
+which were attached to that ref will be removed. This is useful if you
+pulled a flatpak ref using <a class="link" href="FlatpakInstallation.html#flatpak-installation-install-full" title="flatpak_installation_install_full ()"><code class="function">flatpak_installation_install_full()</code></a> and
+specified <a class="link" href="FlatpakInstallation.html#FLATPAK-INSTALL-FLAGS-NO-DEPLOY:CAPS"><code class="literal">FLATPAK_INSTALL_FLAGS_NO_DEPLOY</code></a> but then decided not to
+deploy the ref later on and want to remove the local ref to prevent it
+from taking up disk space. Note that this will not remove the objects
+referred to by <em class="parameter"><code>ref</code></em>
+ from the underlying OSTree repo, you should use
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-prune-local-repo" title="flatpak_installation_prune_local_repo ()"><code class="function">flatpak_installation_prune_local_repo()</code></a> to do that.</p>
+<div class="refsect3">
+<a name="flatpak-installation-remove-local-ref-sync.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>remote_name</p></td>
+<td class="parameter_description"><p>the name of the remote</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>ref</p></td>
+<td class="parameter_description"><p>the ref</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-remove-local-ref-sync.returns"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> on success</p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-installation-set-config-sync"></a><h3>flatpak_installation_set_config_sync ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+flatpak_installation_set_config_sync (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *key</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *value</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Set a global configuration option for the installation, currently
+the only supported key is "languages", which is a comman-separated
+list of langue codes like "sv;en;pl", or "" to mean all languages.</p>
+<div class="refsect3">
+<a name="flatpak-installation-set-config-sync.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>key</p></td>
+<td class="parameter_description"><p>the name of the key to set</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>value</p></td>
+<td class="parameter_description"><p>the new value, or <code class="literal">NULL</code> to unset</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-set-config-sync.returns"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> if the option was set correctly</p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-installation-update-appstream-full-sync"></a><h3>flatpak_installation_update_appstream_full_sync ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+flatpak_installation_update_appstream_full_sync
+ (<em class="parameter"><code><a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> *self</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *remote_name</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *arch</code></em>,
+ <em class="parameter"><code><a class="link" href="FlatpakInstallation.html#FlatpakProgressCallback" title="FlatpakProgressCallback ()"><span class="type">FlatpakProgressCallback</span></a> progress</code></em>,
+ <em class="parameter"><code><span class="type">gpointer</span> progress_data</code></em>,
+ <em class="parameter"><code><span class="type">gboolean</span> *out_changed</code></em>,
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Updates the local copy of appstream for <em class="parameter"><code>remote_name</code></em>
+ for the specified <em class="parameter"><code>arch</code></em>
+.</p>
+<div class="refsect3">
+<a name="flatpak-installation-update-appstream-full-sync.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>remote_name</p></td>
+<td class="parameter_description"><p>the name of the remote</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>arch</p></td>
+<td class="parameter_description"><p>Architecture to update, or <code class="literal">NULL</code> for the local machine arch</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>progress</p></td>
+<td class="parameter_description"><p>progress callback. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>progress_data</p></td>
+<td class="parameter_description"><p>user data passed to <em class="parameter"><code>progress</code></em>
+. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> progress][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>out_changed</p></td>
+<td class="parameter_description"><p>Set to <code class="literal">TRUE</code> if the contents of the appstream changed, <code class="literal">FALSE</code> if nothing changed. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-installation-update-appstream-full-sync.returns"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> on success, or <code class="literal">FALSE</code> on error</p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
<a name="flatpak-get-default-arch"></a><h3>flatpak_get_default_arch ()</h3>
<pre class="programlisting">const <span class="returnvalue">char</span> *
flatpak_get_default_arch (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
@@ -1810,19 +2848,69 @@ flatpak_get_default_arch (<em class="parameter"><code><span class="type">void</s
</div>
<hr>
<div class="refsect2">
+<a name="flatpak-get-supported-arches"></a><h3>flatpak_get_supported_arches ()</h3>
+<pre class="programlisting">const <span class="returnvalue">char</span> *const *
+flatpak_get_supported_arches (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>Returns the canonical names for the arches that are supported (i.e. can run)
+on the current machine, in order of priority (default is first).</p>
+<div class="refsect3">
+<a name="flatpak-get-supported-arches.returns"></a><h4>Returns</h4>
+<p> a zero terminated array of arch strings</p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-get-system-installations"></a><h3>flatpak_get_system_installations ()</h3>
+<pre class="programlisting"><span class="returnvalue">GPtrArray</span> *
+flatpak_get_system_installations (<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Lists the system installations according to the current configuration and current
+availability (e.g. doesn't return a configured installation if not reachable).</p>
+<div class="refsect3">
+<a name="flatpak-get-system-installations.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-get-system-installations.returns"></a><h4>Returns</h4>
+<p>an GPtrArray of
+<a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation"><span class="type">FlatpakInstallation</span></a> instances. </p>
+<p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> FlatpakInstallation]</span></p>
+</div>
+<p class="since">Since: 0.8</p>
+</div>
+<hr>
+<div class="refsect2">
<a name="FlatpakProgressCallback"></a><h3>FlatpakProgressCallback ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
<span class="c_punctuation">(</span>*FlatpakProgressCallback<span class="c_punctuation">)</span> (<em class="parameter"><code>const <span class="type">char</span> *status</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> progress</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> estimating</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
+ <em class="parameter"><code><span class="type">guint</span> progress</code></em>,
+ <em class="parameter"><code><span class="type">gboolean</span> estimating</code></em>,
+ <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>The progress callback is called repeatedly during long-running operations
such as installations or updates, and can be used to update progress information
in a user interface.</p>
<p>The callback occurs in the thread-default context of the caller.</p>
<div class="refsect3">
<a name="FlatpakProgressCallback.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -1867,7 +2955,7 @@ is just an estimate</p></td>
<p>Flags to alter the behavior of <a class="link" href="FlatpakInstallation.html#flatpak-installation-update" title="flatpak_installation_update ()"><code class="function">flatpak_installation_update()</code></a>.</p>
<div class="refsect3">
<a name="FlatpakUpdateFlags.members"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
@@ -1895,13 +2983,110 @@ is just an estimate</p></td>
</td>
<td class="enum_member_annotations"> </td>
</tr>
+<tr>
+<td class="enum_member_name"><p><a name="FLATPAK-UPDATE-FLAGS-NO-STATIC-DELTAS:CAPS"></a>FLATPAK_UPDATE_FLAGS_NO_STATIC_DELTAS</p></td>
+<td> </td>
+<td> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="FlatpakInstallFlags"></a><h3>enum FlatpakInstallFlags</h3>
+<p>Flags to alter the behavior of <a class="link" href="FlatpakInstallation.html#flatpak-installation-install-full" title="flatpak_installation_install_full ()"><code class="function">flatpak_installation_install_full()</code></a>.</p>
+<div class="refsect3">
+<a name="FlatpakInstallFlags.members"></a><h4>Members</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="300px" class="enum_members_name">
+<col class="enum_members_description">
+<col width="200px" class="enum_members_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="enum_member_name"><p><a name="FLATPAK-INSTALL-FLAGS-NONE:CAPS"></a>FLATPAK_INSTALL_FLAGS_NONE</p></td>
+<td class="enum_member_description">
+<p>Default</p>
+</td>
+<td class="enum_member_annotations"> </td>
+</tr>
+<tr>
+<td class="enum_member_name"><p><a name="FLATPAK-INSTALL-FLAGS-NO-STATIC-DELTAS:CAPS"></a>FLATPAK_INSTALL_FLAGS_NO_STATIC_DELTAS</p></td>
+<td> </td>
+<td> </td>
+</tr>
+<tr>
+<td class="enum_member_name"><p><a name="FLATPAK-INSTALL-FLAGS-NO-DEPLOY:CAPS"></a>FLATPAK_INSTALL_FLAGS_NO_DEPLOY</p></td>
+<td> </td>
+<td> </td>
+</tr>
+<tr>
+<td class="enum_member_name"><p><a name="FLATPAK-INSTALL-FLAGS-NO-PULL:CAPS"></a>FLATPAK_INSTALL_FLAGS_NO_PULL</p></td>
+<td> </td>
+<td> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="FlatpakStorageType"></a><h3>enum FlatpakStorageType</h3>
+<p>Flags to alter the behavior of <a class="link" href="FlatpakInstallation.html#flatpak-installation-install-full" title="flatpak_installation_install_full ()"><code class="function">flatpak_installation_install_full()</code></a>.</p>
+<div class="refsect3">
+<a name="FlatpakStorageType.members"></a><h4>Members</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="300px" class="enum_members_name">
+<col class="enum_members_description">
+<col width="200px" class="enum_members_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="enum_member_name"><p><a name="FLATPAK-STORAGE-TYPE-DEFAULT:CAPS"></a>FLATPAK_STORAGE_TYPE_DEFAULT</p></td>
+<td class="enum_member_description">
+<p>default</p>
+</td>
+<td class="enum_member_annotations"> </td>
+</tr>
+<tr>
+<td class="enum_member_name"><p><a name="FLATPAK-STORAGE-TYPE-HARD-DISK:CAPS"></a>FLATPAK_STORAGE_TYPE_HARD_DISK</p></td>
+<td class="enum_member_description">
+<p>installation is on a hard disk</p>
+</td>
+<td class="enum_member_annotations"> </td>
+</tr>
+<tr>
+<td class="enum_member_name"><p><a name="FLATPAK-STORAGE-TYPE-SDCARD:CAPS"></a>FLATPAK_STORAGE_TYPE_SDCARD</p></td>
+<td class="enum_member_description">
+<p>installation is on a SD card</p>
+</td>
+<td class="enum_member_annotations"> </td>
+</tr>
+<tr>
+<td class="enum_member_name"><p><a name="FLATPAK-STORAGE-TYPE-MMC:CAPS"></a>FLATPAK_STORAGE_TYPE_MMC</p></td>
+<td class="enum_member_description">
+<p>installation is on an MMC</p>
+</td>
+<td class="enum_member_annotations"> </td>
+</tr>
+<tr>
+<td class="enum_member_name"><p><a name="FLATPAK-STORAGE-TYPE-NETWORK:CAPS"></a>FLATPAK_STORAGE_TYPE_NETWORK</p></td>
+<td class="enum_member_description">
+<p>installation is on the network</p>
+</td>
+<td class="enum_member_annotations"> </td>
+</tr>
</tbody>
</table></div>
</div>
+<p class="since">Since: 0.6.15</p>
</div>
</div>
</div>
<div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
</body>
</html> \ No newline at end of file
diff --git a/reference/html/FlatpakInstalledRef.html b/reference/html/FlatpakInstalledRef.html
index 093f76c2..dfe3b8c9 100644
--- a/reference/html/FlatpakInstalledRef.html
+++ b/reference/html/FlatpakInstalledRef.html
@@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>FlatpakInstalledRef: Flatpak Library Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Flatpak Library Reference Manual">
<link rel="up" href="ch01.html" title="Flatpak">
<link rel="prev" href="FlatpakRef.html" title="FlatpakRef">
-<link rel="next" href="FlatpakRemoteRef.html" title="FlatpakRemoteRef">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<link rel="next" href="FlatpakRelatedRef.html" title="FlatpakRelatedRef">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -22,7 +22,7 @@
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="FlatpakRef.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
-<td><a accesskey="n" href="FlatpakRemoteRef.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+<td><a accesskey="n" href="FlatpakRelatedRef.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="FlatpakInstalledRef"></a><div class="titlepage"></div>
@@ -35,7 +35,7 @@
</tr></table></div>
<div class="refsect1">
<a name="FlatpakInstalledRef.functions"></a><h2>Functions</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
@@ -50,7 +50,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#guint64"><span class="returnvalue">guint64</span></a>
+<span class="returnvalue">guint64</span>
</td>
<td class="function_name">
<a class="link" href="FlatpakInstalledRef.html#flatpak-installed-ref-get-installed-size" title="flatpak_installed_ref_get_installed_size ()">flatpak_installed_ref_get_installed_size</a> <span class="c_punctuation">()</span>
@@ -58,7 +58,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="FlatpakInstalledRef.html#flatpak-installed-ref-get-is-current" title="flatpak_installed_ref_get_is_current ()">flatpak_installed_ref_get_is_current</a> <span class="c_punctuation">()</span>
@@ -80,7 +80,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> *
+<span class="returnvalue">GBytes</span> *
</td>
<td class="function_name">
<a class="link" href="FlatpakInstalledRef.html#flatpak-installed-ref-load-metadata" title="flatpak_installed_ref_load_metadata ()">flatpak_installed_ref_load_metadata</a> <span class="c_punctuation">()</span>
@@ -98,7 +98,7 @@
</div>
<div class="refsect1">
<a name="FlatpakInstalledRef.properties"></a><h2>Properties</h2>
-<div class="informaltable"><table border="0">
+<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
@@ -107,34 +107,34 @@
<tbody>
<tr>
<td class="property_type">
-<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
+<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="FlatpakInstalledRef.html#FlatpakInstalledRef--deploy-dir" title="The “deploy-dir” property">deploy-dir</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
-<td class="property_type"><a href="../glib/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a></td>
+<td class="property_type"><span class="type">guint64</span></td>
<td class="property_name"><a class="link" href="FlatpakInstalledRef.html#FlatpakInstalledRef--installed-size" title="The “installed-size” property">installed-size</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
-<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
+<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="FlatpakInstalledRef.html#FlatpakInstalledRef--is-current" title="The “is-current” property">is-current</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
-<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
+<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="FlatpakInstalledRef.html#FlatpakInstalledRef--latest-commit" title="The “latest-commit” property">latest-commit</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
-<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
+<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="FlatpakInstalledRef.html#FlatpakInstalledRef--origin" title="The “origin” property">origin</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
-<td class="property_type"><a href="../glib/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></td>
+<td class="property_type"><span class="type">GStrv</span></td>
<td class="property_name"><a class="link" href="FlatpakInstalledRef.html#FlatpakInstalledRef--subpaths" title="The “subpaths” property">subpaths</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@@ -143,7 +143,7 @@
</div>
<div class="refsect1">
<a name="FlatpakInstalledRef.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
@@ -156,7 +156,7 @@
</div>
<div class="refsect1">
<a name="FlatpakInstalledRef.object-hierarchy"></a><h2>Object Hierarchy</h2>
-<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
+<pre class="screen"> GObject
<span class="lineart">╰──</span> <a class="link" href="FlatpakRef.html" title="FlatpakRef">FlatpakRef</a>
<span class="lineart">╰──</span> FlatpakInstalledRef
</pre>
@@ -176,7 +176,7 @@ flatpak_installed_ref_get_deploy_dir (<em class="parameter"><code><a class="link
<p>Gets the deploy dir of the ref.</p>
<div class="refsect3">
<a name="flatpak-installed-ref-get-deploy-dir.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -191,20 +191,20 @@ flatpak_installed_ref_get_deploy_dir (<em class="parameter"><code><a class="link
</div>
<div class="refsect3">
<a name="flatpak-installed-ref-get-deploy-dir.returns"></a><h4>Returns</h4>
-<p> the deploy dir. </p>
+<p>the deploy dir. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installed-ref-get-installed-size"></a><h3>flatpak_installed_ref_get_installed_size ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint64"><span class="returnvalue">guint64</span></a>
+<pre class="programlisting"><span class="returnvalue">guint64</span>
flatpak_installed_ref_get_installed_size
(<em class="parameter"><code><a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="type">FlatpakInstalledRef</span></a> *self</code></em>);</pre>
<p>Returns the installed size of the ref.</p>
<div class="refsect3">
<a name="flatpak-installed-ref-get-installed-size.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -225,12 +225,12 @@ flatpak_installed_ref_get_installed_size
<hr>
<div class="refsect2">
<a name="flatpak-installed-ref-get-is-current"></a><h3>flatpak_installed_ref_get_is_current ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
flatpak_installed_ref_get_is_current (<em class="parameter"><code><a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="type">FlatpakInstalledRef</span></a> *self</code></em>);</pre>
<p>Returns whether the ref is current.</p>
<div class="refsect3">
<a name="flatpak-installed-ref-get-is-current.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -245,7 +245,7 @@ flatpak_installed_ref_get_is_current (<em class="parameter"><code><a class="link
</div>
<div class="refsect3">
<a name="flatpak-installed-ref-get-is-current.returns"></a><h4>Returns</h4>
-<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the ref is current</p>
+<p> <code class="literal">TRUE</code> if the ref is current</p>
</div>
</div>
<hr>
@@ -257,7 +257,7 @@ flatpak_installed_ref_get_latest_commit
<p>Gets the latest commit of the ref.</p>
<div class="refsect3">
<a name="flatpak-installed-ref-get-latest-commit.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -272,7 +272,7 @@ flatpak_installed_ref_get_latest_commit
</div>
<div class="refsect3">
<a name="flatpak-installed-ref-get-latest-commit.returns"></a><h4>Returns</h4>
-<p> the latest commit. </p>
+<p>the latest commit. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
@@ -284,7 +284,7 @@ flatpak_installed_ref_get_origin (<em class="parameter"><code><a class="link" hr
<p>Gets the origin of the ref.</p>
<div class="refsect3">
<a name="flatpak-installed-ref-get-origin.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -299,21 +299,21 @@ flatpak_installed_ref_get_origin (<em class="parameter"><code><a class="link" hr
</div>
<div class="refsect3">
<a name="flatpak-installed-ref-get-origin.returns"></a><h4>Returns</h4>
-<p> the origin. </p>
+<p>the origin. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-installed-ref-load-metadata"></a><h3>flatpak_installed_ref_load_metadata ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> *
+<pre class="programlisting"><span class="returnvalue">GBytes</span> *
flatpak_installed_ref_load_metadata (<em class="parameter"><code><a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="type">FlatpakInstalledRef</span></a> *self</code></em>,
- <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Loads the metadata file for this ref.</p>
<div class="refsect3">
<a name="flatpak-installed-ref-load-metadata.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -327,12 +327,12 @@ flatpak_installed_ref_load_metadata (<em class="parameter"><code><a class="link"
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a>. </p></td>
+<td class="parameter_description"><p>a <span class="type">GCancellable</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>a return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>a return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -340,8 +340,8 @@ flatpak_installed_ref_load_metadata (<em class="parameter"><code><a class="link"
</div>
<div class="refsect3">
<a name="flatpak-installed-ref-load-metadata.returns"></a><h4>Returns</h4>
-<p> a <a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> containing the metadata file,
-or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if an error occurred. </p>
+<p>a <span class="type">GBytes</span> containing the metadata file,
+or <code class="literal">NULL</code> if an error occurred. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
@@ -350,10 +350,10 @@ or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">N
<a name="flatpak-installed-ref-get-subpaths"></a><h3>flatpak_installed_ref_get_subpaths ()</h3>
<pre class="programlisting">const <span class="returnvalue">char</span> * const *
flatpak_installed_ref_get_subpaths (<em class="parameter"><code><a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef"><span class="type">FlatpakInstalledRef</span></a> *self</code></em>);</pre>
-<p>Returns the subpaths that are installed, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if all files installed.</p>
+<p>Returns the subpaths that are installed, or <code class="literal">NULL</code> if all files installed.</p>
<div class="refsect3">
<a name="flatpak-installed-ref-get-subpaths.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -368,7 +368,7 @@ flatpak_installed_ref_get_subpaths (<em class="parameter"><code><a class="link"
</div>
<div class="refsect3">
<a name="flatpak-installed-ref-get-subpaths.returns"></a><h4>Returns</h4>
-<p> A strv, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
+<p>A strv, or <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
@@ -384,7 +384,7 @@ flatpak_installed_ref_get_subpaths (<em class="parameter"><code><a class="link"
<a name="FlatpakInstalledRef.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="FlatpakInstalledRef--deploy-dir"></a><h3>The <code class="literal">“deploy-dir”</code> property</h3>
-<pre class="programlisting"> “deploy-dir” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
+<pre class="programlisting"> “deploy-dir” <span class="type">gchar</span> *</pre>
<p>Where the application is installed.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@@ -392,7 +392,7 @@ flatpak_installed_ref_get_subpaths (<em class="parameter"><code><a class="link"
<hr>
<div class="refsect2">
<a name="FlatpakInstalledRef--installed-size"></a><h3>The <code class="literal">“installed-size”</code> property</h3>
-<pre class="programlisting"> “installed-size” <a href="../glib/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a></pre>
+<pre class="programlisting"> “installed-size” <span class="type">guint64</span></pre>
<p>The installed size of the application.</p>
<p>Flags: Read / Write</p>
<p>Default value: 0</p>
@@ -400,7 +400,7 @@ flatpak_installed_ref_get_subpaths (<em class="parameter"><code><a class="link"
<hr>
<div class="refsect2">
<a name="FlatpakInstalledRef--is-current"></a><h3>The <code class="literal">“is-current”</code> property</h3>
-<pre class="programlisting"> “is-current” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
+<pre class="programlisting"> “is-current” <span class="type">gboolean</span></pre>
<p>Whether the application is current.</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
@@ -408,7 +408,7 @@ flatpak_installed_ref_get_subpaths (<em class="parameter"><code><a class="link"
<hr>
<div class="refsect2">
<a name="FlatpakInstalledRef--latest-commit"></a><h3>The <code class="literal">“latest-commit”</code> property</h3>
-<pre class="programlisting"> “latest-commit” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
+<pre class="programlisting"> “latest-commit” <span class="type">gchar</span> *</pre>
<p>The latest commit.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@@ -416,7 +416,7 @@ flatpak_installed_ref_get_subpaths (<em class="parameter"><code><a class="link"
<hr>
<div class="refsect2">
<a name="FlatpakInstalledRef--origin"></a><h3>The <code class="literal">“origin”</code> property</h3>
-<pre class="programlisting"> “origin” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
+<pre class="programlisting"> “origin” <span class="type">gchar</span> *</pre>
<p>The origin.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@@ -424,12 +424,12 @@ flatpak_installed_ref_get_subpaths (<em class="parameter"><code><a class="link"
<hr>
<div class="refsect2">
<a name="FlatpakInstalledRef--subpaths"></a><h3>The <code class="literal">“subpaths”</code> property</h3>
-<pre class="programlisting"> “subpaths” <a href="../glib/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre>
+<pre class="programlisting"> “subpaths” <span class="type">GStrv</span></pre>
<p>Flags: Read / Write</p>
</div>
</div>
</div>
<div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
</body>
</html> \ No newline at end of file
diff --git a/reference/html/FlatpakRef.html b/reference/html/FlatpakRef.html
index 2a0b4fed..00987629 100644
--- a/reference/html/FlatpakRef.html
+++ b/reference/html/FlatpakRef.html
@@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>FlatpakRef: Flatpak Library Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Flatpak Library Reference Manual">
<link rel="up" href="ch01.html" title="Flatpak">
<link rel="prev" href="FlatpakInstallation.html" title="FlatpakInstallation">
<link rel="next" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -35,7 +35,7 @@
</tr></table></div>
<div class="refsect1">
<a name="FlatpakRef.functions"></a><h2>Functions</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
@@ -67,6 +67,13 @@
<td class="function_type">const <span class="returnvalue">char</span> *
</td>
<td class="function_name">
+<a class="link" href="FlatpakRef.html#flatpak-ref-get-collection-id" title="flatpak_ref_get_collection_id ()">flatpak_ref_get_collection_id</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">const <span class="returnvalue">char</span> *
+</td>
+<td class="function_name">
<a class="link" href="FlatpakRef.html#flatpak-ref-get-commit" title="flatpak_ref_get_commit ()">flatpak_ref_get_commit</a> <span class="c_punctuation">()</span>
</td>
</tr>
@@ -98,7 +105,7 @@
</div>
<div class="refsect1">
<a name="FlatpakRef.properties"></a><h2>Properties</h2>
-<div class="informaltable"><table border="0">
+<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
@@ -107,19 +114,25 @@
<tbody>
<tr>
<td class="property_type">
-<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
+<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="FlatpakRef.html#FlatpakRef--arch" title="The “arch” property">arch</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
-<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
+<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="FlatpakRef.html#FlatpakRef--branch" title="The “branch” property">branch</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
-<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
+<span class="type">gchar</span> *</td>
+<td class="property_name"><a class="link" href="FlatpakRef.html#FlatpakRef--collection-id" title="The “collection-id” property">collection-id</a></td>
+<td class="property_flags">Read / Write</td>
+</tr>
+<tr>
+<td class="property_type">
+<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="FlatpakRef.html#FlatpakRef--commit" title="The “commit” property">commit</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@@ -130,7 +143,7 @@
</tr>
<tr>
<td class="property_type">
-<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
+<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="FlatpakRef.html#FlatpakRef--name" title="The “name” property">name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@@ -139,7 +152,7 @@
</div>
<div class="refsect1">
<a name="FlatpakRef.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
@@ -158,10 +171,11 @@
</div>
<div class="refsect1">
<a name="FlatpakRef.object-hierarchy"></a><h2>Object Hierarchy</h2>
-<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
+<pre class="screen"> GObject
<span class="lineart">╰──</span> FlatpakRef
<span class="lineart">├──</span> <a class="link" href="flatpak-flatpak-bundle-ref.html#FlatpakBundleRef">FlatpakBundleRef</a>
<span class="lineart">├──</span> <a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef">FlatpakInstalledRef</a>
+ <span class="lineart">├──</span> <a class="link" href="FlatpakRelatedRef.html" title="FlatpakRelatedRef">FlatpakRelatedRef</a>
<span class="lineart">╰──</span> <a class="link" href="FlatpakRemoteRef.html" title="FlatpakRemoteRef">FlatpakRemoteRef</a>
</pre>
</div>
@@ -190,7 +204,7 @@ flatpak_ref_format_ref (<em class="parameter"><code><a class="link" href="Flatpa
can be parsed by <a class="link" href="FlatpakRef.html#flatpak-ref-parse" title="flatpak_ref_parse ()"><code class="function">flatpak_ref_parse()</code></a>.</p>
<div class="refsect3">
<a name="flatpak-ref-format-ref.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -205,7 +219,7 @@ can be parsed by <a class="link" href="FlatpakRef.html#flatpak-ref-parse" title=
</div>
<div class="refsect3">
<a name="flatpak-ref-format-ref.returns"></a><h4>Returns</h4>
-<p> string representation. </p>
+<p>string representation. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
@@ -217,7 +231,7 @@ flatpak_ref_get_arch (<em class="parameter"><code><a class="link" href="FlatpakR
<p>Gets the arch or the ref.</p>
<div class="refsect3">
<a name="flatpak-ref-get-arch.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -232,7 +246,7 @@ flatpak_ref_get_arch (<em class="parameter"><code><a class="link" href="FlatpakR
</div>
<div class="refsect3">
<a name="flatpak-ref-get-arch.returns"></a><h4>Returns</h4>
-<p> the arch. </p>
+<p>the arch. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
@@ -244,7 +258,7 @@ flatpak_ref_get_branch (<em class="parameter"><code><a class="link" href="Flatpa
<p>Gets the branch of the ref.</p>
<div class="refsect3">
<a name="flatpak-ref-get-branch.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -259,7 +273,34 @@ flatpak_ref_get_branch (<em class="parameter"><code><a class="link" href="Flatpa
</div>
<div class="refsect3">
<a name="flatpak-ref-get-branch.returns"></a><h4>Returns</h4>
-<p> the branch. </p>
+<p>the branch. </p>
+<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-ref-get-collection-id"></a><h3>flatpak_ref_get_collection_id ()</h3>
+<pre class="programlisting">const <span class="returnvalue">char</span> *
+flatpak_ref_get_collection_id (<em class="parameter"><code><a class="link" href="FlatpakRef.html" title="FlatpakRef"><span class="type">FlatpakRef</span></a> *self</code></em>);</pre>
+<p>Gets the collection ID of the ref.</p>
+<div class="refsect3">
+<a name="flatpak-ref-get-collection-id.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakRef.html" title="FlatpakRef"><span class="type">FlatpakRef</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-ref-get-collection-id.returns"></a><h4>Returns</h4>
+<p>the collection ID. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
@@ -271,7 +312,7 @@ flatpak_ref_get_commit (<em class="parameter"><code><a class="link" href="Flatpa
<p>Gets the commit of the ref.</p>
<div class="refsect3">
<a name="flatpak-ref-get-commit.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -286,7 +327,7 @@ flatpak_ref_get_commit (<em class="parameter"><code><a class="link" href="Flatpa
</div>
<div class="refsect3">
<a name="flatpak-ref-get-commit.returns"></a><h4>Returns</h4>
-<p> the commit. </p>
+<p>the commit. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
@@ -298,7 +339,7 @@ flatpak_ref_get_kind (<em class="parameter"><code><a class="link" href="FlatpakR
<p>Gets the kind of artifact that this ref refers to.</p>
<div class="refsect3">
<a name="flatpak-ref-get-kind.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -324,7 +365,7 @@ flatpak_ref_get_name (<em class="parameter"><code><a class="link" href="FlatpakR
<p>Gets the name of the ref.</p>
<div class="refsect3">
<a name="flatpak-ref-get-name.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -339,7 +380,7 @@ flatpak_ref_get_name (<em class="parameter"><code><a class="link" href="FlatpakR
</div>
<div class="refsect3">
<a name="flatpak-ref-get-name.returns"></a><h4>Returns</h4>
-<p> the name. </p>
+<p>the name. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
@@ -348,12 +389,12 @@ flatpak_ref_get_name (<em class="parameter"><code><a class="link" href="FlatpakR
<a name="flatpak-ref-parse"></a><h3>flatpak_ref_parse ()</h3>
<pre class="programlisting"><a class="link" href="FlatpakRef.html" title="FlatpakRef"><span class="returnvalue">FlatpakRef</span></a> *
flatpak_ref_parse (<em class="parameter"><code>const <span class="type">char</span> *ref</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Tries to parse a full ref name and return a <a class="link" href="FlatpakRef.html" title="FlatpakRef"><span class="type">FlatpakRef</span></a> (without a
commit set) or fail if the ref is invalid somehow.</p>
<div class="refsect3">
<a name="flatpak-ref-parse.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -367,7 +408,7 @@ commit set) or fail if the ref is invalid somehow.</p>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p>return location for a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -375,7 +416,7 @@ commit set) or fail if the ref is invalid somehow.</p>
</div>
<div class="refsect3">
<a name="flatpak-ref-parse.returns"></a><h4>Returns</h4>
-<p> an <a class="link" href="FlatpakRef.html" title="FlatpakRef"><span class="type">FlatpakRef</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
+<p>an <a class="link" href="FlatpakRef.html" title="FlatpakRef"><span class="type">FlatpakRef</span></a>, or <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
@@ -392,7 +433,7 @@ commit set) or fail if the ref is invalid somehow.</p>
<p>The kind of artifact that a FlatpakRef refers to.</p>
<div class="refsect3">
<a name="FlatpakRefKind.members"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
@@ -422,7 +463,7 @@ commit set) or fail if the ref is invalid somehow.</p>
<a name="FlatpakRef.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="FlatpakRef--arch"></a><h3>The <code class="literal">“arch”</code> property</h3>
-<pre class="programlisting"> “arch” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
+<pre class="programlisting"> “arch” <span class="type">gchar</span> *</pre>
<p>The architecture of the application or runtime.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@@ -430,15 +471,23 @@ commit set) or fail if the ref is invalid somehow.</p>
<hr>
<div class="refsect2">
<a name="FlatpakRef--branch"></a><h3>The <code class="literal">“branch”</code> property</h3>
-<pre class="programlisting"> “branch” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
+<pre class="programlisting"> “branch” <span class="type">gchar</span> *</pre>
<p>The branch of the application or runtime.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2">
+<a name="FlatpakRef--collection-id"></a><h3>The <code class="literal">“collection-id”</code> property</h3>
+<pre class="programlisting"> “collection-id” <span class="type">gchar</span> *</pre>
+<p>The collection ID.</p>
+<p>Flags: Read / Write</p>
+<p>Default value: NULL</p>
+</div>
+<hr>
+<div class="refsect2">
<a name="FlatpakRef--commit"></a><h3>The <code class="literal">“commit”</code> property</h3>
-<pre class="programlisting"> “commit” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
+<pre class="programlisting"> “commit” <span class="type">gchar</span> *</pre>
<p>The commit.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@@ -454,7 +503,7 @@ commit set) or fail if the ref is invalid somehow.</p>
<hr>
<div class="refsect2">
<a name="FlatpakRef--name"></a><h3>The <code class="literal">“name”</code> property</h3>
-<pre class="programlisting"> “name” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
+<pre class="programlisting"> “name” <span class="type">gchar</span> *</pre>
<p>The name of the application or runtime.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@@ -462,6 +511,6 @@ commit set) or fail if the ref is invalid somehow.</p>
</div>
</div>
<div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
</body>
</html> \ No newline at end of file
diff --git a/reference/html/FlatpakRemote.html b/reference/html/FlatpakRemote.html
index ba5c6bd1..2b787971 100644
--- a/reference/html/FlatpakRemote.html
+++ b/reference/html/FlatpakRemote.html
@@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>FlatpakRemote: Flatpak Library Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Flatpak Library Reference Manual">
<link rel="up" href="ch01.html" title="Flatpak">
<link rel="prev" href="FlatpakRemoteRef.html" title="FlatpakRemoteRef">
<link rel="next" href="flatpak-flatpak-bundle-ref.html" title="flatpak-bundle-ref">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -35,7 +35,7 @@
</tr></table></div>
<div class="refsect1">
<a name="FlatpakRemote.functions"></a><h2>Functions</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
@@ -58,7 +58,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
+<span class="returnvalue">GFile</span> *
</td>
<td class="function_name">
<a class="link" href="FlatpakRemote.html#flatpak-remote-get-appstream-dir" title="flatpak_remote_get_appstream_dir ()">flatpak_remote_get_appstream_dir</a> <span class="c_punctuation">()</span>
@@ -66,7 +66,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
+<span class="returnvalue">GFile</span> *
</td>
<td class="function_name">
<a class="link" href="FlatpakRemote.html#flatpak-remote-get-appstream-timestamp" title="flatpak_remote_get_appstream_timestamp ()">flatpak_remote_get_appstream_timestamp</a> <span class="c_punctuation">()</span>
@@ -74,7 +74,39 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<span class="returnvalue">char</span> *
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakRemote.html#flatpak-remote-get-collection-id" title="flatpak_remote_get_collection_id ()">flatpak_remote_get_collection_id</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakRemote.html#flatpak-remote-set-collection-id" title="flatpak_remote_set_collection_id ()">flatpak_remote_set_collection_id</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">char</span> *
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakRemote.html#flatpak-remote-get-default-branch" title="flatpak_remote_get_default_branch ()">flatpak_remote_get_default_branch</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakRemote.html#flatpak-remote-set-default-branch" title="flatpak_remote_set_default_branch ()">flatpak_remote_set_default_branch</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="FlatpakRemote.html#flatpak-remote-get-gpg-verify" title="flatpak_remote_get_gpg_verify ()">flatpak_remote_get_gpg_verify</a> <span class="c_punctuation">()</span>
@@ -98,7 +130,23 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakRemote.html#flatpak-remote-get-nodeps" title="flatpak_remote_get_nodeps ()">flatpak_remote_get_nodeps</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakRemote.html#flatpak-remote-set-nodeps" title="flatpak_remote_set_nodeps ()">flatpak_remote_set_nodeps</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="FlatpakRemote.html#flatpak-remote-get-noenumerate" title="flatpak_remote_get_noenumerate ()">flatpak_remote_get_noenumerate</a> <span class="c_punctuation">()</span>
@@ -130,6 +178,14 @@
</tr>
<tr>
<td class="function_type">
+<a class="link" href="FlatpakRemote.html#FlatpakRemoteType" title="enum FlatpakRemoteType"><span class="returnvalue">FlatpakRemoteType</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="FlatpakRemote.html#flatpak-remote-get-remote-type" title="flatpak_remote_get_remote_type ()">flatpak_remote_get_remote_type</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
<span class="returnvalue">char</span> *
</td>
<td class="function_name">
@@ -162,7 +218,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="FlatpakRemote.html#flatpak-remote-get-disabled" title="flatpak_remote_get_disabled ()">flatpak_remote_get_disabled</a> <span class="c_punctuation">()</span>
@@ -181,36 +237,49 @@
</div>
<div class="refsect1">
<a name="FlatpakRemote.properties"></a><h2>Properties</h2>
-<div class="informaltable"><table border="0">
+<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
-<tbody><tr>
+<tbody>
+<tr>
<td class="property_type">
-<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
+<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="FlatpakRemote.html#FlatpakRemote--name" title="The “name” property">name</a></td>
<td class="property_flags">Read / Write</td>
-</tr></tbody>
+</tr>
+<tr>
+<td class="property_type"><a class="link" href="FlatpakRemote.html#FlatpakRemoteType" title="enum FlatpakRemoteType"><span class="type">FlatpakRemoteType</span></a></td>
+<td class="property_name"><a class="link" href="FlatpakRemote.html#FlatpakRemote--type" title="The “type” property">type</a></td>
+<td class="property_flags">Read / Write / Construct Only</td>
+</tr>
+</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="FlatpakRemote.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
-<tbody><tr>
+<tbody>
+<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="FlatpakRemote.html#FlatpakRemote-struct" title="struct FlatpakRemote">FlatpakRemote</a></td>
-</tr></tbody>
+</tr>
+<tr>
+<td class="datatype_keyword">enum</td>
+<td class="function_name"><a class="link" href="FlatpakRemote.html#FlatpakRemoteType" title="enum FlatpakRemoteType">FlatpakRemoteType</a></td>
+</tr>
+</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="FlatpakRemote.object-hierarchy"></a><h2>Object Hierarchy</h2>
-<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
+<pre class="screen"> GObject
<span class="lineart">╰──</span> FlatpakRemote
</pre>
</div>
@@ -239,7 +308,7 @@ using <a class="link" href="FlatpakInstallation.html#flatpak-installation-modify
effect.</p>
<div class="refsect3">
<a name="flatpak-remote-new.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -254,7 +323,7 @@ effect.</p>
</div>
<div class="refsect3">
<a name="flatpak-remote-new.returns"></a><h4>Returns</h4>
-<p> a new <a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a>. </p>
+<p>a new <a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
@@ -266,7 +335,7 @@ flatpak_remote_get_name (<em class="parameter"><code><a class="link" href="Flatp
<p>Returns the name of the remote repository.</p>
<div class="refsect3">
<a name="flatpak-remote-get-name.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -281,14 +350,14 @@ flatpak_remote_get_name (<em class="parameter"><code><a class="link" href="Flatp
</div>
<div class="refsect3">
<a name="flatpak-remote-get-name.returns"></a><h4>Returns</h4>
-<p> the name. </p>
+<p>the name. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-remote-get-appstream-dir"></a><h3>flatpak_remote_get_appstream_dir ()</h3>
-<pre class="programlisting"><a href="../gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
+<pre class="programlisting"><span class="returnvalue">GFile</span> *
flatpak_remote_get_appstream_dir (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *arch</code></em>);</pre>
<p>Returns the directory where this remote will store locally cached
@@ -296,7 +365,7 @@ appstream information for the specified <em class="parameter"><code>arch</code><
.</p>
<div class="refsect3">
<a name="flatpak-remote-get-appstream-dir.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -310,7 +379,7 @@ appstream information for the specified <em class="parameter"><code>arch</code><
</tr>
<tr>
<td class="parameter_name"><p>arch</p></td>
-<td class="parameter_description"><p> which architecture to fetch (default: current architecture). </p></td>
+<td class="parameter_description"><p>which architecture to fetch (default: current architecture). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
@@ -318,14 +387,14 @@ appstream information for the specified <em class="parameter"><code>arch</code><
</div>
<div class="refsect3">
<a name="flatpak-remote-get-appstream-dir.returns"></a><h4>Returns</h4>
-<p> a <a href="../gio/GFile.html#GFile-struct"><span class="type">GFile</span></a>. </p>
+<p>a <span class="type">GFile</span>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-remote-get-appstream-timestamp"></a><h3>flatpak_remote_get_appstream_timestamp ()</h3>
-<pre class="programlisting"><a href="../gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
+<pre class="programlisting"><span class="returnvalue">GFile</span> *
flatpak_remote_get_appstream_timestamp
(<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *arch</code></em>);</pre>
@@ -334,7 +403,7 @@ has been updated (or tried to update) for the specified <em class="parameter"><c
.</p>
<div class="refsect3">
<a name="flatpak-remote-get-appstream-timestamp.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -348,7 +417,7 @@ has been updated (or tried to update) for the specified <em class="parameter"><c
</tr>
<tr>
<td class="parameter_name"><p>arch</p></td>
-<td class="parameter_description"><p> which architecture to fetch (default: current architecture). </p></td>
+<td class="parameter_description"><p>which architecture to fetch (default: current architecture). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
@@ -356,19 +425,141 @@ has been updated (or tried to update) for the specified <em class="parameter"><c
</div>
<div class="refsect3">
<a name="flatpak-remote-get-appstream-timestamp.returns"></a><h4>Returns</h4>
-<p> a <a href="../gio/GFile.html#GFile-struct"><span class="type">GFile</span></a>. </p>
+<p>a <span class="type">GFile</span>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
+<a name="flatpak-remote-get-collection-id"></a><h3>flatpak_remote_get_collection_id ()</h3>
+<pre class="programlisting"><span class="returnvalue">char</span> *
+flatpak_remote_get_collection_id (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>);</pre>
+<p>Returns the repository collection ID of this remote, if set.</p>
+<div class="refsect3">
+<a name="flatpak-remote-get-collection-id.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-remote-get-collection-id.returns"></a><h4>Returns</h4>
+<p>the collection ID, or <code class="literal">NULL</code> if unset. </p>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-remote-set-collection-id"></a><h3>flatpak_remote_set_collection_id ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+flatpak_remote_set_collection_id (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *collection_id</code></em>);</pre>
+<p>Sets the repository collection ID of this remote.</p>
+<p>Note: This is a local modification of this object, you must commit changes
+using <a class="link" href="FlatpakInstallation.html#flatpak-installation-modify-remote" title="flatpak_installation_modify_remote ()"><code class="function">flatpak_installation_modify_remote()</code></a> for the changes to take
+effect.</p>
+<div class="refsect3">
+<a name="flatpak-remote-set-collection-id.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>collection_id</p></td>
+<td class="parameter_description"><p>The new collection ID, or <code class="literal">NULL</code> to unset. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-remote-get-default-branch"></a><h3>flatpak_remote_get_default_branch ()</h3>
+<pre class="programlisting"><span class="returnvalue">char</span> *
+flatpak_remote_get_default_branch (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>);</pre>
+<p>Returns the default branch configured for the remote.</p>
+<div class="refsect3">
+<a name="flatpak-remote-get-default-branch.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-remote-get-default-branch.returns"></a><h4>Returns</h4>
+<p>the default branch, or <code class="literal">NULL</code>. </p>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+</div>
+<p class="since">Since: 0.6.12</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-remote-set-default-branch"></a><h3>flatpak_remote_set_default_branch ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+flatpak_remote_set_default_branch (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>,
+ <em class="parameter"><code>const <span class="type">char</span> *default_branch</code></em>);</pre>
+<p>Sets the default branch configured for this remote.</p>
+<p>Note: This is a local modification of this object, you must commit changes
+using <a class="link" href="FlatpakInstallation.html#flatpak-installation-modify-remote" title="flatpak_installation_modify_remote ()"><code class="function">flatpak_installation_modify_remote()</code></a> for the changes to take
+effect.</p>
+<div class="refsect3">
+<a name="flatpak-remote-set-default-branch.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>default_branch</p></td>
+<td class="parameter_description"><p>The new default_branch</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since: 0.6.12</p>
+</div>
+<hr>
+<div class="refsect2">
<a name="flatpak-remote-get-gpg-verify"></a><h3>flatpak_remote_get_gpg_verify ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
flatpak_remote_get_gpg_verify (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>);</pre>
<p>Returns whether GPG verification is enabled for the remote.</p>
<div class="refsect3">
<a name="flatpak-remote-get-gpg-verify.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -391,14 +582,14 @@ flatpak_remote_get_gpg_verify (<em class="parameter"><code><a class="link" href=
<a name="flatpak-remote-set-gpg-verify"></a><h3>flatpak_remote_set_gpg_verify ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
flatpak_remote_set_gpg_verify (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> gpg_verify</code></em>);</pre>
+ <em class="parameter"><code><span class="type">gboolean</span> gpg_verify</code></em>);</pre>
<p>Sets the gpg_verify config of this remote. See <a class="link" href="FlatpakRemote.html#flatpak-remote-get-gpg-verify" title="flatpak_remote_get_gpg_verify ()"><code class="function">flatpak_remote_get_gpg_verify()</code></a>.</p>
<p>Note: This is a local modification of this object, you must commit changes
using <a class="link" href="FlatpakInstallation.html#flatpak-installation-modify-remote" title="flatpak_installation_modify_remote ()"><code class="function">flatpak_installation_modify_remote()</code></a> for the changes to take
effect.</p>
<div class="refsect3">
<a name="flatpak-remote-set-gpg-verify.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -424,14 +615,14 @@ effect.</p>
<a name="flatpak-remote-set-gpg-key"></a><h3>flatpak_remote_set_gpg_key ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
flatpak_remote_set_gpg_key (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *gpg_key</code></em>);</pre>
+ <em class="parameter"><code><span class="type">GBytes</span> *gpg_key</code></em>);</pre>
<p>Sets the trusted gpg key for this remote.</p>
<p>Note: This is a local modification of this object, you must commit changes
using <a class="link" href="FlatpakInstallation.html#flatpak-installation-modify-remote" title="flatpak_installation_modify_remote ()"><code class="function">flatpak_installation_modify_remote()</code></a> for the changes to take
effect.</p>
<div class="refsect3">
<a name="flatpak-remote-set-gpg-key.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -445,7 +636,66 @@ effect.</p>
</tr>
<tr>
<td class="parameter_name"><p>gpg_key</p></td>
-<td class="parameter_description"><p>a <a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> with gpg binary key data</p></td>
+<td class="parameter_description"><p>a <span class="type">GBytes</span> with gpg binary key data</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-remote-get-nodeps"></a><h3>flatpak_remote_get_nodeps ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+flatpak_remote_get_nodeps (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>);</pre>
+<p>Returns whether this remote should be used to find dependencies.</p>
+<div class="refsect3">
+<a name="flatpak-remote-get-nodeps.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-remote-get-nodeps.returns"></a><h4>Returns</h4>
+<p> whether the remote is marked as "don't use for dependencies"</p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-remote-set-nodeps"></a><h3>flatpak_remote_set_nodeps ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+flatpak_remote_set_nodeps (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>,
+ <em class="parameter"><code><span class="type">gboolean</span> nodeps</code></em>);</pre>
+<p>Sets the nodeps config of this remote. See <a class="link" href="FlatpakRemote.html#flatpak-remote-get-nodeps" title="flatpak_remote_get_nodeps ()"><code class="function">flatpak_remote_get_nodeps()</code></a>.</p>
+<p>Note: This is a local modification of this object, you must commit changes
+using <a class="link" href="FlatpakInstallation.html#flatpak-installation-modify-remote" title="flatpak_installation_modify_remote ()"><code class="function">flatpak_installation_modify_remote()</code></a> for the changes to take
+effect.</p>
+<div class="refsect3">
+<a name="flatpak-remote-set-nodeps.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>nodeps</p></td>
+<td class="parameter_description"><p>a bool</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@@ -455,12 +705,12 @@ effect.</p>
<hr>
<div class="refsect2">
<a name="flatpak-remote-get-noenumerate"></a><h3>flatpak_remote_get_noenumerate ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
flatpak_remote_get_noenumerate (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>);</pre>
<p>Returns whether this remote should be used to list applications.</p>
<div class="refsect3">
<a name="flatpak-remote-get-noenumerate.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -483,14 +733,14 @@ flatpak_remote_get_noenumerate (<em class="parameter"><code><a class="link" href
<a name="flatpak-remote-set-noenumerate"></a><h3>flatpak_remote_set_noenumerate ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
flatpak_remote_set_noenumerate (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> noenumerate</code></em>);</pre>
+ <em class="parameter"><code><span class="type">gboolean</span> noenumerate</code></em>);</pre>
<p>Sets the noenumeration config of this remote. See <a class="link" href="FlatpakRemote.html#flatpak-remote-get-noenumerate" title="flatpak_remote_get_noenumerate ()"><code class="function">flatpak_remote_get_noenumerate()</code></a>.</p>
<p>Note: This is a local modification of this object, you must commit changes
using <a class="link" href="FlatpakInstallation.html#flatpak-installation-modify-remote" title="flatpak_installation_modify_remote ()"><code class="function">flatpak_installation_modify_remote()</code></a> for the changes to take
effect.</p>
<div class="refsect3">
<a name="flatpak-remote-set-noenumerate.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -519,7 +769,7 @@ flatpak_remote_get_prio (<em class="parameter"><code><a class="link" href="Flatp
<p>Returns the priority for the remote.</p>
<div class="refsect3">
<a name="flatpak-remote-get-prio.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -549,7 +799,7 @@ using <a class="link" href="FlatpakInstallation.html#flatpak-installation-modify
effect.</p>
<div class="refsect3">
<a name="flatpak-remote-set-prio.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -572,13 +822,40 @@ effect.</p>
</div>
<hr>
<div class="refsect2">
+<a name="flatpak-remote-get-remote-type"></a><h3>flatpak_remote_get_remote_type ()</h3>
+<pre class="programlisting"><a class="link" href="FlatpakRemote.html#FlatpakRemoteType" title="enum FlatpakRemoteType"><span class="returnvalue">FlatpakRemoteType</span></a>
+flatpak_remote_get_remote_type (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>);</pre>
+<p>Get the value of <a class="link" href="FlatpakRemote.html#FlatpakRemote--type" title="The “type” property"><span class="type">“type”</span></a>.</p>
+<div class="refsect3">
+<a name="flatpak-remote-get-remote-type.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>a <a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="flatpak-remote-get-remote-type.returns"></a><h4>Returns</h4>
+<p> the type of remote this is</p>
+</div>
+<p class="since">Since: 0.9.8</p>
+</div>
+<hr>
+<div class="refsect2">
<a name="flatpak-remote-get-title"></a><h3>flatpak_remote_get_title ()</h3>
<pre class="programlisting"><span class="returnvalue">char</span> *
flatpak_remote_get_title (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>);</pre>
<p>Returns the title of the remote.</p>
<div class="refsect3">
<a name="flatpak-remote-get-title.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -593,7 +870,7 @@ flatpak_remote_get_title (<em class="parameter"><code><a class="link" href="Flat
</div>
<div class="refsect3">
<a name="flatpak-remote-get-title.returns"></a><h4>Returns</h4>
-<p> the title. </p>
+<p>the title. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
@@ -609,7 +886,7 @@ using <a class="link" href="FlatpakInstallation.html#flatpak-installation-modify
effect.</p>
<div class="refsect3">
<a name="flatpak-remote-set-title.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -638,7 +915,7 @@ flatpak_remote_get_url (<em class="parameter"><code><a class="link" href="Flatpa
<p>Returns the repository URL of this remote.</p>
<div class="refsect3">
<a name="flatpak-remote-get-url.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -653,7 +930,7 @@ flatpak_remote_get_url (<em class="parameter"><code><a class="link" href="Flatpa
</div>
<div class="refsect3">
<a name="flatpak-remote-get-url.returns"></a><h4>Returns</h4>
-<p> the URL. </p>
+<p>the URL. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
@@ -669,7 +946,7 @@ using <a class="link" href="FlatpakInstallation.html#flatpak-installation-modify
effect.</p>
<div class="refsect3">
<a name="flatpak-remote-set-url.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -693,12 +970,12 @@ effect.</p>
<hr>
<div class="refsect2">
<a name="flatpak-remote-get-disabled"></a><h3>flatpak_remote_get_disabled ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
flatpak_remote_get_disabled (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>);</pre>
<p>Returns whether this remote is disabled.</p>
<div class="refsect3">
<a name="flatpak-remote-get-disabled.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -721,14 +998,14 @@ flatpak_remote_get_disabled (<em class="parameter"><code><a class="link" href="F
<a name="flatpak-remote-set-disabled"></a><h3>flatpak_remote_set_disabled ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
flatpak_remote_set_disabled (<em class="parameter"><code><a class="link" href="FlatpakRemote.html" title="FlatpakRemote"><span class="type">FlatpakRemote</span></a> *self</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> disabled</code></em>);</pre>
-<p>Sets the disabled config of this remote. See <code class="function">flatpak_remote_get_disable()</code>.</p>
+ <em class="parameter"><code><span class="type">gboolean</span> disabled</code></em>);</pre>
+<p>Sets the disabled config of this remote. See <a class="link" href="FlatpakRemote.html#flatpak-remote-get-disabled" title="flatpak_remote_get_disabled ()"><code class="function">flatpak_remote_get_disabled()</code></a>.</p>
<p>Note: This is a local modification of this object, you must commit changes
using <a class="link" href="FlatpakInstallation.html#flatpak-installation-modify-remote" title="flatpak_installation_modify_remote ()"><code class="function">flatpak_installation_modify_remote()</code></a> for the changes to take
effect.</p>
<div class="refsect3">
<a name="flatpak-remote-set-disabled.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -756,19 +1033,69 @@ effect.</p>
<a name="FlatpakRemote-struct"></a><h3>struct FlatpakRemote</h3>
<pre class="programlisting">struct FlatpakRemote;</pre>
</div>
+<hr>
+<div class="refsect2">
+<a name="FlatpakRemoteType"></a><h3>enum FlatpakRemoteType</h3>
+<div class="refsect3">
+<a name="FlatpakRemoteType.members"></a><h4>Members</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="300px" class="enum_members_name">
+<col class="enum_members_description">
+<col width="200px" class="enum_members_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="enum_member_name"><p><a name="FLATPAK-REMOTE-TYPE-STATIC:CAPS"></a>FLATPAK_REMOTE_TYPE_STATIC</p></td>
+<td> </td>
+<td> </td>
+</tr>
+<tr>
+<td class="enum_member_name"><p><a name="FLATPAK-REMOTE-TYPE-USB:CAPS"></a>FLATPAK_REMOTE_TYPE_USB</p></td>
+<td> </td>
+<td> </td>
+</tr>
+<tr>
+<td class="enum_member_name"><p><a name="FLATPAK-REMOTE-TYPE-LAN:CAPS"></a>FLATPAK_REMOTE_TYPE_LAN</p></td>
+<td> </td>
+<td> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
</div>
<div class="refsect1">
<a name="FlatpakRemote.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="FlatpakRemote--name"></a><h3>The <code class="literal">“name”</code> property</h3>
-<pre class="programlisting"> “name” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
-<p>The name of the remote.</p>
+<pre class="programlisting"> “name” <span class="type">gchar</span> *</pre>
+<p>Name of the remote, as used in configuration files and when interfacing
+with OSTree. This is typically human readable, but could be generated, and
+must conform to <a href="/usr/share/gtk-doc/html/ostree/ostree-Core-repository-independent-functions.html#ostree-validate-remote-name"><code class="function">ostree_validate_remote_name()</code></a>. It should typically not be
+presented in the UI.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
</div>
+<hr>
+<div class="refsect2">
+<a name="FlatpakRemote--type"></a><h3>The <code class="literal">“type”</code> property</h3>
+<pre class="programlisting"> “type” <a class="link" href="FlatpakRemote.html#FlatpakRemoteType" title="enum FlatpakRemoteType"><span class="type">FlatpakRemoteType</span></a></pre>
+<p>The type of the remote: whether it comes from static configuration files
+(<em class="parameter"><code>FLATPAK_REMOTE_TYPE_STATIC</code></em>
+) or has been dynamically found from the local
+network or a mounted USB drive (<em class="parameter"><code>FLATPAK_REMOTE_TYPE_LAN</code></em>
+,
+<em class="parameter"><code>FLATPAK_REMOTE_TYPE_USB</code></em>
+). Dynamic remotes may be added and removed over
+time.</p>
+<p>Flags: Read / Write / Construct Only</p>
+<p>Default value: FLATPAK_REMOTE_TYPE_STATIC</p>
+<p class="since">Since: 0.9.8</p>
+</div>
</div>
</div>
<div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
</body>
</html> \ No newline at end of file
diff --git a/reference/html/FlatpakRemoteRef.html b/reference/html/FlatpakRemoteRef.html
index 974e51e6..a955ec49 100644
--- a/reference/html/FlatpakRemoteRef.html
+++ b/reference/html/FlatpakRemoteRef.html
@@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>FlatpakRemoteRef: Flatpak Library Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Flatpak Library Reference Manual">
<link rel="up" href="ch01.html" title="Flatpak">
-<link rel="prev" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef">
+<link rel="prev" href="FlatpakRelatedRef.html" title="FlatpakRelatedRef">
<link rel="next" href="FlatpakRemote.html" title="FlatpakRemote">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -21,7 +21,7 @@
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
-<td><a accesskey="p" href="FlatpakInstalledRef.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="p" href="FlatpakRelatedRef.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="FlatpakRemote.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
@@ -35,7 +35,7 @@
</tr></table></div>
<div class="refsect1">
<a name="FlatpakRemoteRef.functions"></a><h2>Functions</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
@@ -51,7 +51,7 @@
</div>
<div class="refsect1">
<a name="FlatpakRemoteRef.properties"></a><h2>Properties</h2>
-<div class="informaltable"><table border="0">
+<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
@@ -59,7 +59,7 @@
</colgroup>
<tbody><tr>
<td class="property_type">
-<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
+<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="FlatpakRemoteRef.html#FlatpakRemoteRef--remote-name" title="The “remote-name” property">remote-name</a></td>
<td class="property_flags">Read / Write</td>
</tr></tbody>
@@ -67,7 +67,7 @@
</div>
<div class="refsect1">
<a name="FlatpakRemoteRef.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
@@ -80,7 +80,7 @@
</div>
<div class="refsect1">
<a name="FlatpakRemoteRef.object-hierarchy"></a><h2>Object Hierarchy</h2>
-<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
+<pre class="screen"> GObject
<span class="lineart">╰──</span> <a class="link" href="FlatpakRef.html" title="FlatpakRef">FlatpakRef</a>
<span class="lineart">╰──</span> FlatpakRemoteRef
</pre>
@@ -99,7 +99,7 @@ flatpak_remote_ref_get_remote_name (<em class="parameter"><code><a class="link"
<p>Gets the remote name of the ref.</p>
<div class="refsect3">
<a name="flatpak-remote-ref-get-remote-name.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -114,7 +114,7 @@ flatpak_remote_ref_get_remote_name (<em class="parameter"><code><a class="link"
</div>
<div class="refsect3">
<a name="flatpak-remote-ref-get-remote-name.returns"></a><h4>Returns</h4>
-<p> the remote name. </p>
+<p>the remote name. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
@@ -130,7 +130,7 @@ flatpak_remote_ref_get_remote_name (<em class="parameter"><code><a class="link"
<a name="FlatpakRemoteRef.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="FlatpakRemoteRef--remote-name"></a><h3>The <code class="literal">“remote-name”</code> property</h3>
-<pre class="programlisting"> “remote-name” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
+<pre class="programlisting"> “remote-name” <span class="type">gchar</span> *</pre>
<p>The name of the remote.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@@ -138,6 +138,6 @@ flatpak_remote_ref_get_remote_name (<em class="parameter"><code><a class="link"
</div>
</div>
<div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
</body>
</html> \ No newline at end of file
diff --git a/reference/html/annotation-glossary.html b/reference/html/annotation-glossary.html
index 43dfee49..5da218af 100644
--- a/reference/html/annotation-glossary.html
+++ b/reference/html/annotation-glossary.html
@@ -3,17 +3,19 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Annotation Glossary: Flatpak Library Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Flatpak Library Reference Manual">
<link rel="up" href="index.html" title="Flatpak Library Reference Manual">
<link rel="prev" href="full-api-index.html" title="API Index">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts"><span id="nav_glossary"><a class="shortcut" href="#glsA">A</a>
 <span class="dim">|</span> 
+ <a class="shortcut" href="#glsC">C</a>
+  <span class="dim">|</span> 
<a class="shortcut" href="#glsE">E</a>
 <span class="dim">|</span> 
<a class="shortcut" href="#glsN">N</a>
@@ -34,6 +36,11 @@
<a name="glsA"></a><h3 class="title">A</h3>
<dt><span class="glossterm"><a name="annotation-glossterm-allow-none"></a>allow-none</span></dt>
<dd class="glossdef"><p>NULL is OK, both for passing and for returning.</p></dd>
+<dt><span class="glossterm"><a name="annotation-glossterm-array"></a>array</span></dt>
+<dd class="glossdef"><p>Parameter points to an array of items.</p></dd>
+<a name="glsC"></a><h3 class="title">C</h3>
+<dt><span class="glossterm"><a name="annotation-glossterm-closure"></a>closure</span></dt>
+<dd class="glossdef"><p>This parameter is a 'user_data', for callbacks; many bindings can pass NULL here.</p></dd>
<a name="glsE"></a><h3 class="title">E</h3>
<dt><span class="glossterm"><a name="annotation-glossterm-element-type"></a>element-type</span></dt>
<dd class="glossdef"><p>Generics and defining elements of containers and arrays.</p></dd>
@@ -55,6 +62,6 @@
<dd class="glossdef"><p>Don't free data after the code is done.</p></dd>
</div>
<div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
</body>
</html> \ No newline at end of file
diff --git a/reference/html/ch01.html b/reference/html/ch01.html
index d7ddc588..46463197 100644
--- a/reference/html/ch01.html
+++ b/reference/html/ch01.html
@@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Flatpak: Flatpak Library Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Flatpak Library Reference Manual">
<link rel="up" href="index.html" title="Flatpak Library Reference Manual">
<link rel="prev" href="index.html" title="Flatpak Library Reference Manual">
<link rel="next" href="FlatpakInstallation.html" title="FlatpakInstallation">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -33,6 +33,9 @@
<span class="refentrytitle"><a href="FlatpakInstalledRef.html">FlatpakInstalledRef</a></span><span class="refpurpose"> — Installed application reference</span>
</dt>
<dt>
+<span class="refentrytitle"><a href="FlatpakRelatedRef.html">FlatpakRelatedRef</a></span><span class="refpurpose"> — Related application reference</span>
+</dt>
+<dt>
<span class="refentrytitle"><a href="FlatpakRemoteRef.html">FlatpakRemoteRef</a></span><span class="refpurpose"> — Remote application reference</span>
</dt>
<dt>
@@ -50,6 +53,6 @@
</dl></div>
</div>
<div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
</body>
</html> \ No newline at end of file
diff --git a/reference/html/flatpak-Error-codes.html b/reference/html/flatpak-Error-codes.html
index 19beec39..c0520936 100644
--- a/reference/html/flatpak-Error-codes.html
+++ b/reference/html/flatpak-Error-codes.html
@@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Error codes: Flatpak Library Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Flatpak Library Reference Manual">
<link rel="up" href="ch01.html" title="Flatpak">
<link rel="prev" href="flatpak-flatpak-bundle-ref.html" title="flatpak-bundle-ref">
<link rel="next" href="flatpak-Version-information.html" title="Version information">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -33,14 +33,14 @@
</tr></table></div>
<div class="refsect1">
<a name="flatpak-Error-codes.functions"></a><h2>Functions</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody><tr>
<td class="function_type">
-<a href="../glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a>
+<span class="returnvalue">GQuark</span>
</td>
<td class="function_name">
<a class="link" href="flatpak-Error-codes.html#flatpak-error-quark" title="flatpak_error_quark ()">flatpak_error_quark</a> <span class="c_punctuation">()</span>
@@ -50,7 +50,7 @@
</div>
<div class="refsect1">
<a name="flatpak-Error-codes.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
@@ -74,7 +74,7 @@
<a name="flatpak-Error-codes.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="flatpak-error-quark"></a><h3>flatpak_error_quark ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a>
+<pre class="programlisting"><span class="returnvalue">GQuark</span>
flatpak_error_quark (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
</div>
</div>
@@ -91,7 +91,7 @@ flatpak_error_quark (<em class="parameter"><code><span class="type">void</span><
<p>Error codes for library functions.</p>
<div class="refsect3">
<a name="FlatpakError.members"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
@@ -112,6 +112,14 @@ flatpak_error_quark (<em class="parameter"><code><span class="type">void</span><
</td>
<td class="enum_member_annotations"> </td>
</tr>
+<tr>
+<td class="enum_member_name"><p><a name="FLATPAK-ERROR-ONLY-PULLED:CAPS"></a>FLATPAK_ERROR_ONLY_PULLED</p></td>
+<td class="enum_member_description">
+<p>App/runtime was only pulled into the local
+ repository but not installed.</p>
+</td>
+<td class="enum_member_annotations"> </td>
+</tr>
</tbody>
</table></div>
</div>
@@ -119,6 +127,6 @@ flatpak_error_quark (<em class="parameter"><code><span class="type">void</span><
</div>
</div>
<div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
</body>
</html> \ No newline at end of file
diff --git a/reference/html/flatpak-Version-information.html b/reference/html/flatpak-Version-information.html
index 03bbaede..24b3458b 100644
--- a/reference/html/flatpak-Version-information.html
+++ b/reference/html/flatpak-Version-information.html
@@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Version information: Flatpak Library Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Flatpak Library Reference Manual">
<link rel="up" href="ch01.html" title="Flatpak">
<link rel="prev" href="flatpak-Error-codes.html" title="Error codes">
<link rel="next" href="object-tree.html" title="Object Hierarchy">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -32,8 +32,23 @@
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
+<a name="flatpak-Version-information.functions"></a><h2>Functions</h2>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="functions_return">
+<col class="functions_name">
+</colgroup>
+<tbody><tr>
+<td class="define_keyword">#define</td>
+<td class="function_name">
+<a class="link" href="flatpak-Version-information.html#FLATPAK-CHECK-VERSION:CAPS" title="FLATPAK_CHECK_VERSION()">FLATPAK_CHECK_VERSION</a><span class="c_punctuation">()</span>
+</td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect1">
<a name="flatpak-Version-information.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
@@ -63,7 +78,10 @@
</div>
<div class="refsect1">
<a name="flatpak-Version-information.functions_details"></a><h2>Functions</h2>
-<p></p>
+<div class="refsect2">
+<a name="FLATPAK-CHECK-VERSION:CAPS"></a><h3>FLATPAK_CHECK_VERSION()</h3>
+<pre class="programlisting">#define FLATPAK_CHECK_VERSION(major,minor,micro)</pre>
+</div>
</div>
<div class="refsect1">
<a name="flatpak-Version-information.other_details"></a><h2>Types and Values</h2>
@@ -75,13 +93,13 @@
<hr>
<div class="refsect2">
<a name="FLATPAK-MINOR-VERSION:CAPS"></a><h3>FLATPAK_MINOR_VERSION</h3>
-<pre class="programlisting">#define FLATPAK_MINOR_VERSION (6)
+<pre class="programlisting">#define FLATPAK_MINOR_VERSION (11)
</pre>
</div>
<hr>
<div class="refsect2">
<a name="FLATPAK-MICRO-VERSION:CAPS"></a><h3>FLATPAK_MICRO_VERSION</h3>
-<pre class="programlisting">#define FLATPAK_MICRO_VERSION (13)
+<pre class="programlisting">#define FLATPAK_MICRO_VERSION (3)
</pre>
</div>
<hr>
@@ -93,6 +111,6 @@
</div>
</div>
<div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
</body>
</html> \ No newline at end of file
diff --git a/reference/html/flatpak-flatpak-bundle-ref.html b/reference/html/flatpak-flatpak-bundle-ref.html
index 4ba60519..6c63c5b3 100644
--- a/reference/html/flatpak-flatpak-bundle-ref.html
+++ b/reference/html/flatpak-flatpak-bundle-ref.html
@@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>flatpak-bundle-ref: Flatpak Library Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Flatpak Library Reference Manual">
<link rel="up" href="ch01.html" title="Flatpak">
<link rel="prev" href="FlatpakRemote.html" title="FlatpakRemote">
<link rel="next" href="flatpak-Error-codes.html" title="Error codes">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -35,7 +35,7 @@
</tr></table></div>
<div class="refsect1">
<a name="flatpak-flatpak-bundle-ref.functions"></a><h2>Functions</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
@@ -51,7 +51,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
+<span class="returnvalue">GFile</span> *
</td>
<td class="function_name">
<a class="link" href="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-get-file" title="flatpak_bundle_ref_get_file ()">flatpak_bundle_ref_get_file</a> <span class="c_punctuation">()</span>
@@ -59,7 +59,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> *
+<span class="returnvalue">GBytes</span> *
</td>
<td class="function_name">
<a class="link" href="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-get-metadata" title="flatpak_bundle_ref_get_metadata ()">flatpak_bundle_ref_get_metadata</a> <span class="c_punctuation">()</span>
@@ -67,7 +67,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> *
+<span class="returnvalue">GBytes</span> *
</td>
<td class="function_name">
<a class="link" href="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-get-appstream" title="flatpak_bundle_ref_get_appstream ()">flatpak_bundle_ref_get_appstream</a> <span class="c_punctuation">()</span>
@@ -75,7 +75,7 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> *
+<span class="returnvalue">GBytes</span> *
</td>
<td class="function_name">
<a class="link" href="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-get-icon" title="flatpak_bundle_ref_get_icon ()">flatpak_bundle_ref_get_icon</a> <span class="c_punctuation">()</span>
@@ -91,18 +91,26 @@
</tr>
<tr>
<td class="function_type">
-<a href="../glib/glib-Basic-Types.html#guint64"><span class="returnvalue">guint64</span></a>
+<span class="returnvalue">guint64</span>
</td>
<td class="function_name">
<a class="link" href="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-get-installed-size" title="flatpak_bundle_ref_get_installed_size ()">flatpak_bundle_ref_get_installed_size</a> <span class="c_punctuation">()</span>
</td>
</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">char</span> *
+</td>
+<td class="function_name">
+<a class="link" href="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-get-runtime-repo-url" title="flatpak_bundle_ref_get_runtime_repo_url ()">flatpak_bundle_ref_get_runtime_repo_url</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="flatpak-flatpak-bundle-ref.properties"></a><h2>Properties</h2>
-<div class="informaltable"><table border="0">
+<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
@@ -110,7 +118,7 @@
</colgroup>
<tbody><tr>
<td class="property_type">
-<a href="../gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *</td>
+<span class="type">GFile</span> *</td>
<td class="property_name"><a class="link" href="flatpak-flatpak-bundle-ref.html#FlatpakBundleRef--file" title="The “file” property">file</a></td>
<td class="property_flags">Read / Write</td>
</tr></tbody>
@@ -118,7 +126,7 @@
</div>
<a name="FlatpakBundleRef"></a><div class="refsect1">
<a name="flatpak-flatpak-bundle-ref.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
@@ -131,7 +139,7 @@
</div>
<div class="refsect1">
<a name="flatpak-flatpak-bundle-ref.object-hierarchy"></a><h2>Object Hierarchy</h2>
-<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
+<pre class="screen"> GObject
<span class="lineart">╰──</span> <a class="link" href="FlatpakRef.html" title="FlatpakRef">FlatpakRef</a>
<span class="lineart">╰──</span> FlatpakBundleRef
</pre>
@@ -144,12 +152,12 @@
<div class="refsect2">
<a name="flatpak-bundle-ref-new"></a><h3>flatpak_bundle_ref_new ()</h3>
<pre class="programlisting"><a class="link" href="flatpak-flatpak-bundle-ref.html#FlatpakBundleRef"><span class="returnvalue">FlatpakBundleRef</span></a> *
-flatpak_bundle_ref_new (<em class="parameter"><code><a href="../gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *file</code></em>,
- <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+flatpak_bundle_ref_new (<em class="parameter"><code><span class="type">GFile</span> *file</code></em>,
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Creates a new bundle ref for the given file.</p>
<div class="refsect3">
<a name="flatpak-bundle-ref-new.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -158,12 +166,12 @@ flatpak_bundle_ref_new (<em class="parameter"><code><a href="../gio/GFile.html#G
<tbody>
<tr>
<td class="parameter_name"><p>file</p></td>
-<td class="parameter_description"><p>a <a href="../gio/GFile.html#GFile-struct"><span class="type">GFile</span></a></p></td>
+<td class="parameter_description"><p>a <span class="type">GFile</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
-<td class="parameter_description"><p> return location for an error. </p></td>
+<td class="parameter_description"><p>return location for an error. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@@ -177,12 +185,12 @@ flatpak_bundle_ref_new (<em class="parameter"><code><a href="../gio/GFile.html#G
<hr>
<div class="refsect2">
<a name="flatpak-bundle-ref-get-file"></a><h3>flatpak_bundle_ref_get_file ()</h3>
-<pre class="programlisting"><a href="../gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
+<pre class="programlisting"><span class="returnvalue">GFile</span> *
flatpak_bundle_ref_get_file (<em class="parameter"><code><a class="link" href="flatpak-flatpak-bundle-ref.html#FlatpakBundleRef"><span class="type">FlatpakBundleRef</span></a> *self</code></em>);</pre>
<p>Get the file this bundle is stored in.</p>
<div class="refsect3">
<a name="flatpak-bundle-ref-get-file.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -197,18 +205,18 @@ flatpak_bundle_ref_get_file (<em class="parameter"><code><a class="link" href="f
</div>
<div class="refsect3">
<a name="flatpak-bundle-ref-get-file.returns"></a><h4>Returns</h4>
-<p> (transfer full) : an <a href="../gio/GFile.html#GFile-struct"><span class="type">GFile</span></a></p>
+<p> (transfer full) : an <span class="type">GFile</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-bundle-ref-get-metadata"></a><h3>flatpak_bundle_ref_get_metadata ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> *
+<pre class="programlisting"><span class="returnvalue">GBytes</span> *
flatpak_bundle_ref_get_metadata (<em class="parameter"><code><a class="link" href="flatpak-flatpak-bundle-ref.html#FlatpakBundleRef"><span class="type">FlatpakBundleRef</span></a> *self</code></em>);</pre>
<p>Get the metadata for the app/runtime</p>
<div class="refsect3">
<a name="flatpak-bundle-ref-get-metadata.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -223,18 +231,18 @@ flatpak_bundle_ref_get_metadata (<em class="parameter"><code><a class="link" hre
</div>
<div class="refsect3">
<a name="flatpak-bundle-ref-get-metadata.returns"></a><h4>Returns</h4>
-<p> (transfer full) : an <a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> with the metadata contents, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
+<p> (transfer full) : an <span class="type">GBytes</span> with the metadata contents, or <code class="literal">NULL</code></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-bundle-ref-get-appstream"></a><h3>flatpak_bundle_ref_get_appstream ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> *
+<pre class="programlisting"><span class="returnvalue">GBytes</span> *
flatpak_bundle_ref_get_appstream (<em class="parameter"><code><a class="link" href="flatpak-flatpak-bundle-ref.html#FlatpakBundleRef"><span class="type">FlatpakBundleRef</span></a> *self</code></em>);</pre>
<p>Get the compressed appstream for the app/runtime</p>
<div class="refsect3">
<a name="flatpak-bundle-ref-get-appstream.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -249,19 +257,19 @@ flatpak_bundle_ref_get_appstream (<em class="parameter"><code><a class="link" hr
</div>
<div class="refsect3">
<a name="flatpak-bundle-ref-get-appstream.returns"></a><h4>Returns</h4>
-<p> (transfer full) : an <a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> with the appstream contents, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
+<p> (transfer full) : an <span class="type">GBytes</span> with the appstream contents, or <code class="literal">NULL</code></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-bundle-ref-get-icon"></a><h3>flatpak_bundle_ref_get_icon ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> *
+<pre class="programlisting"><span class="returnvalue">GBytes</span> *
flatpak_bundle_ref_get_icon (<em class="parameter"><code><a class="link" href="flatpak-flatpak-bundle-ref.html#FlatpakBundleRef"><span class="type">FlatpakBundleRef</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">int</span> size</code></em>);</pre>
<p>Get the icon png data for the app/runtime</p>
<div class="refsect3">
<a name="flatpak-bundle-ref-get-icon.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -283,7 +291,7 @@ flatpak_bundle_ref_get_icon (<em class="parameter"><code><a class="link" href="f
</div>
<div class="refsect3">
<a name="flatpak-bundle-ref-get-icon.returns"></a><h4>Returns</h4>
-<p> (transfer full) : an <a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> with png contents</p>
+<p> (transfer full) : an <span class="type">GBytes</span> with png contents</p>
</div>
</div>
<hr>
@@ -294,7 +302,7 @@ flatpak_bundle_ref_get_origin (<em class="parameter"><code><a class="link" href=
<p>Get the origin url stored in the bundle</p>
<div class="refsect3">
<a name="flatpak-bundle-ref-get-origin.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -309,18 +317,18 @@ flatpak_bundle_ref_get_origin (<em class="parameter"><code><a class="link" href=
</div>
<div class="refsect3">
<a name="flatpak-bundle-ref-get-origin.returns"></a><h4>Returns</h4>
-<p> (transfer full) : an url string, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
+<p> (transfer full) : an url string, or <code class="literal">NULL</code></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="flatpak-bundle-ref-get-installed-size"></a><h3>flatpak_bundle_ref_get_installed_size ()</h3>
-<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint64"><span class="returnvalue">guint64</span></a>
+<pre class="programlisting"><span class="returnvalue">guint64</span>
flatpak_bundle_ref_get_installed_size (<em class="parameter"><code><a class="link" href="flatpak-flatpak-bundle-ref.html#FlatpakBundleRef"><span class="type">FlatpakBundleRef</span></a> *self</code></em>);</pre>
<p>Returns the installed size for the bundle.</p>
<div class="refsect3">
<a name="flatpak-bundle-ref-get-installed-size.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
@@ -338,6 +346,13 @@ flatpak_bundle_ref_get_installed_size (<em class="parameter"><code><a class="lin
<p> the installed size</p>
</div>
</div>
+<hr>
+<div class="refsect2">
+<a name="flatpak-bundle-ref-get-runtime-repo-url"></a><h3>flatpak_bundle_ref_get_runtime_repo_url ()</h3>
+<pre class="programlisting"><span class="returnvalue">char</span> *
+flatpak_bundle_ref_get_runtime_repo_url
+ (<em class="parameter"><code><a class="link" href="flatpak-flatpak-bundle-ref.html#FlatpakBundleRef"><span class="type">FlatpakBundleRef</span></a> *self</code></em>);</pre>
+</div>
</div>
<div class="refsect1">
<a name="flatpak-flatpak-bundle-ref.other_details"></a><h2>Types and Values</h2>
@@ -350,12 +365,12 @@ flatpak_bundle_ref_get_installed_size (<em class="parameter"><code><a class="lin
<a name="flatpak-flatpak-bundle-ref.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="FlatpakBundleRef--file"></a><h3>The <code class="literal">“file”</code> property</h3>
-<pre class="programlisting"> “file” <a href="../gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *</pre>
+<pre class="programlisting"> “file” <span class="type">GFile</span> *</pre>
<p>Flags: Read / Write</p>
</div>
</div>
</div>
<div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
</body>
</html> \ No newline at end of file
diff --git a/reference/html/flatpak.devhelp2 b/reference/html/flatpak.devhelp2
index 023c2e18..1122dd00 100644
--- a/reference/html/flatpak.devhelp2
+++ b/reference/html/flatpak.devhelp2
@@ -5,6 +5,7 @@
<sub name="FlatpakInstallation" link="FlatpakInstallation.html"/>
<sub name="FlatpakRef" link="FlatpakRef.html"/>
<sub name="FlatpakInstalledRef" link="FlatpakInstalledRef.html"/>
+ <sub name="FlatpakRelatedRef" link="FlatpakRelatedRef.html"/>
<sub name="FlatpakRemoteRef" link="FlatpakRemoteRef.html"/>
<sub name="FlatpakRemote" link="FlatpakRemote.html"/>
<sub name="flatpak-bundle-ref" link="flatpak-flatpak-bundle-ref.html"/>
@@ -17,21 +18,30 @@
</chapters>
<functions>
<keyword type="function" name="flatpak_installation_new_system ()" link="FlatpakInstallation.html#flatpak-installation-new-system"/>
+ <keyword type="function" name="flatpak_installation_new_system_with_id ()" link="FlatpakInstallation.html#flatpak-installation-new-system-with-id" since="0.8"/>
<keyword type="function" name="flatpak_installation_new_user ()" link="FlatpakInstallation.html#flatpak-installation-new-user"/>
<keyword type="function" name="flatpak_installation_new_for_path ()" link="FlatpakInstallation.html#flatpak-installation-new-for-path"/>
<keyword type="function" name="flatpak_installation_get_is_user ()" link="FlatpakInstallation.html#flatpak-installation-get-is-user"/>
<keyword type="function" name="flatpak_installation_get_path ()" link="FlatpakInstallation.html#flatpak-installation-get-path"/>
<keyword type="function" name="flatpak_installation_create_monitor ()" link="FlatpakInstallation.html#flatpak-installation-create-monitor"/>
<keyword type="function" name="flatpak_installation_install ()" link="FlatpakInstallation.html#flatpak-installation-install"/>
+ <keyword type="function" name="flatpak_installation_install_full ()" link="FlatpakInstallation.html#flatpak-installation-install-full"/>
<keyword type="function" name="flatpak_installation_update ()" link="FlatpakInstallation.html#flatpak-installation-update"/>
+ <keyword type="function" name="flatpak_installation_update_full ()" link="FlatpakInstallation.html#flatpak-installation-update-full"/>
<keyword type="function" name="flatpak_installation_uninstall ()" link="FlatpakInstallation.html#flatpak-installation-uninstall"/>
<keyword type="function" name="flatpak_installation_launch ()" link="FlatpakInstallation.html#flatpak-installation-launch"/>
<keyword type="function" name="flatpak_installation_get_current_installed_app ()" link="FlatpakInstallation.html#flatpak-installation-get-current-installed-app"/>
+ <keyword type="function" name="flatpak_installation_get_display_name ()" link="FlatpakInstallation.html#flatpak-installation-get-display-name" since="0.8"/>
+ <keyword type="function" name="flatpak_installation_get_id ()" link="FlatpakInstallation.html#flatpak-installation-get-id" since="0.8"/>
<keyword type="function" name="flatpak_installation_get_installed_ref ()" link="FlatpakInstallation.html#flatpak-installation-get-installed-ref"/>
+ <keyword type="function" name="flatpak_installation_get_priority ()" link="FlatpakInstallation.html#flatpak-installation-get-priority" since="0.8"/>
+ <keyword type="function" name="flatpak_installation_get_storage_type ()" link="FlatpakInstallation.html#flatpak-installation-get-storage-type" since="0.8"/>
<keyword type="function" name="flatpak_installation_list_installed_refs ()" link="FlatpakInstallation.html#flatpak-installation-list-installed-refs"/>
<keyword type="function" name="flatpak_installation_list_installed_refs_by_kind ()" link="FlatpakInstallation.html#flatpak-installation-list-installed-refs-by-kind"/>
<keyword type="function" name="flatpak_installation_list_installed_refs_for_update ()" link="FlatpakInstallation.html#flatpak-installation-list-installed-refs-for-update"/>
+ <keyword type="function" name="flatpak_installation_list_installed_related_refs_sync ()" link="FlatpakInstallation.html#flatpak-installation-list-installed-related-refs-sync" since="0.6.7"/>
<keyword type="function" name="flatpak_installation_list_remote_refs_sync ()" link="FlatpakInstallation.html#flatpak-installation-list-remote-refs-sync"/>
+ <keyword type="function" name="flatpak_installation_list_remote_related_refs_sync ()" link="FlatpakInstallation.html#flatpak-installation-list-remote-related-refs-sync" since="0.6.7"/>
<keyword type="function" name="flatpak_installation_list_remotes ()" link="FlatpakInstallation.html#flatpak-installation-list-remotes"/>
<keyword type="function" name="flatpak_installation_get_remote_by_name ()" link="FlatpakInstallation.html#flatpak-installation-get-remote-by-name"/>
<keyword type="function" name="flatpak_installation_fetch_remote_metadata_sync ()" link="FlatpakInstallation.html#flatpak-installation-fetch-remote-metadata-sync"/>
@@ -40,17 +50,29 @@
<keyword type="function" name="flatpak_installation_load_app_overrides ()" link="FlatpakInstallation.html#flatpak-installation-load-app-overrides"/>
<keyword type="function" name="flatpak_installation_update_appstream_sync ()" link="FlatpakInstallation.html#flatpak-installation-update-appstream-sync"/>
<keyword type="function" name="flatpak_installation_install_bundle ()" link="FlatpakInstallation.html#flatpak-installation-install-bundle"/>
+ <keyword type="function" name="flatpak_installation_install_ref_file ()" link="FlatpakInstallation.html#flatpak-installation-install-ref-file" since="0.6.10"/>
<keyword type="function" name="flatpak_installation_drop_caches ()" link="FlatpakInstallation.html#flatpak-installation-drop-caches"/>
<keyword type="function" name="flatpak_installation_modify_remote ()" link="FlatpakInstallation.html#flatpak-installation-modify-remote"/>
<keyword type="function" name="flatpak_installation_remove_remote ()" link="FlatpakInstallation.html#flatpak-installation-remove-remote"/>
<keyword type="function" name="flatpak_installation_update_remote_sync ()" link="FlatpakInstallation.html#flatpak-installation-update-remote-sync" since="0.6.13"/>
+ <keyword type="function" name="flatpak_installation_cleanup_local_refs_sync ()" link="FlatpakInstallation.html#flatpak-installation-cleanup-local-refs-sync" since="0.10.0"/>
+ <keyword type="function" name="flatpak_installation_get_config ()" link="FlatpakInstallation.html#flatpak-installation-get-config"/>
+ <keyword type="function" name="flatpak_installation_prune_local_repo ()" link="FlatpakInstallation.html#flatpak-installation-prune-local-repo"/>
+ <keyword type="function" name="flatpak_installation_remove_local_ref_sync ()" link="FlatpakInstallation.html#flatpak-installation-remove-local-ref-sync"/>
+ <keyword type="function" name="flatpak_installation_set_config_sync ()" link="FlatpakInstallation.html#flatpak-installation-set-config-sync"/>
+ <keyword type="function" name="flatpak_installation_update_appstream_full_sync ()" link="FlatpakInstallation.html#flatpak-installation-update-appstream-full-sync"/>
<keyword type="function" name="flatpak_get_default_arch ()" link="FlatpakInstallation.html#flatpak-get-default-arch"/>
+ <keyword type="function" name="flatpak_get_supported_arches ()" link="FlatpakInstallation.html#flatpak-get-supported-arches"/>
+ <keyword type="function" name="flatpak_get_system_installations ()" link="FlatpakInstallation.html#flatpak-get-system-installations" since="0.8"/>
<keyword type="function" name="FlatpakProgressCallback ()" link="FlatpakInstallation.html#FlatpakProgressCallback"/>
<keyword type="struct" name="struct FlatpakInstallation" link="FlatpakInstallation.html#FlatpakInstallation-struct"/>
<keyword type="enum" name="enum FlatpakUpdateFlags" link="FlatpakInstallation.html#FlatpakUpdateFlags"/>
+ <keyword type="enum" name="enum FlatpakInstallFlags" link="FlatpakInstallation.html#FlatpakInstallFlags"/>
+ <keyword type="enum" name="enum FlatpakStorageType" link="FlatpakInstallation.html#FlatpakStorageType" since="0.6.15"/>
<keyword type="function" name="flatpak_ref_format_ref ()" link="FlatpakRef.html#flatpak-ref-format-ref"/>
<keyword type="function" name="flatpak_ref_get_arch ()" link="FlatpakRef.html#flatpak-ref-get-arch"/>
<keyword type="function" name="flatpak_ref_get_branch ()" link="FlatpakRef.html#flatpak-ref-get-branch"/>
+ <keyword type="function" name="flatpak_ref_get_collection_id ()" link="FlatpakRef.html#flatpak-ref-get-collection-id"/>
<keyword type="function" name="flatpak_ref_get_commit ()" link="FlatpakRef.html#flatpak-ref-get-commit"/>
<keyword type="function" name="flatpak_ref_get_kind ()" link="FlatpakRef.html#flatpak-ref-get-kind"/>
<keyword type="function" name="flatpak_ref_get_name ()" link="FlatpakRef.html#flatpak-ref-get-name"/>
@@ -59,6 +81,7 @@
<keyword type="enum" name="enum FlatpakRefKind" link="FlatpakRef.html#FlatpakRefKind"/>
<keyword type="property" name="The “arch” property" link="FlatpakRef.html#FlatpakRef--arch"/>
<keyword type="property" name="The “branch” property" link="FlatpakRef.html#FlatpakRef--branch"/>
+ <keyword type="property" name="The “collection-id” property" link="FlatpakRef.html#FlatpakRef--collection-id"/>
<keyword type="property" name="The “commit” property" link="FlatpakRef.html#FlatpakRef--commit"/>
<keyword type="property" name="The “kind” property" link="FlatpakRef.html#FlatpakRef--kind"/>
<keyword type="property" name="The “name” property" link="FlatpakRef.html#FlatpakRef--name"/>
@@ -76,6 +99,14 @@
<keyword type="property" name="The “latest-commit” property" link="FlatpakInstalledRef.html#FlatpakInstalledRef--latest-commit"/>
<keyword type="property" name="The “origin” property" link="FlatpakInstalledRef.html#FlatpakInstalledRef--origin"/>
<keyword type="property" name="The “subpaths” property" link="FlatpakInstalledRef.html#FlatpakInstalledRef--subpaths"/>
+ <keyword type="function" name="flatpak_related_ref_new ()" link="FlatpakRelatedRef.html#flatpak-related-ref-new"/>
+ <keyword type="function" name="flatpak_related_ref_get_subpaths ()" link="FlatpakRelatedRef.html#flatpak-related-ref-get-subpaths" since="0.6.7"/>
+ <keyword type="function" name="flatpak_related_ref_should_download ()" link="FlatpakRelatedRef.html#flatpak-related-ref-should-download"/>
+ <keyword type="function" name="flatpak_related_ref_should_delete ()" link="FlatpakRelatedRef.html#flatpak-related-ref-should-delete" since="0.6.7"/>
+ <keyword type="struct" name="struct FlatpakRelatedRef" link="FlatpakRelatedRef.html#FlatpakRelatedRef-struct"/>
+ <keyword type="property" name="The “should-delete” property" link="FlatpakRelatedRef.html#FlatpakRelatedRef--should-delete"/>
+ <keyword type="property" name="The “should-download” property" link="FlatpakRelatedRef.html#FlatpakRelatedRef--should-download"/>
+ <keyword type="property" name="The “subpaths” property" link="FlatpakRelatedRef.html#FlatpakRelatedRef--subpaths"/>
<keyword type="function" name="flatpak_remote_ref_get_remote_name ()" link="FlatpakRemoteRef.html#flatpak-remote-ref-get-remote-name"/>
<keyword type="struct" name="struct FlatpakRemoteRef" link="FlatpakRemoteRef.html#FlatpakRemoteRef-struct"/>
<keyword type="property" name="The “remote-name” property" link="FlatpakRemoteRef.html#FlatpakRemoteRef--remote-name"/>
@@ -83,13 +114,20 @@
<keyword type="function" name="flatpak_remote_get_name ()" link="FlatpakRemote.html#flatpak-remote-get-name"/>
<keyword type="function" name="flatpak_remote_get_appstream_dir ()" link="FlatpakRemote.html#flatpak-remote-get-appstream-dir"/>
<keyword type="function" name="flatpak_remote_get_appstream_timestamp ()" link="FlatpakRemote.html#flatpak-remote-get-appstream-timestamp"/>
+ <keyword type="function" name="flatpak_remote_get_collection_id ()" link="FlatpakRemote.html#flatpak-remote-get-collection-id"/>
+ <keyword type="function" name="flatpak_remote_set_collection_id ()" link="FlatpakRemote.html#flatpak-remote-set-collection-id"/>
+ <keyword type="function" name="flatpak_remote_get_default_branch ()" link="FlatpakRemote.html#flatpak-remote-get-default-branch" since="0.6.12"/>
+ <keyword type="function" name="flatpak_remote_set_default_branch ()" link="FlatpakRemote.html#flatpak-remote-set-default-branch" since="0.6.12"/>
<keyword type="function" name="flatpak_remote_get_gpg_verify ()" link="FlatpakRemote.html#flatpak-remote-get-gpg-verify"/>
<keyword type="function" name="flatpak_remote_set_gpg_verify ()" link="FlatpakRemote.html#flatpak-remote-set-gpg-verify"/>
<keyword type="function" name="flatpak_remote_set_gpg_key ()" link="FlatpakRemote.html#flatpak-remote-set-gpg-key"/>
+ <keyword type="function" name="flatpak_remote_get_nodeps ()" link="FlatpakRemote.html#flatpak-remote-get-nodeps"/>
+ <keyword type="function" name="flatpak_remote_set_nodeps ()" link="FlatpakRemote.html#flatpak-remote-set-nodeps"/>
<keyword type="function" name="flatpak_remote_get_noenumerate ()" link="FlatpakRemote.html#flatpak-remote-get-noenumerate"/>
<keyword type="function" name="flatpak_remote_set_noenumerate ()" link="FlatpakRemote.html#flatpak-remote-set-noenumerate"/>
<keyword type="function" name="flatpak_remote_get_prio ()" link="FlatpakRemote.html#flatpak-remote-get-prio"/>
<keyword type="function" name="flatpak_remote_set_prio ()" link="FlatpakRemote.html#flatpak-remote-set-prio"/>
+ <keyword type="function" name="flatpak_remote_get_remote_type ()" link="FlatpakRemote.html#flatpak-remote-get-remote-type" since="0.9.8"/>
<keyword type="function" name="flatpak_remote_get_title ()" link="FlatpakRemote.html#flatpak-remote-get-title"/>
<keyword type="function" name="flatpak_remote_set_title ()" link="FlatpakRemote.html#flatpak-remote-set-title"/>
<keyword type="function" name="flatpak_remote_get_url ()" link="FlatpakRemote.html#flatpak-remote-get-url"/>
@@ -97,7 +135,9 @@
<keyword type="function" name="flatpak_remote_get_disabled ()" link="FlatpakRemote.html#flatpak-remote-get-disabled"/>
<keyword type="function" name="flatpak_remote_set_disabled ()" link="FlatpakRemote.html#flatpak-remote-set-disabled"/>
<keyword type="struct" name="struct FlatpakRemote" link="FlatpakRemote.html#FlatpakRemote-struct"/>
+ <keyword type="enum" name="enum FlatpakRemoteType" link="FlatpakRemote.html#FlatpakRemoteType"/>
<keyword type="property" name="The “name” property" link="FlatpakRemote.html#FlatpakRemote--name"/>
+ <keyword type="property" name="The “type” property" link="FlatpakRemote.html#FlatpakRemote--type"/>
<keyword type="function" name="flatpak_bundle_ref_new ()" link="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-new"/>
<keyword type="function" name="flatpak_bundle_ref_get_file ()" link="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-get-file"/>
<keyword type="function" name="flatpak_bundle_ref_get_metadata ()" link="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-get-metadata"/>
@@ -105,11 +145,13 @@
<keyword type="function" name="flatpak_bundle_ref_get_icon ()" link="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-get-icon"/>
<keyword type="function" name="flatpak_bundle_ref_get_origin ()" link="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-get-origin"/>
<keyword type="function" name="flatpak_bundle_ref_get_installed_size ()" link="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-get-installed-size"/>
+ <keyword type="function" name="flatpak_bundle_ref_get_runtime_repo_url ()" link="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-get-runtime-repo-url"/>
<keyword type="struct" name="struct FlatpakBundleRef" link="flatpak-flatpak-bundle-ref.html#FlatpakBundleRef-struct"/>
<keyword type="property" name="The “file” property" link="flatpak-flatpak-bundle-ref.html#FlatpakBundleRef--file"/>
<keyword type="function" name="flatpak_error_quark ()" link="flatpak-Error-codes.html#flatpak-error-quark"/>
<keyword type="macro" name="FLATPAK_ERROR" link="flatpak-Error-codes.html#FLATPAK-ERROR:CAPS"/>
<keyword type="enum" name="enum FlatpakError" link="flatpak-Error-codes.html#FlatpakError"/>
+ <keyword type="macro" name="FLATPAK_CHECK_VERSION()" link="flatpak-Version-information.html#FLATPAK-CHECK-VERSION:CAPS"/>
<keyword type="macro" name="FLATPAK_MAJOR_VERSION" link="flatpak-Version-information.html#FLATPAK-MAJOR-VERSION:CAPS"/>
<keyword type="macro" name="FLATPAK_MINOR_VERSION" link="flatpak-Version-information.html#FLATPAK-MINOR-VERSION:CAPS"/>
<keyword type="macro" name="FLATPAK_MICRO_VERSION" link="flatpak-Version-information.html#FLATPAK-MICRO-VERSION:CAPS"/>
@@ -117,9 +159,23 @@
<keyword type="constant" name="FLATPAK_UPDATE_FLAGS_NONE" link="FlatpakInstallation.html#FLATPAK-UPDATE-FLAGS-NONE:CAPS"/>
<keyword type="constant" name="FLATPAK_UPDATE_FLAGS_NO_DEPLOY" link="FlatpakInstallation.html#FLATPAK-UPDATE-FLAGS-NO-DEPLOY:CAPS"/>
<keyword type="constant" name="FLATPAK_UPDATE_FLAGS_NO_PULL" link="FlatpakInstallation.html#FLATPAK-UPDATE-FLAGS-NO-PULL:CAPS"/>
+ <keyword type="constant" name="FLATPAK_UPDATE_FLAGS_NO_STATIC_DELTAS" link="FlatpakInstallation.html#FLATPAK-UPDATE-FLAGS-NO-STATIC-DELTAS:CAPS"/>
+ <keyword type="constant" name="FLATPAK_INSTALL_FLAGS_NONE" link="FlatpakInstallation.html#FLATPAK-INSTALL-FLAGS-NONE:CAPS"/>
+ <keyword type="constant" name="FLATPAK_INSTALL_FLAGS_NO_STATIC_DELTAS" link="FlatpakInstallation.html#FLATPAK-INSTALL-FLAGS-NO-STATIC-DELTAS:CAPS"/>
+ <keyword type="constant" name="FLATPAK_INSTALL_FLAGS_NO_DEPLOY" link="FlatpakInstallation.html#FLATPAK-INSTALL-FLAGS-NO-DEPLOY:CAPS"/>
+ <keyword type="constant" name="FLATPAK_INSTALL_FLAGS_NO_PULL" link="FlatpakInstallation.html#FLATPAK-INSTALL-FLAGS-NO-PULL:CAPS"/>
+ <keyword type="constant" name="FLATPAK_STORAGE_TYPE_DEFAULT" link="FlatpakInstallation.html#FLATPAK-STORAGE-TYPE-DEFAULT:CAPS"/>
+ <keyword type="constant" name="FLATPAK_STORAGE_TYPE_HARD_DISK" link="FlatpakInstallation.html#FLATPAK-STORAGE-TYPE-HARD-DISK:CAPS"/>
+ <keyword type="constant" name="FLATPAK_STORAGE_TYPE_SDCARD" link="FlatpakInstallation.html#FLATPAK-STORAGE-TYPE-SDCARD:CAPS"/>
+ <keyword type="constant" name="FLATPAK_STORAGE_TYPE_MMC" link="FlatpakInstallation.html#FLATPAK-STORAGE-TYPE-MMC:CAPS"/>
+ <keyword type="constant" name="FLATPAK_STORAGE_TYPE_NETWORK" link="FlatpakInstallation.html#FLATPAK-STORAGE-TYPE-NETWORK:CAPS"/>
<keyword type="constant" name="FLATPAK_REF_KIND_APP" link="FlatpakRef.html#FLATPAK-REF-KIND-APP:CAPS"/>
<keyword type="constant" name="FLATPAK_REF_KIND_RUNTIME" link="FlatpakRef.html#FLATPAK-REF-KIND-RUNTIME:CAPS"/>
+ <keyword type="constant" name="FLATPAK_REMOTE_TYPE_STATIC" link="FlatpakRemote.html#FLATPAK-REMOTE-TYPE-STATIC:CAPS"/>
+ <keyword type="constant" name="FLATPAK_REMOTE_TYPE_USB" link="FlatpakRemote.html#FLATPAK-REMOTE-TYPE-USB:CAPS"/>
+ <keyword type="constant" name="FLATPAK_REMOTE_TYPE_LAN" link="FlatpakRemote.html#FLATPAK-REMOTE-TYPE-LAN:CAPS"/>
<keyword type="constant" name="FLATPAK_ERROR_ALREADY_INSTALLED" link="flatpak-Error-codes.html#FLATPAK-ERROR-ALREADY-INSTALLED:CAPS"/>
<keyword type="constant" name="FLATPAK_ERROR_NOT_INSTALLED" link="flatpak-Error-codes.html#FLATPAK-ERROR-NOT-INSTALLED:CAPS"/>
+ <keyword type="constant" name="FLATPAK_ERROR_ONLY_PULLED" link="flatpak-Error-codes.html#FLATPAK-ERROR-ONLY-PULLED:CAPS"/>
</functions>
</book>
diff --git a/reference/html/full-api-index.html b/reference/html/full-api-index.html
index 51c3546f..3435320e 100644
--- a/reference/html/full-api-index.html
+++ b/reference/html/full-api-index.html
@@ -3,18 +3,20 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>API Index: Flatpak Library Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Flatpak Library Reference Manual">
<link rel="up" href="index.html" title="Flatpak Library Reference Manual">
<link rel="prev" href="object-tree.html" title="Object Hierarchy">
<link rel="next" href="annotation-glossary.html" title="Annotation Glossary">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts"><span id="nav_index"><a class="shortcut" href="#idxB">B</a>
 <span class="dim">|</span> 
+ <a class="shortcut" href="#idxC">C</a>
+  <span class="dim">|</span> 
<a class="shortcut" href="#idxE">E</a>
 <span class="dim">|</span> 
<a class="shortcut" href="#idxG">G</a>
@@ -27,6 +29,8 @@
 <span class="dim">|</span> 
<a class="shortcut" href="#idxR">R</a>
 <span class="dim">|</span> 
+ <a class="shortcut" href="#idxS">S</a>
+  <span class="dim">|</span> 
<a class="shortcut" href="#idxU">U</a></span></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><img src="up-insensitive.png" width="16" height="16" border="0"></td>
@@ -70,9 +74,18 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-get-runtime-repo-url" title="flatpak_bundle_ref_get_runtime_repo_url ()">flatpak_bundle_ref_get_runtime_repo_url</a>, function in <a class="link" href="flatpak-flatpak-bundle-ref.html" title="flatpak-bundle-ref">flatpak-bundle-ref</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="flatpak-flatpak-bundle-ref.html#flatpak-bundle-ref-new" title="flatpak_bundle_ref_new ()">flatpak_bundle_ref_new</a>, function in <a class="link" href="flatpak-flatpak-bundle-ref.html" title="flatpak-bundle-ref">flatpak-bundle-ref</a>
</dt>
<dd></dd>
+<a name="idxC"></a><h3 class="title">C</h3>
+<dt>
+<a class="link" href="flatpak-Version-information.html#FLATPAK-CHECK-VERSION:CAPS" title="FLATPAK_CHECK_VERSION()">FLATPAK_CHECK_VERSION</a>, macro in <a class="link" href="flatpak-Version-information.html" title="Version information">Version information</a>
+</dt>
+<dd></dd>
<a name="idxE"></a><h3 class="title">E</h3>
<dt>
<a class="link" href="flatpak-Error-codes.html#FLATPAK-ERROR:CAPS" title="FLATPAK_ERROR">FLATPAK_ERROR</a>, macro in <a class="link" href="flatpak-Error-codes.html" title="Error codes">Error codes</a>
@@ -95,12 +108,24 @@
<a class="link" href="FlatpakInstallation.html#flatpak-get-default-arch" title="flatpak_get_default_arch ()">flatpak_get_default_arch</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
+<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-get-supported-arches" title="flatpak_get_supported_arches ()">flatpak_get_supported_arches</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-get-system-installations" title="flatpak_get_system_installations ()">flatpak_get_system_installations</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
<a name="idxI"></a><h3 class="title">I</h3>
<dt>
<a class="link" href="FlatpakInstallation.html#FlatpakInstallation-struct" title="struct FlatpakInstallation">FlatpakInstallation</a>, struct in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-cleanup-local-refs-sync" title="flatpak_installation_cleanup_local_refs_sync ()">flatpak_installation_cleanup_local_refs_sync</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakInstallation.html#flatpak-installation-create-monitor" title="flatpak_installation_create_monitor ()">flatpak_installation_create_monitor</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
@@ -121,10 +146,22 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-config" title="flatpak_installation_get_config ()">flatpak_installation_get_config</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-current-installed-app" title="flatpak_installation_get_current_installed_app ()">flatpak_installation_get_current_installed_app</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-display-name" title="flatpak_installation_get_display_name ()">flatpak_installation_get_display_name</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-id" title="flatpak_installation_get_id ()">flatpak_installation_get_id</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-installed-ref" title="flatpak_installation_get_installed_ref ()">flatpak_installation_get_installed_ref</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
@@ -137,10 +174,18 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-priority" title="flatpak_installation_get_priority ()">flatpak_installation_get_priority</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-remote-by-name" title="flatpak_installation_get_remote_by_name ()">flatpak_installation_get_remote_by_name</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-get-storage-type" title="flatpak_installation_get_storage_type ()">flatpak_installation_get_storage_type</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakInstallation.html#flatpak-installation-install" title="flatpak_installation_install ()">flatpak_installation_install</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
@@ -149,6 +194,14 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-install-full" title="flatpak_installation_install_full ()">flatpak_installation_install_full</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-install-ref-file" title="flatpak_installation_install_ref_file ()">flatpak_installation_install_ref_file</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakInstallation.html#flatpak-installation-launch" title="flatpak_installation_launch ()">flatpak_installation_launch</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
@@ -165,6 +218,10 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-list-installed-related-refs-sync" title="flatpak_installation_list_installed_related_refs_sync ()">flatpak_installation_list_installed_related_refs_sync</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakInstallation.html#flatpak-installation-list-remotes" title="flatpak_installation_list_remotes ()">flatpak_installation_list_remotes</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
@@ -173,6 +230,10 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-list-remote-related-refs-sync" title="flatpak_installation_list_remote_related_refs_sync ()">flatpak_installation_list_remote_related_refs_sync</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakInstallation.html#flatpak-installation-load-app-overrides" title="flatpak_installation_load_app_overrides ()">flatpak_installation_load_app_overrides</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
@@ -189,14 +250,30 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-new-system-with-id" title="flatpak_installation_new_system_with_id ()">flatpak_installation_new_system_with_id</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakInstallation.html#flatpak-installation-new-user" title="flatpak_installation_new_user ()">flatpak_installation_new_user</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-prune-local-repo" title="flatpak_installation_prune_local_repo ()">flatpak_installation_prune_local_repo</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-remove-local-ref-sync" title="flatpak_installation_remove_local_ref_sync ()">flatpak_installation_remove_local_ref_sync</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakInstallation.html#flatpak-installation-remove-remote" title="flatpak_installation_remove_remote ()">flatpak_installation_remove_remote</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-set-config-sync" title="flatpak_installation_set_config_sync ()">flatpak_installation_set_config_sync</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakInstallation.html#flatpak-installation-uninstall" title="flatpak_installation_uninstall ()">flatpak_installation_uninstall</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
@@ -205,10 +282,18 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-update-appstream-full-sync" title="flatpak_installation_update_appstream_full_sync ()">flatpak_installation_update_appstream_full_sync</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakInstallation.html#flatpak-installation-update-appstream-sync" title="flatpak_installation_update_appstream_sync ()">flatpak_installation_update_appstream_sync</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakInstallation.html#flatpak-installation-update-full" title="flatpak_installation_update_full ()">flatpak_installation_update_full</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakInstallation.html#flatpak-installation-update-remote-sync" title="flatpak_installation_update_remote_sync ()">flatpak_installation_update_remote_sync</a>, function in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
</dt>
<dd></dd>
@@ -268,6 +353,10 @@
<a class="link" href="FlatpakInstalledRef.html#flatpak-installed-ref-load-metadata" title="flatpak_installed_ref_load_metadata ()">flatpak_installed_ref_load_metadata</a>, function in <a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef">FlatpakInstalledRef</a>
</dt>
<dd></dd>
+<dt>
+<a class="link" href="FlatpakInstallation.html#FlatpakInstallFlags" title="enum FlatpakInstallFlags">FlatpakInstallFlags</a>, enum in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
<a name="idxM"></a><h3 class="title">M</h3>
<dt>
<a class="link" href="flatpak-Version-information.html#FLATPAK-MAJOR-VERSION:CAPS" title="FLATPAK_MAJOR_VERSION">FLATPAK_MAJOR_VERSION</a>, macro in <a class="link" href="flatpak-Version-information.html" title="Version information">Version information</a>
@@ -300,6 +389,10 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakRef.html#FlatpakRef--collection-id" title="The “collection-id” property">FlatpakRef:collection-id</a>, object property in <a class="link" href="FlatpakRef.html" title="FlatpakRef">FlatpakRef</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakRef.html#FlatpakRef--commit" title="The “commit” property">FlatpakRef:commit</a>, object property in <a class="link" href="FlatpakRef.html" title="FlatpakRef">FlatpakRef</a>
</dt>
<dd></dd>
@@ -328,6 +421,10 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakRef.html#flatpak-ref-get-collection-id" title="flatpak_ref_get_collection_id ()">flatpak_ref_get_collection_id</a>, function in <a class="link" href="FlatpakRef.html" title="FlatpakRef">FlatpakRef</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakRef.html#flatpak-ref-get-commit" title="flatpak_ref_get_commit ()">flatpak_ref_get_commit</a>, function in <a class="link" href="FlatpakRef.html" title="FlatpakRef">FlatpakRef</a>
</dt>
<dd></dd>
@@ -344,6 +441,38 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakRelatedRef.html#FlatpakRelatedRef-struct" title="struct FlatpakRelatedRef">FlatpakRelatedRef</a>, struct in <a class="link" href="FlatpakRelatedRef.html" title="FlatpakRelatedRef">FlatpakRelatedRef</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="FlatpakRelatedRef.html#FlatpakRelatedRef--should-delete" title="The “should-delete” property">FlatpakRelatedRef:should-delete</a>, object property in <a class="link" href="FlatpakRelatedRef.html" title="FlatpakRelatedRef">FlatpakRelatedRef</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="FlatpakRelatedRef.html#FlatpakRelatedRef--should-download" title="The “should-download” property">FlatpakRelatedRef:should-download</a>, object property in <a class="link" href="FlatpakRelatedRef.html" title="FlatpakRelatedRef">FlatpakRelatedRef</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="FlatpakRelatedRef.html#FlatpakRelatedRef--subpaths" title="The “subpaths” property">FlatpakRelatedRef:subpaths</a>, object property in <a class="link" href="FlatpakRelatedRef.html" title="FlatpakRelatedRef">FlatpakRelatedRef</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="FlatpakRelatedRef.html#flatpak-related-ref-get-subpaths" title="flatpak_related_ref_get_subpaths ()">flatpak_related_ref_get_subpaths</a>, function in <a class="link" href="FlatpakRelatedRef.html" title="FlatpakRelatedRef">FlatpakRelatedRef</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="FlatpakRelatedRef.html#flatpak-related-ref-new" title="flatpak_related_ref_new ()">flatpak_related_ref_new</a>, function in <a class="link" href="FlatpakRelatedRef.html" title="FlatpakRelatedRef">FlatpakRelatedRef</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="FlatpakRelatedRef.html#flatpak-related-ref-should-delete" title="flatpak_related_ref_should_delete ()">flatpak_related_ref_should_delete</a>, function in <a class="link" href="FlatpakRelatedRef.html" title="FlatpakRelatedRef">FlatpakRelatedRef</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="FlatpakRelatedRef.html#flatpak-related-ref-should-download" title="flatpak_related_ref_should_download ()">flatpak_related_ref_should_download</a>, function in <a class="link" href="FlatpakRelatedRef.html" title="FlatpakRelatedRef">FlatpakRelatedRef</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakRemote.html#FlatpakRemote-struct" title="struct FlatpakRemote">FlatpakRemote</a>, struct in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
</dt>
<dd></dd>
@@ -352,6 +481,10 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakRemote.html#FlatpakRemote--type" title="The “type” property">FlatpakRemote:type</a>, object property in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakRemoteRef.html#FlatpakRemoteRef-struct" title="struct FlatpakRemoteRef">FlatpakRemoteRef</a>, struct in <a class="link" href="FlatpakRemoteRef.html" title="FlatpakRemoteRef">FlatpakRemoteRef</a>
</dt>
<dd></dd>
@@ -360,6 +493,10 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakRemote.html#FlatpakRemoteType" title="enum FlatpakRemoteType">FlatpakRemoteType</a>, enum in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakRemote.html#flatpak-remote-get-appstream-dir" title="flatpak_remote_get_appstream_dir ()">flatpak_remote_get_appstream_dir</a>, function in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
</dt>
<dd></dd>
@@ -368,6 +505,14 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakRemote.html#flatpak-remote-get-collection-id" title="flatpak_remote_get_collection_id ()">flatpak_remote_get_collection_id</a>, function in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="FlatpakRemote.html#flatpak-remote-get-default-branch" title="flatpak_remote_get_default_branch ()">flatpak_remote_get_default_branch</a>, function in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakRemote.html#flatpak-remote-get-disabled" title="flatpak_remote_get_disabled ()">flatpak_remote_get_disabled</a>, function in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
</dt>
<dd></dd>
@@ -380,6 +525,10 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakRemote.html#flatpak-remote-get-nodeps" title="flatpak_remote_get_nodeps ()">flatpak_remote_get_nodeps</a>, function in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakRemote.html#flatpak-remote-get-noenumerate" title="flatpak_remote_get_noenumerate ()">flatpak_remote_get_noenumerate</a>, function in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
</dt>
<dd></dd>
@@ -388,6 +537,10 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakRemote.html#flatpak-remote-get-remote-type" title="flatpak_remote_get_remote_type ()">flatpak_remote_get_remote_type</a>, function in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakRemote.html#flatpak-remote-get-title" title="flatpak_remote_get_title ()">flatpak_remote_get_title</a>, function in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
</dt>
<dd></dd>
@@ -404,6 +557,14 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakRemote.html#flatpak-remote-set-collection-id" title="flatpak_remote_set_collection_id ()">flatpak_remote_set_collection_id</a>, function in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="FlatpakRemote.html#flatpak-remote-set-default-branch" title="flatpak_remote_set_default_branch ()">flatpak_remote_set_default_branch</a>, function in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakRemote.html#flatpak-remote-set-disabled" title="flatpak_remote_set_disabled ()">flatpak_remote_set_disabled</a>, function in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
</dt>
<dd></dd>
@@ -416,6 +577,10 @@
</dt>
<dd></dd>
<dt>
+<a class="link" href="FlatpakRemote.html#flatpak-remote-set-nodeps" title="flatpak_remote_set_nodeps ()">flatpak_remote_set_nodeps</a>, function in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
+</dt>
+<dd></dd>
+<dt>
<a class="link" href="FlatpakRemote.html#flatpak-remote-set-noenumerate" title="flatpak_remote_set_noenumerate ()">flatpak_remote_set_noenumerate</a>, function in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
</dt>
<dd></dd>
@@ -431,6 +596,11 @@
<a class="link" href="FlatpakRemote.html#flatpak-remote-set-url" title="flatpak_remote_set_url ()">flatpak_remote_set_url</a>, function in <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
</dt>
<dd></dd>
+<a name="idxS"></a><h3 class="title">S</h3>
+<dt>
+<a class="link" href="FlatpakInstallation.html#FlatpakStorageType" title="enum FlatpakStorageType">FlatpakStorageType</a>, enum in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
+</dt>
+<dd></dd>
<a name="idxU"></a><h3 class="title">U</h3>
<dt>
<a class="link" href="FlatpakInstallation.html#FlatpakUpdateFlags" title="enum FlatpakUpdateFlags">FlatpakUpdateFlags</a>, enum in <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
@@ -438,6 +608,6 @@
<dd></dd>
</div>
<div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
</body>
</html> \ No newline at end of file
diff --git a/reference/html/index.html b/reference/html/index.html
index e4ffaac5..7bd07ac3 100644
--- a/reference/html/index.html
+++ b/reference/html/index.html
@@ -3,10 +3,10 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Flatpak Library Reference Manual: Flatpak Library Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Flatpak Library Reference Manual">
<link rel="next" href="ch01.html" title="Flatpak">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -15,7 +15,7 @@
<div>
<div><table class="navigation" id="top" width="100%" cellpadding="2" cellspacing="0"><tr><th valign="middle"><p class="title">Flatpak Library Reference Manual</p></th></tr></table></div>
<div><p class="releaseinfo">
- For flatpak 0.6.13
+ For flatpak 0.11.3
</p></div>
</div>
@@ -34,6 +34,9 @@
<span class="refentrytitle"><a href="FlatpakInstalledRef.html">FlatpakInstalledRef</a></span><span class="refpurpose"> — Installed application reference</span>
</dt>
<dt>
+<span class="refentrytitle"><a href="FlatpakRelatedRef.html">FlatpakRelatedRef</a></span><span class="refpurpose"> — Related application reference</span>
+</dt>
+<dt>
<span class="refentrytitle"><a href="FlatpakRemoteRef.html">FlatpakRemoteRef</a></span><span class="refpurpose"> — Remote application reference</span>
</dt>
<dt>
@@ -55,6 +58,6 @@
</dl></div>
</div>
<div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
</body>
</html> \ No newline at end of file
diff --git a/reference/html/object-tree.html b/reference/html/object-tree.html
index 8b123695..0ba5e3d5 100644
--- a/reference/html/object-tree.html
+++ b/reference/html/object-tree.html
@@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Object Hierarchy: Flatpak Library Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Flatpak Library Reference Manual">
<link rel="up" href="index.html" title="Flatpak Library Reference Manual">
<link rel="prev" href="flatpak-Version-information.html" title="Version information">
<link rel="next" href="full-api-index.html" title="API Index">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -23,16 +23,17 @@
<div class="titlepage"><div><div><h1 class="title">
<a name="object-tree"></a>Object Hierarchy</h1></div></div></div>
<pre class="screen">
- <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
+ GObject
<span class="lineart">├──</span> <a class="link" href="FlatpakRef.html" title="FlatpakRef">FlatpakRef</a>
<span class="lineart">│</span> <span class="lineart">├──</span> <a class="link" href="flatpak-flatpak-bundle-ref.html#FlatpakBundleRef">FlatpakBundleRef</a>
<span class="lineart">│</span> <span class="lineart">├──</span> <a class="link" href="FlatpakInstalledRef.html" title="FlatpakInstalledRef">FlatpakInstalledRef</a>
+ <span class="lineart">│</span> <span class="lineart">├──</span> <a class="link" href="FlatpakRelatedRef.html" title="FlatpakRelatedRef">FlatpakRelatedRef</a>
<span class="lineart">│</span> <span class="lineart">╰──</span> <a class="link" href="FlatpakRemoteRef.html" title="FlatpakRemoteRef">FlatpakRemoteRef</a>
<span class="lineart">├──</span> <a class="link" href="FlatpakInstallation.html" title="FlatpakInstallation">FlatpakInstallation</a>
<span class="lineart">╰──</span> <a class="link" href="FlatpakRemote.html" title="FlatpakRemote">FlatpakRemote</a>
</pre>
</div>
<div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
</body>
</html> \ No newline at end of file
View Lorry Controller Status