document the parse_boolean method