summaryrefslogtreecommitdiff
path: root/src/frontend/cli
diff options
context:
space:
mode:
authorV3n3RiX <venerix@redcorelinux.org>2020-06-10 14:52:32 +0100
committerV3n3RiX <venerix@redcorelinux.org>2020-06-10 14:52:32 +0100
commit1b4c3d30629122545030ce99622e302d46b76963 (patch)
treeed0d1c43ffe7cd0a0a2af5cec20c869c6614d60b /src/frontend/cli
parentdf5e80d63cff8acce2b510e1f2be07a7e1369415 (diff)
sisyphus-cli : document uninstall option better
Diffstat (limited to 'src/frontend/cli')
-rwxr-xr-xsrc/frontend/cli/sisyphus-cli.py24
1 files changed, 22 insertions, 2 deletions
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)