From 1b4c3d30629122545030ce99622e302d46b76963 Mon Sep 17 00:00:00 2001 From: V3n3RiX Date: Wed, 10 Jun 2020 14:52:32 +0100 Subject: sisyphus-cli : document uninstall option better --- src/frontend/cli/sisyphus-cli.py | 24 ++++++++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) (limited to 'src') diff --git a/src/frontend/cli/sisyphus-cli.py b/src/frontend/cli/sisyphus-cli.py index ee9bd9f..a3e5a62 100755 --- a/src/frontend/cli/sisyphus-cli.py +++ b/src/frontend/cli/sisyphus-cli.py @@ -38,10 +38,30 @@ def uninstall(pkgname: List[str], force: bool = False): If you really want to uninstall the package, make sure you uninstall all reverse dependencies as well. This will not allways be possible, as the reverse dependency chain may be way to long and require you to uninstall critical system packages. - Using the --force option, packages are uninstalled *UNSAFELY* by ignoring reverse dependencies. - This may break your system if you uninstall critical system packages. + * Examples: + + 'sisyphus uninstall firefox' or 'sisyphus uninstall firefox --no-force' + + will succeed, as nothing depends on it + + 'sisyphus uninstall pulseaudio' or 'sisyphus uninstall pulseaudio --no-force' + + will fail, many packages depend on it + + With --force option, packages are uninstalled *UNSAFELY* by ignoring reverse dependencies. + This may break your system if you uninstall critical packages. It will try the best it can to preserve the libraries required by other packages to prevent such a breakage. Upgrading the system may pull the packages back in, to fix the reverse dependency chain. + + * Examples : + + 'sisyphus uninstall pulseaudio --force' + + will succeed, but you may no longer have audio + + 'sisyphus uninstall openrc --force' + + will succeed, but the system will be broken """ if not force: sisyphus.uninstall.start(pkgname) -- cgit v1.2.3