movefasta/nixpkgs
1
0
Fork 0
mirror of https://github.com/NixOS/nixpkgs.git synced 2025-06-11 20:25:32 +03:00
Code Issues Projects Releases Packages Wiki Activity

doc/functions/debug: convert to CommonMark

Browse source
This commit is contained in:
Ryan Mulligan 2021-06-06 07:45:53 -07:00
parent c43e0f4873
commit fbfdc8fc0b
3 changed files with 6 additions and 15 deletions
Download patch file Download diff file Expand all files Collapse all files

5
doc/functions/debug.section.md Normal file
View file

@ -0,0 +1,5 @@
# Debugging Nix Expressions {#sec-debug}
Nix is a unityped, dynamic language, this means every value can potentially appear anywhere. Since it is also non-strict, evaluation order and what ultimately is evaluated might surprise you. Therefore it is important to be able to debug nix expressions.
In the `lib/debug.nix` file you will find a number of functions that help (pretty-)printing values while evaluation is running. You can even specify how deep these values should be printed recursively, and transform them on the fly. Please consult the docstrings in `lib/debug.nix` for usage information.