doc: normalize markdown for nixos-render-docs

pandoc recognizes `::: note` admonitions, nixos-render-docs only
recognizes `::: {.note}`. surprisingly pandoc also emits the correct
docbook tags for `[](#xref)`s, so we can use that too.
This commit is contained in:
pennae 2023-06-10 18:06:27 +02:00
parent f9ba30270e
commit 2ecc93d6fe
3 changed files with 6 additions and 5 deletions

View file

@ -1,5 +1,5 @@
# Testers {#chap-testers} # Testers {#chap-testers}
This chapter describes several testing builders which are available in the <literal>testers</literal> namespace. This chapter describes several testing builders which are available in the `testers` namespace.
## `hasPkgConfigModule` {#tester-hasPkgConfigModule} ## `hasPkgConfigModule` {#tester-hasPkgConfigModule}

View file

@ -128,7 +128,7 @@ Prefer `passthru.tests` for tests that are introduced in nixpkgs because:
* we can run `passthru.tests` independently * we can run `passthru.tests` independently
* `installCheckPhase` adds overhead to each build * `installCheckPhase` adds overhead to each build
For more on how to write and run package tests, see <xref linkend="sec-package-tests"/>. For more on how to write and run package tests, see [](#sec-package-tests).
#### NixOS tests {#var-meta-tests-nixos} #### NixOS tests {#var-meta-tests-nixos}

View file

@ -971,7 +971,8 @@ to `~/.gdbinit`. GDB will then be able to find debug information installed via `
The installCheck phase checks whether the package was installed correctly by running its test suite against the installed directories. The default `installCheck` calls `make installcheck`. The installCheck phase checks whether the package was installed correctly by running its test suite against the installed directories. The default `installCheck` calls `make installcheck`.
It is often better to add tests that are not part of the source distribution to `passthru.tests` (see <xref linkend="var-meta-tests"/>). This avoids adding overhead to every build and enables us to run them independently. It is often better to add tests that are not part of the source distribution to `passthru.tests` (see
[](#var-meta-tests)). This avoids adding overhead to every build and enables us to run them independently.
#### Variables controlling the installCheck phase {#variables-controlling-the-installcheck-phase} #### Variables controlling the installCheck phase {#variables-controlling-the-installcheck-phase}
@ -1234,7 +1235,7 @@ This runs the strip command on installed binaries and libraries. This removes un
This setup hook patches installed scripts to add Nix store paths to their shebang interpreter as found in the build environment. The [shebang](https://en.wikipedia.org/wiki/Shebang_(Unix)) line tells a Unix-like operating system which interpreter to use to execute the script's contents. This setup hook patches installed scripts to add Nix store paths to their shebang interpreter as found in the build environment. The [shebang](https://en.wikipedia.org/wiki/Shebang_(Unix)) line tells a Unix-like operating system which interpreter to use to execute the script's contents.
::: note ::: {.note}
The [generic builder][generic-builder] populates `PATH` from inputs of the derivation. The [generic builder][generic-builder] populates `PATH` from inputs of the derivation.
::: :::
@ -1272,7 +1273,7 @@ patchShebangs --build configure
Interpreter paths that point to a valid Nix store location are not changed. Interpreter paths that point to a valid Nix store location are not changed.
::: note ::: {.note}
A script file must be marked as executable, otherwise it will not be A script file must be marked as executable, otherwise it will not be
considered. considered.
::: :::