doc: Add more links

Mostly in the 2.30 release notes

Author: roberth

doc/manual/source/release-notes/rl-2.30.md

@@ -2,7 +2,7 @@
 
 ## Backward-incompatible changes and deprecations
 
-- `build-dir` no longer defaults to `$TMPDIR`
+- [`build-dir`] no longer defaults to `$TMPDIR`
 
   The directory in which temporary build directories are created no longer defaults
   to `TMPDIR` or `/tmp`, to avoid builders making their directories
@@ -19,9 +19,9 @@
   [structured attrs]: @docroot@/language/advanced-attributes.md#adv-attr-structuredAttrs
   [`builtins.derivation`]: @docroot@/language/builtins.html#builtins-derivation
 
-- Rename `nix profile install` to `nix profile add` [#13224](https://github.com/NixOS/nix/pull/13224)
+- Rename `nix profile install` to [`nix profile add`] [#13224](https://github.com/NixOS/nix/pull/13224)
 
-  The command `nix profile install` has been renamed to `nix profile add` (though the former is still available as an alias). This is because the verb "add" is a better antonym for the verb "remove" (i.e. `nix profile remove`). Nix also does not have install hooks or general behavior often associated with "installing".
+  The command `nix profile install` has been renamed to [`nix profile add`] (though the former is still available as an alias). This is because the verb "add" is a better antonym for the verb "remove" (i.e. `nix profile remove`). Nix also does not have install hooks or general behavior often associated with "installing".
 
 ## Performance improvements
 
@@ -33,39 +33,39 @@ This release has a number performance improvements, in particular:
 
 ## Features
 
-- Add stack sampling evaluation profiler [#13220](https://github.com/NixOS/nix/pull/13220)
+- Add [stack sampling evaluation profiler] [#13220](https://github.com/NixOS/nix/pull/13220)
 
-  The Nix evaluator now supports [stack sampling evaluation profiling](@docroot@/advanced-topics/eval-profiler.md) via the `--eval-profiler flamegraph` setting.
+  The Nix evaluator now supports [stack sampling evaluation profiling](@docroot@/advanced-topics/eval-profiler.md) via the [`--eval-profiler flamegraph`] setting.
   It outputs collapsed call stack information to the file specified by
-  `--eval-profile-file` (`nix.profile` by default) in a format directly consumable
+  [`--eval-profile-file`] (`nix.profile` by default) in a format directly consumable
   by `flamegraph.pl` and compatible tools like [speedscope](https://speedscope.app/).
-  Sampling frequency can be configured via `--eval-profiler-frequency` (99 Hz by default).
+  Sampling frequency can be configured via [`--eval-profiler-frequency`] (99 Hz by default).
 
-  Unlike the existing `--trace-function-calls`, this profiler includes the name of the function
+  Unlike the existing [`--trace-function-calls`], this profiler includes the name of the function
   being called when it's available.
 
-- `nix repl` prints which variables were loaded [#11406](https://github.com/NixOS/nix/pull/11406)
+- [`nix repl`] prints which variables were loaded [#11406](https://github.com/NixOS/nix/pull/11406)
 
   Instead of `Added <n> variables` it now prints the first 10 variables that were added to the global scope.
 
-- `nix flake archive`: Add `--no-check-sigs` option [#13277](https://github.com/NixOS/nix/pull/13277)
+- `nix flake archive`: Add [`--no-check-sigs`] option [#13277](https://github.com/NixOS/nix/pull/13277)
 
-  This is useful when using `nix flake archive` with the destination set to a remote store.
+  This is useful when using [`nix flake archive`] with the destination set to a remote store.
 
-- Emit warnings for IFDs with `trace-import-from-derivation` option [#13279](https://github.com/NixOS/nix/pull/13279)
+- Emit warnings for IFDs with [`trace-import-from-derivation`] option [#13279](https://github.com/NixOS/nix/pull/13279)
 
-  While we have the setting `allow-import-from-derivation` to deny import-from-derivation (IFD), sometimes users would like to observe IFDs during CI processes to gradually phase out the idiom. The new setting `trace-import-from-derivation`, when set, logs a simple warning to the console.
+  While we have the setting [`allow-import-from-derivation`] to deny import-from-derivation (IFD), sometimes users would like to observe IFDs during CI processes to gradually phase out the idiom. The new setting `trace-import-from-derivation`, when set, logs a simple warning to the console.
 
 - `json-log-path` setting [#13003](https://github.com/NixOS/nix/pull/13003)
 
-  New setting `json-log-path` that sends a copy of all Nix log messages (in JSON format) to a file or Unix domain socket.
+  New setting [`json-log-path`] that sends a copy of all Nix log messages (in JSON format) to a file or Unix domain socket.
 
 - Non-flake inputs now contain a `sourceInfo` attribute [#13164](https://github.com/NixOS/nix/issues/13164) [#13170](https://github.com/NixOS/nix/pull/13170)
 
   Flakes have always had a `sourceInfo` attribute which describes the source of the flake.
   The `sourceInfo.outPath` is often identical to the flake's `outPath`. However, it can differ when the flake is located in a subdirectory of its source.
 
-  Non-flake inputs (i.e. inputs with `flake = false`) can also be located at some path _within_ a wider source.
+  Non-flake inputs (i.e. inputs with [`flake = false`]) can also be located at some path _within_ a wider source.
   This usually happens when defining a relative path input within the same source as the parent flake, e.g. `inputs.foo.url = ./some-file.nix`.
   Such relative inputs will now inherit their parent's `sourceInfo`.
 
@@ -76,13 +76,13 @@ This release has a number performance improvements, in particular:
 
 ## Miscellaneous changes
 
-- `builtins.sort` uses PeekSort [#12623](https://github.com/NixOS/nix/pull/12623)
+- [`builtins.sort`] uses PeekSort [#12623](https://github.com/NixOS/nix/pull/12623)
 
   Previously it used libstdc++'s `std::stable_sort()`. However, that implementation is not reliable if the user-supplied comparison function is not a strict weak ordering.
 
 - Revert incomplete closure mixed download and build feature [#77](https://github.com/NixOS/nix/issues/77) [#12628](https://github.com/NixOS/nix/issues/12628) [#13176](https://github.com/NixOS/nix/pull/13176)
 
-  Since Nix 1.3 (299141ecbd08bae17013226dbeae71e842b4fdd7 in 2013) Nix has attempted to mix together upstream fresh builds and downstream substitutions when remote substuters contain an "incomplete closure" (have some store objects, but not the store objects they reference).
+  Since Nix 1.3 ([commit `299141e`] in 2013) Nix has attempted to mix together upstream fresh builds and downstream substitutions when remote substuters contain an "incomplete closure" (have some store objects, but not the store objects they reference).
   This feature is now removed.
 
   In the worst case, removing this feature could cause more building downstream, but it should not cause outright failures, since this is not happening for opaque store objects that we don't know how to build if we decide not to substitute.
@@ -132,3 +132,22 @@ This release was made possible by the following 32 contributors:
 - Valentin Gagarin [**(@fricklerhandwerk)**](https://github.com/fricklerhandwerk)
 - Vladimír Čunát [**(@vcunat)**](https://github.com/vcunat)
 - Wolfgang Walther [**(@wolfgangwalther)**](https://github.com/wolfgangwalther)
+
+<!-- markdown links -->
+[stack sampling evaluation profiler]: @docroot@/advanced-topics/eval-profiler.md
+[`--eval-profiler`]: @docroot@/command-ref/conf-file.md#conf-eval-profiler
+[`--eval-profiler flamegraph`]: @docroot@/command-ref/conf-file.md#conf-eval-profiler
+[`--trace-function-calls`]: @docroot@/command-ref/conf-file.md#conf-trace-function-calls
+[`--eval-profile-file`]: @docroot@/command-ref/conf-file.md#conf-eval-profile-file
+[`--eval-profiler-frequency`]: @docroot@/command-ref/conf-file.md#conf-eval-profiler-frequency
+[`build-dir`]: @docroot@/command-ref/conf-file.md#conf-build-dir
+[`nix profile add`]: @docroot@/command-ref/new-cli/nix3-profile-add.md
+[`nix repl`]: @docroot@/command-ref/new-cli/nix3-repl.md
+[`nix flake archive`]: @docroot@/command-ref/new-cli/nix3-flake-archive.md
+[`json-log-path`]: @docroot@/command-ref/conf-file.md#conf-json-log-path
+[`trace-import-from-derivation`]: @docroot@/command-ref/conf-file.md#conf-trace-import-from-derivation
+[`allow-import-from-derivation`]: @docroot@/command-ref/conf-file.md#conf-allow-import-from-derivation
+[`builtins.sort`]: @docroot@/language/builtins.md#builtins-sort
+[`flake = false`]: @docroot@/command-ref/new-cli/nix3-flake.md?highlight=false#flake-inputs
+[`--no-check-sigs`]: @docroot@/command-ref/new-cli/nix3-flake-archive.md#opt-no-check-sigs
+[commit `299141e`]: https://github.com/NixOS/nix/commit/299141ecbd08bae17013226dbeae71e842b4fdd7

src/libexpr/include/nix/expr/eval-settings.hh

@@ -211,6 +211,8 @@ struct EvalSettings : Config
           * `flamegraph` stack sampling profiler. Outputs folded format, one line per stack (suitable for `flamegraph.pl` and compatible tools).
 
           Use [`eval-profile-file`](#conf-eval-profile-file) to specify where the profile is saved.
+
+          See [Using the `eval-profiler`](@docroot@/advanced-topics/eval-profiler.md).
         )"};
 
     Setting<Path> evalProfileFile{this, "nix.profile", "eval-profile-file",