about summary refs log tree commit diff
diff options
context:
space:
mode:
authorFlorian Klink <flokli@flokli.de>2024-08-12T13·24+0300
committerclbot <clbot@tvl.fyi>2024-08-12T13·41+0000
commitfd64df05114ef9dfac6fe46ce990f178c6d207c5 (patch)
tree9fafb8bd8dc733ca8f9d8994386003061290fd21
parent1f5a85740e2066f5fb8b7ab487805da5f7da413a (diff)
fix(tvix/cli): add toplevel docstring to Args struct r/8481
Otherwise the flattened `ServiceUrlsMemory` docstring becomes the main
binary description, which doesn't make an awful lot of sense.

The help now describes what this CLI does currently (an interface to use
the different Tvix component.

Also, describe what it does not, so people running it without looking
too much other documentation might not get confused about why this
doesn't do anything in `/nix/store`, or doesn't provide the same CLI
surface as Nix.

Change-Id: Ia4838b444f03a10821801a6171d3e956b3cdfdaf
Reviewed-on: https://cl.tvl.fyi/c/depot/+/12194
Autosubmit: flokli <flokli@flokli.de>
Reviewed-by: Connor Brewster <cbrewster@hey.com>
Tested-by: BuildkiteCI
-rw-r--r--tvix/cli/src/args.rs8
1 files changed, 8 insertions, 0 deletions
diff --git a/tvix/cli/src/args.rs b/tvix/cli/src/args.rs
index a4d1bcae157e..5b8f6b48b134 100644
--- a/tvix/cli/src/args.rs
+++ b/tvix/cli/src/args.rs
@@ -4,6 +4,14 @@ use clap::Parser;
 use tracing::Level;
 use tvix_store::utils::ServiceUrlsMemory;
 
+/// Provides a CLI interface to trigger evaluation using tvix-eval.
+///
+/// Uses configured tvix-[ca]store and tvix-build components,
+/// and by default a set of builtins similar to these present in Nix.
+///
+/// None of the stores available add to the local `/nix/store` location.
+///
+/// The CLI interface is not stable and subject to change.
 #[derive(Parser, Clone)]
 pub struct Args {
     /// A global log level to use when printing logs.