From 921c2d503a63f4769fdf1c7e6eb31be2706f9bea Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Thu, 15 Oct 2020 14:20:44 +0200 Subject: Add ability to specify fallback value for NULL substitutions with in.null --- doc/manual.cli | 13 +++++++++++++ 1 file changed, 13 insertions(+) (limited to 'doc/manual.cli') diff --git a/doc/manual.cli b/doc/manual.cli index 59084d6..0cd5a5e 100644 --- a/doc/manual.cli +++ b/doc/manual.cli @@ -8156,6 +8156,19 @@ target-specific variables. Typed variable values are converted to string using the corresponding \c{builtin.string()} function overload before substitution. +Using an undefined variable in a substitution is an error. Using a \c{null} +value in a substitution is also an error unless the fallback value is +specified with the \c{in.null} variable. For example: + +\ +# buildfile + +h{config}: in{config} +{ + in.null = '' # Substitute null values with empty string. +} +\ + A number of other build system modules, for example, \l{#module-version \c{version}} and \l{#module-bash \c{bash}}, are based on the \c{in} module and provide extended functionality. The \c{in} preprocessing rule matches any -- cgit v1.1