From 6ba4b1d25218e4c4ca4caf65af8ef61e2e3a91df Mon Sep 17 00:00:00 2001
From: Jeremy Fleischman <jeremyfleischman@gmail.com>
Date: Sun, 13 Apr 2025 11:30:18 -0700
Subject: [PATCH] Update `nix fmt` man page with official formatter example

The current example relies upon [nixfmt's deprecated tree traversal
behavior](https://github.com/NixOS/nixfmt/pull/240). The simplest
alternative is the new `nixfmt-tree` wrapper for `nixfmt`/`treefmt`.

(cherry picked from commit 6f71d8a9c2d36be2bde7f9c58b81b13eca20ce0d)
---
 src/nix/fmt.md | 28 +++-------------------------
 1 file changed, 3 insertions(+), 25 deletions(-)

diff --git a/src/nix/fmt.md b/src/nix/fmt.md
index b4693eb65..90f311165 100644
--- a/src/nix/fmt.md
+++ b/src/nix/fmt.md
@@ -9,37 +9,15 @@ Flags can be forwarded to the formatter by using `--` followed by the flags.
 Any arguments will be forwarded to the formatter. Typically these are the files to format.
 
 
-# Examples
+# Example
 
-With [nixpkgs-fmt](https://github.com/nix-community/nixpkgs-fmt):
+To use the [official Nix formatter](https://github.com/NixOS/nixfmt):
 
 ```nix
 # flake.nix
 {
   outputs = { nixpkgs, self }: {
-    formatter.x86_64-linux = nixpkgs.legacyPackages.x86_64-linux.nixpkgs-fmt;
-  };
-}
-```
-
-With [nixfmt](https://github.com/NixOS/nixfmt):
-
-```nix
-# flake.nix
-{
-  outputs = { nixpkgs, self }: {
-    formatter.x86_64-linux = nixpkgs.legacyPackages.x86_64-linux.nixfmt-rfc-style;
-  };
-}
-```
-
-With [Alejandra](https://github.com/kamadorueda/alejandra):
-
-```nix
-# flake.nix
-{
-  outputs = { nixpkgs, self }: {
-    formatter.x86_64-linux = nixpkgs.legacyPackages.x86_64-linux.alejandra;
+    formatter.x86_64-linux = nixpkgs.legacyPackages.${system}.nixfmt-tree;
   };
 }
 ```