# HG changeset patch
# User Matthew Wild <mwild1@gmail.com>
# Date 1739819448 0
# Node ID 46e7cc4de5e65b7bafcd2ee8ce80b27e920afd33
# Parent  42367f7e6e94a9a1e4c2ea73d6cde6d40adb724c
mod_admin_shell: Improve help listing in non-REPL mode

diff -r 42367f7e6e94 -r 46e7cc4de5e6 plugins/mod_admin_shell.lua
--- a/plugins/mod_admin_shell.lua	Mon Feb 17 19:10:26 2025 +0000
+++ b/plugins/mod_admin_shell.lua	Mon Feb 17 19:10:48 2025 +0000
@@ -565,9 +565,43 @@
 				for command, command_help in it.sorted_pairs(section_help.commands or {}) do
 					if not command_help.hidden then
 						c = c + 1;
-						local args = array.pluck(command_help.args, "name"):concat(", ");
 						local desc = command_help.desc or command_help.module and ("Provided by mod_"..command_help.module) or "";
-						print(("%s:%s(%s) - %s"):format(section_name, command, args, desc));
+						if self.session.repl then
+							local args = array.pluck(command_help.args, "name"):concat(", ");
+							print(("%s:%s(%s) - %s"):format(section_name, command, args, desc));
+						else
+							local args = array.pluck(command_help.args, "name"):concat("> <");
+							if args ~= "" then
+								args = "<"..args..">";
+							end
+							print(("%s %s %s"):format(section_name, command, args));
+							print(("    %s"):format(desc));
+							if command_help.flags then
+								local flags = command_help.flags;
+								print("");
+								print(("    Flags:"));
+
+								if flags.kv_params then
+									for name in it.sorted_pairs(flags.kv_params) do
+										print("      --"..name:gsub("_", "-"));
+									end
+								end
+
+								if flags.value_params then
+									for name in it.sorted_pairs(flags.value_params) do
+										print("      --"..name:gsub("_", "-").." <"..name..">");
+									end
+								end
+
+								if flags.array_params then
+									for name in it.sorted_pairs(flags.array_params) do
+										print("      --"..name:gsub("_", "-").." <"..name..">, ...");
+									end
+								end
+
+							end
+							print("");
+						end
 					end
 				end
 			elseif help_topics[section_name] then