diff options
| author | Eelco Dolstra <edolstra@gmail.com> | 2023-05-31 12:10:32 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-05-31 12:10:32 +0200 |
| commit | 9a5b9c588fdafd0d22fb5fa6dfa683194450da67 (patch) | |
| tree | 86f2a9e0f13781017515c3e2a6d03d7d9201a708 | |
| parent | 38491443038c1efb7c42e3a85b9b1656d6a04cbf (diff) | |
| parent | 9afd525e1847650589a376a5d3185241e4936b5d (diff) | |
Merge pull request #8421 from fricklerhandwerk/doc-replaceStrings
update documentation according to release notes
| -rw-r--r-- | doc/manual/src/release-notes/rl-next.md | 2 | ||||
| -rw-r--r-- | src/libexpr/primops.cc | 6 |
2 files changed, 6 insertions, 2 deletions
diff --git a/doc/manual/src/release-notes/rl-next.md b/doc/manual/src/release-notes/rl-next.md index f92625887..27eb69cb0 100644 --- a/doc/manual/src/release-notes/rl-next.md +++ b/doc/manual/src/release-notes/rl-next.md @@ -4,4 +4,4 @@ The number of parallel downloads (also known as substitutions) has been separated from the [`--max-jobs` setting](../command-ref/conf-file.md#conf-max-jobs). The new setting is called [`max-substitution-jobs`](../command-ref/conf-file.md#conf-max-substitution-jobs). The number of parallel downloads is now set to 16 by default (previously, the default was 1 due to the coupling to build jobs). -- The function `builtins.replaceStrings` is now lazy in the value of its second argument `to`, that is a replacee in `to` is only evaluated when its corresponding pattern in `from` is matched in the string `s`. +- The function [`builtins.replaceStrings`](@docroot@/language/builtins.md#builtins-replaceStrings) is now lazy in the value of its second argument `to`. That is, `to` is only evaluated when its corresponding pattern in `from` is matched in the string `s`. diff --git a/src/libexpr/primops.cc b/src/libexpr/primops.cc index 87515f384..42efca4e7 100644 --- a/src/libexpr/primops.cc +++ b/src/libexpr/primops.cc @@ -3957,7 +3957,11 @@ static RegisterPrimOp primop_replaceStrings({ .args = {"from", "to", "s"}, .doc = R"( Given string *s*, replace every occurrence of the strings in *from* - with the corresponding string in *to*. For example, + with the corresponding string in *to*. + + The argument *to* is lazy, that is, it is only evaluated when its corresponding pattern in *from* is matched in the string *s* + + Example: ```nix builtins.replaceStrings ["oo" "a"] ["a" "i"] "foobar" |