revamp help

1 files changed, 48 insertions, 16 deletions

diff --git a/src/backend/libsisyphus.py b/src/backend/libsisyphus.py
index f7893cc..33b2177 100644
--- a/src/backend/libsisyphus.py
+++ b/src/backend/libsisyphus.py
@@ -454,20 +454,52 @@ def setActiveMirror(mirror):
         writeMirrorCfg(mirrorList)
 
 def showHelp():
-    print("\nUsage : sisyphus command [package(s)] || [file(s)]\n")
-    print("Sisyphus is a simple python wrapper around portage, gentoolkit, and portage-utils that provides")
+    print("\n" + "Usage : sisyphus command [package(s)] || [file(s)]" + "\n")
+    print("Sisyphus is a simple python wrapper around portage, gentoolkit, and portage-utils which provides")
     print("an apt-get/yum-alike interface to these commands, to assist newcomer people transitioning from")
-    print("Debian/RedHat-based systems to Gentoo.\n")
-    print("Commands :\n")
-    print("install - Install new packages")
-    print("uninstall - Uninstall packages *safely* (INFO : If reverse deps are found, package(s) will NOT be uninstalled)")
-    print("force-uninstall - Uninstall packages *unsafely* (WARNING : This option will ignore reverse deps, which may break your system)")
-    print("remove-orphans - Uninstall packages that are no longer needed")
-    print("update - Update the Portage tree, Overlay(s), Portage config files && Sisyphus database remote_packages table")
-    print("upgrade -  Upgrade the system")
-    print("search - Search for packages")
-    print("spmsync - Sync Sisyphus database with Portage database (if you install something with Portage, not Sisyphus)")
-    print("rescue - Rescue Sisyphus database if lost or corrupted")
-    print("mirror list - List available mirrors (the active one is marked with *)")
-    print("mirror set INDEX - Switch the repository to the selected mirror")
-    print("sysinfo - Display information about installed core packages and portage configuration")
+    print("Debian/RedHat-based systems to Gentoo." + "\n")
+    print("Commands :" + "\n")
+    print("install")
+    print("* Install binary packages" + "\n")
+    print("hybrid-install")
+    print("* Install binary and/or ebuild (source) packages" + "\n")
+    print("uninstall")
+    print("* Uninstall packages *SAFELY* by checking for reverse dependencies")
+    print("* If reverse dependencies exist, the package(s) will NOT be uninstalled to prevent the possible breakage of the system")
+    print("* If you really want to uninstall the package, make sure you uninstall all reverse dependencies as well")
+    print("* This will not allways be possible, as the reverse dependency chain may be way to long and require you to uninstall critical system packages" + "\n")
+    print("force-uninstall")
+    print("* Uninstall packages *UNSAFELY* by ignoring reverse dependencies")
+    print("* This may break your system if you uninstall critical system packages")
+    print("* It will try the best it can to preserve the libraries required by other packages to prevent such a breakage")
+    print("* Upgrading the system may pull the packages back in, to fix the reverse dependency chain" + "\n")
+    print("remove-orphans")
+    print("* Uninstall packages that are no longer needed")
+    print("* When you uninstall a package without it's reverse dependencies, those dependencies will become orphans if nothing else requires them")
+    print("* In addition, a package may no longer depend on another one, so that other package becomes orphan as well")
+    print("* Use this option to check the whole dependency chain for such packages, and uninstall them" + "\n")
+    print("update")
+    print("* Update the Portage tree, Overlay(s), Portage config files && Sisyphus's package database" + "\n")
+    print("upgrade")
+    print("* Upgrade the system using binary packages" + "\n")
+    print("hybrid-upgrade")
+    print("* Upgrade the system using binary and/or ebuild (source) packages" + "\n")
+    print("search")
+    print("* Search for packages")
+    print("* In binary mode this will return available binary packages")
+    print("* In source mode this will return binary and ebuild (source) packages" + "\n")
+    print("spmsync")
+    print("* Sync Sisyphus's package database with Portage's package database")
+    print("* When you install something with Portage directly (emerge), Sisyphus is not aware of that package, and it doesn't track it in it's database")
+    print("* Use this option to synchronize Sisyphus's package database with Portage's package database" + "\n")
+    print("rescue")
+    print("* Resurrect Sisyphus's package database if lost or corrupted")
+    print("* If for some reason Sisyphus's package database is lost or corrupted, it can be resurrected using Portage's package database")
+    print("* If Portage's package database is corrupted (in this case you're screwed anyway :D), only a partial resurrection will be possible")
+    print("* If Portage's package database is intact, full resurrection will be possible" + "\n")
+    print("mirror list")
+    print("* List available mirrors (the active one is marked with *)" + "\n")
+    print("mirror set INDEX")
+    print("* Switch the repository to the selected mirror" + "\n")
+    print("sysinfo")
+    print("* Display information about installed core packages and portage configuration" + "\n")