From 012fdbe02c4c59e1170a5b7ddf9245c03655895e Mon Sep 17 00:00:00 2001
From: Felix Stupp <me+github/security-7XJy2od8@banananet.work>
Date: Tue, 22 Apr 2025 10:07:43 +0200
Subject: [PATCH] nixos/nix-flakes: ref to man page about flake registry

---
 nixos/modules/config/nix-flakes.nix | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/nixos/modules/config/nix-flakes.nix b/nixos/modules/config/nix-flakes.nix
index 69388e791154..1a7b2724b486 100644
--- a/nixos/modules/config/nix-flakes.nix
+++ b/nixos/modules/config/nix-flakes.nix
@@ -19,6 +19,10 @@ let
 
   cfg = config.nix;
 
+  flakeRefFormat = ''
+    The format of flake references is described in {manpage}`nix3-flake(1)`.
+  '';
+
 in
 {
   options = {
@@ -46,7 +50,11 @@ in
                     type = "indirect";
                     id = "nixpkgs";
                   };
-                  description = "The flake reference to be rewritten.";
+                  description = ''
+                    The flake reference to be rewritten.
+
+                    ${flakeRefFormat}
+                  '';
                 };
                 to = mkOption {
                   type = referenceAttrs;
@@ -55,7 +63,11 @@ in
                     owner = "my-org";
                     repo = "my-nixpkgs";
                   };
-                  description = "The flake reference {option}`from` is rewritten to.";
+                  description = ''
+                    The flake reference {option}`from` is rewritten to.
+
+                    ${flakeRefFormat}
+                  '';
                 };
                 flake = mkOption {
                   type = types.nullOr types.attrs;
@@ -96,6 +108,8 @@ in
         default = { };
         description = ''
           A system-wide flake registry.
+
+          See {manpage}`nix3-registry(1)` for more information.
         '';
       };
     };