From 5e9d75073ca929c2053000cd30b33819af7e38b6 Mon Sep 17 00:00:00 2001
From: Andre Ramnitz <tux.rising@gmail.com>
Date: Fri, 14 Nov 2025 15:28:29 +0100
Subject: [PATCH] upgrayyedd: improve help page

---
 dot-local/bin/upgrayyedd | 39 ++++++++++++++++++++++++++++++++++++---
 1 file changed, 36 insertions(+), 3 deletions(-)

diff --git a/dot-local/bin/upgrayyedd b/dot-local/bin/upgrayyedd
index af4415aa..320465da 100755
--- a/dot-local/bin/upgrayyedd
+++ b/dot-local/bin/upgrayyedd
@@ -31,10 +31,19 @@ case "$1" in
     sync)
         $precmd emaint sync -A
         ;;
-    --)
+    world)
+        $precmd /usr/bin/emerge -avuDN @world "${@:2}"
+        exit 0
+        ;;
+    refresh)
+        $precmd emaint sync -A
         $precmd /usr/bin/emerge -avuDN @world "${@:2}"
         exit 0
         ;;
+    --)
+        $precmd /usr/bin/emerge -av "${@:2}"
+        exit 0
+        ;;
     skipkernel)
         $precmd /usr/bin/emerge -avuDN @world --exclude=dist-kernel --exclude=gentoo-kernel --exclude=gentoo-sources --exclude=git-sources "${@:2}"
         exit 0
@@ -43,7 +52,7 @@ case "$1" in
         $precmd /usr/bin/emerge -av @preserved-rebuild
         exit 0
         ;;
-    world)
+    wholeworld)
         $precmd /usr/bin/emerge -avuDe --with-bdeps=y --usepkg=n --keep-going=y @world "${@:3}"
         exit 0
         ;;
@@ -123,6 +132,30 @@ case "$1" in
         echo "Precmd is: $precmd"
         ;;
     *)
-        echo "Currently available commands: 'check', '--', 'skipkernel', 'clean', 'livebuilds', 'log', 'unlog', 'kernel-gentoo', 'kernel-llvm', 'kernel-git', 'kernel-server', 'clean-kernels'"
+        printf '\nCurrently available commands:\n\n'
+	printf '%s\t%s\n' \
+	'sync          ' 'synchronize repos' \
+	'check         ' 'check for updates' \
+	' ' ' ' \
+	'livebuilds    ' 'update all live packages' \
+	'world         ' 'update world' \
+	'refresh       ' 'sync and update world' \
+	' ' ' ' \
+	'wholeworld    ' 'rebuild everything from scratch' \
+	' ' ' ' \
+	'--            ' 'install packages given as argument' \
+	' ' ' ' \
+	'kernel-gentoo ' 'build kernel flavor: gentoo' \
+	'kernel-llvm   ' 'build kernel flavor: llvm' \
+	'kernel-git    ' 'build kernel flavor: git' \
+	'kernel-server ' 'build kernel flavor: server' \
+	' ' ' ' \
+	'clean         ' 'clean orphaned packages' \
+	'preserved     ' 'clean-up old libraries' \
+	'clean-kernels ' 'remove old kernels' \
+	' ' ' ' \
+	'log           ' 'view recently emerged files' \
+	'unlog         ' 'view recently unmerged files' \
+	' ' ' '
         ;;
 esac
-- 
2.51.2