From 2a943de4be22e8d4f081195332a119a1185d4065 Mon Sep 17 00:00:00 2001 From: Gabriella Gonzalez Date: Tue, 21 Nov 2023 08:59:26 -0800 Subject: [PATCH] Address review feedback MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit … by explaining the distinction between the various types of flake reference updates --- src/libstore/globals.hh | 26 ++++++++++++++++++++------ 1 file changed, 20 insertions(+), 6 deletions(-) diff --git a/src/libstore/globals.hh b/src/libstore/globals.hh index 1d95b0141..407d31424 100644 --- a/src/libstore/globals.hh +++ b/src/libstore/globals.hh @@ -627,13 +627,27 @@ public: Nix caches tarballs in `$XDG_CACHE_HOME/nix/tarballs`. - Files fetched via `NIX_PATH`, `fetchGit`, `fetchMercurial`, - `fetchTarball`, and `fetchurl` respect this TTL. + This option affects: - This option also affects how often the global flake registry is - updated. For example, a flake URI like `nixpkgs#hello` will trigger - a new download of Nixpkgs if the last download is older than the - `tarball-ttl`. + - files fetched via `NIX_PATH`, `fetchGit`, `fetchMercurial`, + `fetchTarball`, and `fetchurl` + + - how often the global flake registry is updated (i.e. how often + indirect flake references are updated) + + - how often unpinned flake references (e.g. `github:NixOS/nixpkgs`) + are updated + + For example, for a flake reference like `nixpkgs#hello` this option + affects how that flake resolves in two separate ways: + + - It affects how often the `nixpkgs` indirect flake reference is + updated (which is rare: it usually resolves to + `github:NixOS/nixpkgs/nixpkgs-unstable`). + + - It affects how often the `github:NixOS/nixpkgs/nixpkgs-unstable` + flake reference is updated (which is common: the `nixpkgs-unstable` + branch of the repository changes frequently). )"}; Setting requireSigs{