help improvements

Author: dasimmet

README.md

@@ -23,20 +23,21 @@ inside this tool.
 > zig build zigpkg -- --help
 usage: zigpkg <subcommand> [--help]
 
-stores all dependencies of a directory containing build.zig.zon in a .tar.gz archive
+a multicall too to work with zig's build graphs
 
 available subcommands:
   dot     rerun "zig build" and output a graphviz ".dot" file of build steps based on args
   dotall  rerun "zig build" and output a graphviz ".dot" file of all build steps
+  dothtml "dotall", but output html for vis.js instead of ".dit"
   zon     rerun "zig build" with a custom build runner and output the build graph as .zon to stdout
   json    same as "zon" but output json
-  deppkg  more subcommands for creating and working with "deppkg.tar.gz" files storing all
-          dependencies required to build a zig package
+  deppkg  more subcommands for creating and working with "deppkg.tar.gz" files. storing all
+          stores all dependencies of a directory containing build.zig.zon in a .tar.gz archive
 
 environment variables:
 
-  ZIG: path to the zig compiler to invoke in subprocesses. defaults to "zig".
-
+  ZIG: path to the zig compiler to invoke in subprocesses.
+       defaults to "zig" in the PATH.
 ```
 
 ## Dependency packages

src/runner-zig.zig

@@ -1,7 +1,13 @@
 const std = @import("std");
 const builtin = @import("builtin");
 
-const later_than_zig_15 = builtin.zig_version.order(std.SemanticVersion.parse("0.15.99") catch unreachable) == .gt;
+// changes to readFileAllocOptions after this
+const later_than_zig_15 = std.mem.containsAtLeastScalar(std.math.Order, &.{
+    .gt,
+    .eq,
+}, 1, builtin.zig_version.order(
+    std.SemanticVersion.parse("0.16.0") catch unreachable,
+));
 
 pub const runner = if (later_than_zig_15)
     // 0.16.0-dev.1354+94e98bfe8

src/zigpkg.zig

@@ -13,16 +13,16 @@ const viz_network = @import("viz_network.html.zig").viz_network;
 const usage =
     \\usage: zigpkg <subcommand> [--help]
     \\
-    \\stores all dependencies of a directory containing build.zig.zon in a .tar.gz archive
+    \\a multicall too to work with zig's build graphs
     \\
     \\available subcommands:
     \\  dot     rerun "zig build" and output a graphviz ".dot" file of build steps based on args
     \\  dotall  rerun "zig build" and output a graphviz ".dot" file of all build steps
     \\  dothtml "dotall", but output html for vis.js instead of ".dit"
     \\  zon     rerun "zig build" with a custom build runner and output the build graph as .zon to stdout
     \\  json    same as "zon" but output json
-    \\  deppkg  more subcommands for creating and working with "deppkg.tar.gz" files storing all
-    \\          dependencies required to build a zig package
+    \\  deppkg  more subcommands for creating and working with "deppkg.tar.gz" files. storing all
+    \\          stores all dependencies of a directory containing build.zig.zon in a .tar.gz archive
     \\
     \\environment variables:
     \\
@@ -205,14 +205,21 @@ pub fn cmd_extract(opt: GlobalOptions, args: []const []const u8) !u8 {
 
 pub fn cmd_create(opt: GlobalOptions, args: []const []const u8) !u8 {
     const cmd_usage =
+        \\
         \\usage: zigpkg create <deppkg.tar.gz> <<build root path>|--> [z]
         \\
+        \\
     ;
     if (args.len < 1) {
         try opt.stdout.writeAll(cmd_usage);
         return 1;
     }
 
+    if (helpArg(args[0..@min(1, args.len)])) {
+        try opt.stdout.writeAll(cmd_usage);
+        return 1;
+    }
+
     const output = try std.fs.path.resolve(opt.gpa, &.{ opt.cwd, args[0] });
     defer opt.gpa.free(output);
 

src/zonparse.zig

@@ -19,7 +19,12 @@ const builtin = @import("builtin");
 const zig_15_or_later = builtin.zig_version.order(std.SemanticVersion.parse("0.14.99") catch unreachable) == .gt;
 
 // changes to readFileAllocOptions after this
-const later_than_zig_15_1 = builtin.zig_version.order(std.SemanticVersion.parse("0.15.99") catch unreachable) == .gt;
+const later_than_zig_15 = std.mem.containsAtLeastScalar(std.math.Order, &.{
+    .gt,
+    .eq,
+}, 1, builtin.zig_version.order(
+    std.SemanticVersion.parse("0.16.0") catch unreachable,
+));
 
 pub const zonparse = @import("zonparse-master.zig");
 
@@ -36,7 +41,7 @@ pub fn cwdReadFileAllocZ(
     max_bytes: usize,
 ) ![:0]const u8 {
     const cwd = std.fs.cwd();
-    if (comptime later_than_zig_15_1) {
+    if (comptime later_than_zig_15) {
         return cwd.readFileAllocOptions(
             subpath,
             allocator,