summaryrefslogtreecommitdiff
path: root/doc/flatpak-update.xml
diff options
context:
space:
mode:
authorPhaedrus Leeds <mwleeds@protonmail.com>2022-02-16 17:32:03 -0600
committerPatrick <tingping@tingping.se>2022-02-17 10:37:25 -0600
commitc932a57f4f259402ac9e175fa918c3f3b32cc355 (patch)
treeff0096eff5107efa94584acd6b96f938bd9cc1a7 /doc/flatpak-update.xml
parent6dc067ca33cb42cdad3a15bbbd43c849828a19d9 (diff)
downloadflatpak-c932a57f4f259402ac9e175fa918c3f3b32cc355.tar.gz
doc: Tweak a few man pages
Make it clear what the current behavior is for sideloading from local sources as well as for uninstalling unused EOL runtimes.
Diffstat (limited to 'doc/flatpak-update.xml')
-rw-r--r--doc/flatpak-update.xml23
1 files changed, 15 insertions, 8 deletions
diff --git a/doc/flatpak-update.xml b/doc/flatpak-update.xml
index 499112af..f8c4c19d 100644
--- a/doc/flatpak-update.xml
+++ b/doc/flatpak-update.xml
@@ -70,10 +70,10 @@
</para>
<para>
If the configured remote for a ref being updated has a collection ID configured on it,
- flatpak will search mounted filesystems such as USB drives as well as Avahi services
- advertised on the local network for the needed refs, in order to support
- offline updates. See <citerefentry><refentrytitle>ostree-find-remotes</refentrytitle><manvolnum>1</manvolnum></citerefentry>
- for more information.
+ Flatpak will search the <filename>sideload-repos</filename> directories configured
+ either with the <option>--sideload-repo</option> option, or on a per-installation or
+ system-wide basis (see
+ <citerefentry><refentrytitle>flatpak</refentrytitle><manvolnum>1</manvolnum></citerefentry>).
</para>
<para>
Note that updating a runtime is different from installing
@@ -83,6 +83,12 @@
version, with the <option>--commit</option> option.
</para>
<para>
+ In addition to updates, this command will offer to uninstall any unused end-of-life
+ runtimes. Runtimes that were explicitly installed (not as a dependency) or explicitly
+ pinned (see <citerefentry><refentrytitle>flatpak-pin</refentrytitle><manvolnum>1</manvolnum></citerefentry>)
+ are left installed even if unused and end-of-life.
+ </para>
+ <para>
Unless overridden with the <option>--user</option>, <option>--system</option> or <option>--installation</option> option, this command updates
any matching refs in the standard system-wide installation and the per-user one.
</para>
@@ -219,10 +225,11 @@
<term><option>--sideload-repo=PATH</option></term>
<listitem><para>
- Adds an extra local ostree repo as source for installation. This is equivalent
- to using the sideload-repos directories (see flatpak(1)), but can be done on a
- per-command basis. Any path added here is used in addition to ones in those
- directories.
+ Adds an extra local ostree repo as a source for installation. This is equivalent
+ to using the <filename>sideload-repos</filename> directories (see
+ <citerefentry><refentrytitle>flatpak</refentrytitle><manvolnum>1</manvolnum></citerefentry>),
+ but can be done on a per-command basis. Any path added here is used in addition
+ to ones in those directories.
</para></listitem>
</varlistentry>