feat: Add `clap.helpToFile`

The code for printing help became quite verbose after writegate. Writing
help to a file like stdout and stderr is very common, so this wrapper
provides a default, buffered way to report to a file.

1 files changed, 2 insertions, 6 deletions

diff --git a/README.md b/README.md
index 8db67c9..6a1435f 100644
--- a/README.md
+++ b/README.md
@@ -365,12 +365,8 @@ pub fn main() !void {
     // where `Id` has a `description` and `value` method (`Param(Help)` is one such parameter).
     // The last argument contains options as to how `help` should print those parameters. Using
     // `.{}` means the default options.
-    if (res.args.help != 0) {
-        var buf: [1024]u8 = undefined;
-        var stderr = std.fs.File.stderr().writer(&buf);
-        try clap.help(&stderr.interface, clap.Help, &params, .{});
-        return stderr.interface.flush();
-    }
+    if (res.args.help != 0)
+        return clap.helpToFile(.stderr(), clap.Help, &params, .{});
 }
 
 const clap = @import("clap");