docs: use admonish for callouts
Change-Id: Icec7321a49c40e7f7bcb1e4b307f13b8db4eac25 Reviewed-on: https://cl.tvl.fyi/c/depot/+/11862 Reviewed-by: flokli <flokli@flokli.de> Tested-by: BuildkiteCI
This commit is contained in:
parent
8dde022d31
commit
bf541acf29
5 changed files with 21 additions and 9 deletions
|
|
@ -82,8 +82,10 @@ stack when the scope ends.
|
|||
|
||||
## Moving parts
|
||||
|
||||
WARNING: This documents the *current* implementation. If you only care about the
|
||||
```admonish caution
|
||||
This documents the *current* implementation. If you only care about the
|
||||
conceptual aspects, see above.
|
||||
```
|
||||
|
||||
There's a few types involved:
|
||||
|
||||
|
|
|
|||
|
|
@ -23,8 +23,10 @@ formats:
|
|||
This format is used for a special case where a derivation attribute directly
|
||||
refers to a derivation path (e.g. by accessing `.drvPath` on a derivation).
|
||||
|
||||
Note: In C++ Nix this case is quite special and actually requires a
|
||||
store-database query during evaluation.
|
||||
```admonish note
|
||||
In C++ Nix this case is quite special and actually requires a store-database
|
||||
query during evaluation.
|
||||
```
|
||||
|
||||
3. `<path>` - a non-descript store path input, usually a plain source file (e.g.
|
||||
from something like `src = ./.` or `src = ./foo.txt`).
|
||||
|
|
@ -90,8 +92,10 @@ C++ Nix has several builtins that interface directly with string contexts:
|
|||
* `unsafeDiscardOutputDependency`: drops dependencies on the *outputs* of a
|
||||
`.drv` in the context, passing only the literal `.drv` itself
|
||||
|
||||
Note: This is only used for special test-cases in nixpkgs, and deprecated Nix
|
||||
```admonish note
|
||||
This is only used for special test-cases in nixpkgs, and deprecated Nix
|
||||
commands like `nix-push`.
|
||||
```
|
||||
* `getContext`: returns the string context in serialised form as a Nix attribute
|
||||
set
|
||||
* `appendContext`: adds a given string context to the string in the same format
|
||||
|
|
@ -159,8 +163,10 @@ one evaluation should be created in Nix. This metadata needs to be available in
|
|||
These queries will need to be asked of the metadata when populating the
|
||||
derivation fields.
|
||||
|
||||
Note: Depending on how we implement `builtins.placeholder`, it might be useful
|
||||
```admonish note
|
||||
Depending on how we implement `builtins.placeholder`, it might be useful
|
||||
to track created placeholders in this metadata, too.
|
||||
```
|
||||
|
||||
### Context builtins
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue