2 files changed, 12 insertions, 3 deletions
diff --git a/sys/nixpkgs/pkgs/scripts/default.nix b/sys/nixpkgs/pkgs/scripts/default.nix
index 0c76e6e4..69fba713 100644
--- a/sys/nixpkgs/pkgs/scripts/default.nix
+++ b/sys/nixpkgs/pkgs/scripts/default.nix
@@ -334,6 +334,7 @@
       update-sys-scr = write_shell {
         name = "update-sys";
         path = "small_functions";
+        completions = true;
         dependencies = builtins.attrValues {
           inherit
             (prev)
diff --git a/sys/nixpkgs/pkgs/scripts/source/small_functions/update-sys.sh b/sys/nixpkgs/pkgs/scripts/source/small_functions/update-sys.sh
index 4c5d19c2..d28247f6 100755
--- a/sys/nixpkgs/pkgs/scripts/source/small_functions/update-sys.sh
+++ b/sys/nixpkgs/pkgs/scripts/source/small_functions/update-sys.sh
@@ -7,16 +7,24 @@ help() {
     cat <<EOF
 This is a NixOS System flake update manager.
 
-Usage:
+USAGE:
     $NAME [--branch <branchname>] [--help]
 
-Options:
+OPTIONS:
     --branch | -b  BRANCHNAME
                                 select a branch to update from.
-    --mode | -m  MODE
+
+    --mode   | -m  MODE
                                 select a mode to update with
+
     --help   | -h
                                 output this help.
+ARGUMENTS:
+    BRANCHNAME := [[ git branch --list --format '%(refname:short)' ]]
+                                The name of the branch to deploy the config from
+
+    MODE := switch|boot|test|build|dry-build|dry-activate|edit|repl|build-vm|build-vm-with-bootloader
+                                See the 'nixos-rebuild' manpage for more information about these modes.
 EOF
     exit "$1"
 }