sorta help text generation

This mostly works. Subcommands are utterly broken because we blindly
consume an additional argument to get the program name, which we
should not do.

This code was always kind of spaghetti, but it's getting worse. I want
to refactor it into something that doesn't make me cringe, but at the
same time, this project was intended to be a means to an end rather
than the end itself, and it kind of feels a bit silly to spend a ton
of time on it. On the other hand, relying on it for other projects
seems silly if it's a fragile mess. The goal was to get it into a
usable state and then hack on it as necessary, but it still has a ways
to go to get there, and working on it is kind of painful, in an
existential fashion.

Perhaps I will attempt to rewrite it, get halfway, and stall forever.
Thanks for reading my cool commit message blog. Bye.

demo/demo.zig

@@ -5,27 +5,47 @@ const context: []const u8 = "hello friend";
 const ContextType = @TypeOf(context);
 
 const subcommand = blk: {
-    var cmd = noclip.Command(ContextType, .{ .name = "subcommand", .help = "this a sub command" });
+    var cmd = noclip.Command(ContextType, .{ .name = "verb", .help = "this a sub command" });
     cmd.add(cmd.defaultHelpFlag);
     cmd.add(cmd.StringOption{ .name = "meta", .short = "-m" });
-    cmd.add(cmd.StringArgument{ .name = "sub" });
+    cmd.add(cmd.StringArgument{ .name = "argument" });
+    cmd.add(cmd.Argument(u32){ .name = "another", .default = 0 });
     break :blk cmd;
 };
 
 const command = blk: {
-    var cmd = noclip.Command(ContextType, .{ .name = "main", .help = "main CLI entry point" });
+    var cmd = noclip.Command(ContextType, .{
+        .name = "main",
+        .help =
+        \\This is the main CLI entry point for the noclip demo
+        \\
+        \\This program demonstrates the major features of noclip both in terms of API
+        \\usage (in its source code) and argument parsing (in its execution).
+        ,
+    });
+    cmd.add(cmd.defaultHelpFlag);
     cmd.add(cmd.Flag{ .name = "flag", .truthy = .{ .short = "-f", .long = "--flag" }, .falsy = .{ .long = "--no-flag" } });
     cmd.add(cmd.StringOption{
         .name = "input",
         .short = "-i",
         .long = "--input",
-        .handler = printHandler,
+        .help = "some generic input",
+        .default = "in",
         .envVar = "OPTS_INPUT",
     });
-    cmd.add(cmd.StringOption{ .name = "output", .long = "--output", .default = "waoh" });
-    cmd.add(cmd.Option(i32){ .name = "number", .short = "-n", .long = "--number" });
-    cmd.add(cmd.StringArgument{ .name = "argument" });
-    cmd.add(cmd.Argument(u32){ .name = "another", .default = 0 });
+    cmd.add(cmd.StringOption{
+        .name = "output",
+        .long = "--output",
+        .default = "waoh",
+        .help = "name of the output",
+    });
+    cmd.add(cmd.Option(i32){
+        .name = "number",
+        .short = "-n",
+        .long = "--number",
+        .help = "a number",
+        .default = 0,
+    });
 
     cmd.add(subcommand.Parser(subCallback));
     break :blk cmd;
@@ -40,34 +60,27 @@ pub fn subCallback(_: ContextType, result: subcommand.CommandResult()) !void {
     std.debug.print(
         \\subcommand: {{
         \\    .meta = {s}
-        \\    .sub = {s}
+        \\    .argument = {s}
+        \\    .another = {d}
         \\}}
         \\
     ,
-        .{ result.meta, result.sub },
+        .{ result.meta, result.argument, result.another },
     );
 }
 
 pub fn mainCommand(_: ContextType, result: command.CommandResult()) !void {
+    // std.debug.print("{any}", .{result});
     std.debug.print(
         \\arguments: {{
         \\    .flag = {any}
         \\    .input = {s}
         \\    .output = {s}
         \\    .number = {d}
-        \\    .argument = {s}
-        \\    .another = {d}
         \\}}
         \\
     ,
-        .{
-            result.flag,
-            result.input,
-            result.output,
-            result.number,
-            result.argument,
-            result.another,
-        },
+        .{ result.flag, result.input, result.output, result.number },
     );
 }
 
@@ -79,7 +92,6 @@ pub fn main() !void {
 
     const allocator = arena.allocator();
     var argit = try std.process.argsWithAllocator(allocator);
-    _ = argit.next();
 
     try parser.execute(allocator, std.process.ArgIterator, &argit, context);
 }