From 61078bba32c72a5389a29b12b99f7ea74a095015 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Tomulik?= Date: Tue, 13 Nov 2018 22:25:47 +0100 Subject: refine get_env_bool() docstrings --- src/engine/SCons/Util.py | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/src/engine/SCons/Util.py b/src/engine/SCons/Util.py index f20aae3..07f62ea 100644 --- a/src/engine/SCons/Util.py +++ b/src/engine/SCons/Util.py @@ -1598,16 +1598,16 @@ def cmp(a, b): def get_env_bool(env, name, default=False): - """ - Get a value of an environment variable converting it to boolean. - - - FOO=1, FOO=123, FOO=true, FOO=yes, FOO=y, FOO=on are examples of ``True`` - values. - - FOO=0, FOO=false, FOO=no, FOO=n, FOO=off are examples of ``False`` - values. + """Get a value of env[name] converted to boolean. The value of env[name] is + interpreted as follows: 'true', 'yes', 'y', 'on' (case insensitive) and + anything convertible to int that yields non-zero integer are True values; + '0', 'false', 'no', 'n' and 'off' (case insensitive) are False values. For + all other cases, default value is returned. - If a variable can't be converted to a boolean, default value is returned - (``False`` by default). + :Parameters: + - `env` - dict or dict-like object, a convainer with variables + - `name` - name of the variable in env to be returned + - `default` - returned when env[name] does not exist or can't be converted to bool """ try: var = env[name] -- cgit v0.12