diff options
author | Silvan Mosberger <contact@infinisil.com> | 2024-01-18 16:13:56 +0100 |
---|---|---|
committer | GitHub <noreply@github.com> | 2024-01-18 16:13:56 +0100 |
commit | c2c56c3d3ceef312b4e508c147c46cb24abf45dd (patch) | |
tree | 7f6b134cc833f407b1e7c6982e8b58f88a3742bc /doc/languages-frameworks | |
parent | 15c31afd8ae99e9d3a2d6af0d804f3a53f6aa848 (diff) | |
parent | d3a7f4571657c559e8da50945dc71f592633e916 (diff) | |
download | nixlib-c2c56c3d3ceef312b4e508c147c46cb24abf45dd.tar nixlib-c2c56c3d3ceef312b4e508c147c46cb24abf45dd.tar.gz nixlib-c2c56c3d3ceef312b4e508c147c46cb24abf45dd.tar.bz2 nixlib-c2c56c3d3ceef312b4e508c147c46cb24abf45dd.tar.lz nixlib-c2c56c3d3ceef312b4e508c147c46cb24abf45dd.tar.xz nixlib-c2c56c3d3ceef312b4e508c147c46cb24abf45dd.tar.zst nixlib-c2c56c3d3ceef312b4e508c147c46cb24abf45dd.zip |
Merge pull request #275935 from mrgalopes/update-rust-docs
doc: update buildRustPackage documentation
Diffstat (limited to 'doc/languages-frameworks')
-rw-r--r-- | doc/languages-frameworks/rust.section.md | 19 |
1 files changed, 10 insertions, 9 deletions
diff --git a/doc/languages-frameworks/rust.section.md b/doc/languages-frameworks/rust.section.md index 9be381c0bfe2..a81ba1e456e8 100644 --- a/doc/languages-frameworks/rust.section.md +++ b/doc/languages-frameworks/rust.section.md @@ -44,20 +44,21 @@ rustPlatform.buildRustPackage rec { } ``` -`buildRustPackage` requires either the `cargoSha256` or the -`cargoHash` attribute which is computed over all crate sources of this -package. `cargoHash256` is used for traditional Nix SHA-256 hashes, -such as the one in the example above. `cargoHash` should instead be -used for [SRI](https://www.w3.org/TR/SRI/) hashes. For example: +`buildRustPackage` requires either the `cargoHash` or the `cargoSha256` +attribute which is computed over all crate sources of this package. +`cargoSha256` is used for traditional Nix SHA-256 hashes. `cargoHash` should +instead be used for [SRI](https://www.w3.org/TR/SRI/) hashes and should be +preferred. For example: + +```nix + cargoHash = "sha256-l1vL2ZdtDRxSGvP0X/l3nMw8+6WF67KPutJEzUROjg8="; +``` Exception: If the application has cargo `git` dependencies, the `cargoHash`/`cargoSha256` approach will not work, and you will need to copy the `Cargo.lock` file of the application -to nixpkgs and continue with the next section for specifying the options of the`cargoLock` +to nixpkgs and continue with the next section for specifying the options of the `cargoLock` section. -```nix - cargoHash = "sha256-l1vL2ZdtDRxSGvP0X/l3nMw8+6WF67KPutJEzUROjg8="; -``` Both types of hashes are permitted when contributing to nixpkgs. The Cargo hash is obtained by inserting a fake checksum into the |