{buildRustCrate, defaultCrateOverrides}: remove

doc/languages-frameworks/rust.section.md

@@ -739,170 +739,6 @@ stdenv.mkDerivation rec {
 }
 ```
 
-## `buildRustCrate`: Compiling Rust crates using Nix instead of Cargo {#compiling-rust-crates-using-nix-instead-of-cargo}
-
-### Simple operation {#simple-operation}
-
-When run, `cargo build` produces a file called `Cargo.lock`,
-containing pinned versions of all dependencies. Nixpkgs contains a
-tool called `crate2Nix` (`nix-shell -p crate2nix`), which can be
-used to turn a `Cargo.lock` into a Nix expression.  That Nix
-expression calls `rustc` directly (hence bypassing Cargo), and can
-be used to compile a crate and all its dependencies.
-
-See [`crate2nix`'s documentation](https://github.com/kolloch/crate2nix#known-restrictions)
-for instructions on how to use it.
-
-### Handling external dependencies {#handling-external-dependencies}
-
-Some crates require external libraries. For crates from
-[crates.io](https://crates.io), such libraries can be specified in
-`defaultCrateOverrides` package in nixpkgs itself.
-
-Starting from that file, one can add more overrides, to add features
-or build inputs by overriding the hello crate in a separate file.
-
-```nix
-with import <nixpkgs> {};
-((import ./hello.nix).hello {}).override {
-  crateOverrides = defaultCrateOverrides // {
-    hello = attrs: { buildInputs = [ openssl ]; };
-  };
-}
-```
-
-Here, `crateOverrides` is expected to be a attribute set, where the
-key is the crate name without version number and the value a function.
-The function gets all attributes passed to `buildRustCrate` as first
-argument and returns a set that contains all attribute that should be
-overwritten.
-
-For more complicated cases, such as when parts of the crate's
-derivation depend on the crate's version, the `attrs` argument of
-the override above can be read, as in the following example, which
-patches the derivation:
-
-```nix
-with import <nixpkgs> {};
-((import ./hello.nix).hello {}).override {
-  crateOverrides = defaultCrateOverrides // {
-    hello = attrs: lib.optionalAttrs (lib.versionAtLeast attrs.version "1.0")  {
-      postPatch = ''
-        substituteInPlace lib/zoneinfo.rs \
-          --replace-fail "/usr/share/zoneinfo" "${tzdata}/share/zoneinfo"
-      '';
-    };
-  };
-}
-```
-
-Another situation is when we want to override a nested
-dependency. This actually works in the exact same way, since the
-`crateOverrides` parameter is forwarded to the crate's
-dependencies. For instance, to override the build inputs for crate
-`libc` in the example above, where `libc` is a dependency of the main
-crate, we could do:
-
-```nix
-with import <nixpkgs> {};
-((import hello.nix).hello {}).override {
-  crateOverrides = defaultCrateOverrides // {
-    libc = attrs: { buildInputs = []; };
-  };
-}
-```
-
-### Options and phases configuration {#options-and-phases-configuration}
-
-Actually, the overrides introduced in the previous section are more
-general. A number of other parameters can be overridden:
-
-- The version of `rustc` used to compile the crate:
-
-  ```nix
-  (hello {}).override { rust = pkgs.rust; }
-  ```
-
-- Whether to build in release mode or debug mode (release mode by
-  default):
-
-  ```nix
-  (hello {}).override { release = false; }
-  ```
-
-- Whether to print the commands sent to `rustc` when building
-  (equivalent to `--verbose` in cargo:
-
-  ```nix
-  (hello {}).override { verbose = false; }
-  ```
-
-- Extra arguments to be passed to `rustc`:
-
-  ```nix
-  (hello {}).override { extraRustcOpts = "-Z debuginfo=2"; }
-  ```
-
-- Phases, just like in any other derivation, can be specified using
-  the following attributes: `preUnpack`, `postUnpack`, `prePatch`,
-  `patches`, `postPatch`, `preConfigure` (in the case of a Rust crate,
-  this is run before calling the "build" script), `postConfigure`
-  (after the "build" script),`preBuild`, `postBuild`, `preInstall` and
-  `postInstall`. As an example, here is how to create a new module
-  before running the build script:
-
-  ```nix
-  (hello {}).override {
-    preConfigure = ''
-       echo "pub const PATH=\"${hi.out}\";" >> src/path.rs"
-    '';
-  }
-  ```
-
-### Setting Up `nix-shell` {#setting-up-nix-shell}
-
-Oftentimes you want to develop code from within `nix-shell`. Unfortunately
-`buildRustCrate` does not support common `nix-shell` operations directly
-(see [this issue](https://github.com/NixOS/nixpkgs/issues/37945))
-so we will use `stdenv.mkDerivation` instead.
-
-Using the example `hello` project above, we want to do the following:
-
-- Have access to `cargo` and `rustc`
-- Have the `openssl` library available to a crate through it's _normal_
-  compilation mechanism (`pkg-config`).
-
-A typical `shell.nix` might look like:
-
-```nix
-with import <nixpkgs> {};
-
-stdenv.mkDerivation {
-  name = "rust-env";
-  nativeBuildInputs = [
-    rustc cargo
-
-    # Example Build-time Additional Dependencies
-    pkg-config
-  ];
-  buildInputs = [
-    # Example Run-time Additional Dependencies
-    openssl
-  ];
-
-  # Set Environment Variables
-  RUST_BACKTRACE = 1;
-}
-```
-
-You should now be able to run the following:
-
-```ShellSession
-$ nix-shell --pure
-$ cargo build
-$ cargo test
-```
-
 ## Using community maintained Rust toolchains {#using-community-maintained-rust-toolchains}
 
 ::: {.note}

doc/redirects.json

@@ -3679,21 +3679,6 @@
   "rust-package-built-with-meson": [
     "index.html#rust-package-built-with-meson"
   ],
-  "compiling-rust-crates-using-nix-instead-of-cargo": [
-    "index.html#compiling-rust-crates-using-nix-instead-of-cargo"
-  ],
-  "simple-operation": [
-    "index.html#simple-operation"
-  ],
-  "handling-external-dependencies": [
-    "index.html#handling-external-dependencies"
-  ],
-  "options-and-phases-configuration": [
-    "index.html#options-and-phases-configuration"
-  ],
-  "setting-up-nix-shell": [
-    "index.html#setting-up-nix-shell"
-  ],
   "using-community-maintained-rust-toolchains": [
     "index.html#using-community-maintained-rust-toolchains"
   ],

nixos/doc/manual/release-notes/rl-2505.section.md

@@ -261,6 +261,10 @@
 
 - `docker_24` has been removed, as it was EOL with vulnerabilites since June 08, 2024.
 
+- `buildRustCrate` build helper has been removed as it was only used by out-of-tree packages
+
+- `defaultCrateOverrides` have been removed as they were only used by `buildRustCrate`
+
 - `containerd` has been updated to v2, which contains breaking changes. See the [containerd
   2.0](https://github.com/containerd/containerd/blob/main/docs/containerd-2.0.md) documentation for more
   details.