added documentation about bool return values