diff options
author | Profpatsch <mail@profpatsch.de> | 2018-04-03 13:06:39 +0200 |
---|---|---|
committer | Profpatsch <mail@profpatsch.de> | 2018-04-27 18:59:39 +0200 |
commit | 21b87a7bdb31f19812e0f989cc9e0304a9972e32 (patch) | |
tree | ff180662b8d8773da288c613555faabfc917c1d1 /doc/functions.xml | |
parent | 06156610f139dbbba43b6610f2528ad33e746529 (diff) |
docs: initial manual entry for `lib/debug.nix`
It is more of a stub for now, but at least points to the right file.
Diffstat (limited to 'doc/functions.xml')
-rw-r--r-- | doc/functions.xml | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/functions.xml b/doc/functions.xml index f790512e7db1..b2e450972947 100644 --- a/doc/functions.xml +++ b/doc/functions.xml @@ -294,6 +294,22 @@ merge:"diff3" </section> +<section xml:id="sec-debug"> + <title>Debugging Nix Expressions</title> + + <para>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.</para> + + + <para>In the <literal>lib/debug.nix</literal> file you will find a number of + functions that help (pretty-)printing values while evaluation is runnnig. You + can even specify how deep these values should be printed recursively, and + transform them on the fly. Please consult the docstrings in + <literal>lib/debug.nix</literal> for usage information.</para> +</section> + <section xml:id="sec-fhs-environments"> <title>buildFHSUserEnv</title> |