From 6badd21b6a22c6037a5152463343491e770a581d Mon Sep 17 00:00:00 2001 From: Jade Lynn Masker Date: Sat, 31 May 2025 17:50:46 -0400 Subject: [PATCH 1/3] add documentation of tarball-ttl to nix-channel --- doc/manual/source/command-ref/nix-channel.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc/manual/source/command-ref/nix-channel.md b/doc/manual/source/command-ref/nix-channel.md index 8b58392b7..4a7555c90 100644 --- a/doc/manual/source/command-ref/nix-channel.md +++ b/doc/manual/source/command-ref/nix-channel.md @@ -53,6 +53,11 @@ This command has the following operations: Download the Nix expressions of subscribed channels and create a new generation. Update all channels if none is specified, and only those included in *names* otherwise. + > **Note** + > + > `--update` uses [fetchTarball](@docroot@/language/builtins.md#builtins-fetchTarball) under the hood, so it will cache channels. + > Use `--tarball-ttl` or the nix configuration option `tarball-ttl` to change this behavior. + - `--list-generations` Prints a list of all the current existing generations for the From 633d39109b292e88bdc98ff622f13153e866eab2 Mon Sep 17 00:00:00 2001 From: Jade Masker Date: Sun, 1 Jun 2025 15:55:49 -0400 Subject: [PATCH 2/3] remove overly verbose mention of fetchTarball Co-authored-by: Valentin Gagarin --- doc/manual/source/command-ref/nix-channel.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/manual/source/command-ref/nix-channel.md b/doc/manual/source/command-ref/nix-channel.md index 4a7555c90..b1b2812d2 100644 --- a/doc/manual/source/command-ref/nix-channel.md +++ b/doc/manual/source/command-ref/nix-channel.md @@ -55,7 +55,7 @@ This command has the following operations: > **Note** > - > `--update` uses [fetchTarball](@docroot@/language/builtins.md#builtins-fetchTarball) under the hood, so it will cache channels. + > Downloaded channel contents are cached. > Use `--tarball-ttl` or the nix configuration option `tarball-ttl` to change this behavior. - `--list-generations` From c0ceaa2d5db4a2ad96c4b7ee475dc53834d6a502 Mon Sep 17 00:00:00 2001 From: Jade Masker Date: Sun, 1 Jun 2025 15:56:46 -0400 Subject: [PATCH 3/3] add reference to the tarball-ttl documentation Co-authored-by: Valentin Gagarin --- doc/manual/source/command-ref/nix-channel.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/manual/source/command-ref/nix-channel.md b/doc/manual/source/command-ref/nix-channel.md index b1b2812d2..ed9cbb41f 100644 --- a/doc/manual/source/command-ref/nix-channel.md +++ b/doc/manual/source/command-ref/nix-channel.md @@ -56,7 +56,7 @@ This command has the following operations: > **Note** > > Downloaded channel contents are cached. - > Use `--tarball-ttl` or the nix configuration option `tarball-ttl` to change this behavior. + > Use `--tarball-ttl` or the [`tarball-ttl` configuration option](@docroot@/command-ref/conf-file.md#conf-tarball-ttl) to change the validity period of cached downloads. - `--list-generations`