docs: improve install/uninstall help

This adds some additional help to the man page and the RTD page around
using local packages with the install/uninstall commands.

Closes: #1388
Approved by: cgwalters
This commit is contained in:
Micah Abbott 2018-06-05 09:51:01 -04:00 committed by Atomic Bot
parent 479406e6a5
commit de42ef701f
2 changed files with 14 additions and 3 deletions

View File

@ -65,8 +65,13 @@ to use packages where it suits.
``` ```
Will download the target package, its dependencies, and create a new deployment Will download the target package, its dependencies, and create a new deployment
with those packages installed. To remove layered packages, use `rpm-ostree with those packages installed. It is also possible to specify a local package
uninstall`. which is not part of a repository.
To remove layered packages installed from a repository, use `rpm-ostree uninstall
<pkg>`. To remove layered packages installed from a local package, you must
specify the full NEVRA of the package. For example, `rpm-ostree uninstall
ltrace-0.7.91-16.fc22.x86_64`.
By default, every `rpm-ostree` operation is "offline" - it has no effect By default, every `rpm-ostree` operation is "offline" - it has no effect
on your running system, and will only take effect when you reboot. This "pending" state is on your running system, and will only take effect when you reboot. This "pending" state is

View File

@ -221,7 +221,8 @@ Boston, MA 02111-1307, USA.
Takes one or more packages as arguments. The packages are Takes one or more packages as arguments. The packages are
fetched from the enabled repositories in fetched from the enabled repositories in
<filename>/etc/yum.repos.d/</filename> and are overlayed on <filename>/etc/yum.repos.d/</filename> and are overlayed on
top of a new deployment. top of a new deployment. It is also possible to specify a
local package that resides on the host.
</para> </para>
<para> <para>
@ -264,6 +265,11 @@ Boston, MA 02111-1307, USA.
top of a new deployment. top of a new deployment.
</para> </para>
<para>When trying to uninstall a package that was installed
from a local RPM (i.e. not from a repository), you must
specify the full NEVRA of the package.
</para>
<para> <para>
<command>--reboot</command> or <command>-r</command> to <command>--reboot</command> or <command>-r</command> to
initiate a reboot after the deployment is prepared. initiate a reboot after the deployment is prepared.