Automated rfc145 migration for comments into doc-comments

NixOS · May 1, 2024 · e05057e · e05057e
1 parent 6fdb14c
commit e05057e
Show file tree

Hide file tree

Showing 944 changed files with 18,269 additions and 10,703 deletions.
diff --git a/flake.nix b/flake.nix
@@ -91,16 +91,23 @@
       nixosModules = {
         notDetected = ./nixos/modules/installer/scan/not-detected.nix;
 
-        /*
+        /**
           Make the `nixpkgs.*` configuration read-only. Guarantees that `pkgs`
           is the way you initialize it.
 
-          Example:
 
-              {
-                imports = [ nixpkgs.nixosModules.readOnlyPkgs ];
-                nixpkgs.pkgs = nixpkgs.legacyPackages.x86_64-linux;
-              }
+          # Examples
+          :::{.example}
+          ## `readOnlyPkgs` usage example
+
+          ```nix
+          {
+            imports = [ nixpkgs.nixosModules.readOnlyPkgs ];
+            nixpkgs.pkgs = nixpkgs.legacyPackages.x86_64-linux;
+          }
+          ```
+
+          :::
         */
         readOnlyPkgs = ./nixos/modules/misc/nixpkgs/read-only.nix;
       };