From fd64df05114ef9dfac6fe46ce990f178c6d207c5 Mon Sep 17 00:00:00 2001 From: Florian Klink Date: Mon, 12 Aug 2024 16:24:24 +0300 Subject: [PATCH] fix(tvix/cli): add toplevel docstring to Args struct 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 Reviewed-by: Connor Brewster Tested-by: BuildkiteCI --- tvix/cli/src/args.rs | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/tvix/cli/src/args.rs b/tvix/cli/src/args.rs index a4d1bcae1..5b8f6b48b 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.