summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorAnton Mosich <anton@mosich.at>2025-11-29 19:39:22 +0100
committerAnton Mosich <anton@mosich.at>2025-11-29 22:03:10 +0100
commit4fc8af31c0273cb6b89460f9c145028d3e10f3a9 (patch)
treee41ad3b6959d399a96af53f9d2d7113e80f8b030 /lib
parent0f8e9ceb2175f2c8e63d966dffd35372ba370a37 (diff)
docs/lib: use note/warning markup more consistently
Diffstat (limited to 'lib')
-rw-r--r--lib/attrsets.nix4
-rw-r--r--lib/generators.nix4
-rw-r--r--lib/options.nix8
3 files changed, 10 insertions, 6 deletions
diff --git a/lib/attrsets.nix b/lib/attrsets.nix
index dfcb2d3186fe..b8a98de69971 100644
--- a/lib/attrsets.nix
+++ b/lib/attrsets.nix
@@ -715,10 +715,10 @@ rec {
Iterates over every name-value pair in the given attribute set.
The result of the callback function is often called `acc` for accumulator. It is passed between callbacks from left to right and the final `acc` is the return value of `foldlAttrs`.
- Attention:
-
+ ::: {.note}
There is a completely different function `lib.foldAttrs`
which has nothing to do with this function, despite the similar name.
+ :::
# Inputs
diff --git a/lib/generators.nix b/lib/generators.nix
index ed0cbd881813..613a83e25e5e 100644
--- a/lib/generators.nix
+++ b/lib/generators.nix
@@ -756,9 +756,9 @@ rec {
* `indent` - initial indent.
* `asBindings` - by default generate single value, but with this use attrset to set global vars.
- Attention:
-
+ ::: {.note}
Regardless of multiline parameter there is no trailing newline.
+ :::
# Inputs
diff --git a/lib/options.nix b/lib/options.nix
index 99f47fe96b5d..a36fc2220d21 100644
--- a/lib/options.nix
+++ b/lib/options.nix
@@ -444,14 +444,18 @@ rec {
/**
Require a single definition.
- WARNING: Does not perform nested checks, as this does not run the merge function!
+ ::: {.warning}
+ Does not perform nested checks, as this does not run the merge function!
+ :::
*/
mergeOneOption = mergeUniqueOption { message = ""; };
/**
Require a single definition.
- NOTE: When the type is not checked completely by check, pass a merge function for further checking (of sub-attributes, etc).
+ ::: {.note}
+ When the type is not checked completely by check, pass a merge function for further checking (of sub-attributes, etc).
+ :::
# Inputs