corrections to satisfy coding guidelines
added description (but not compatible with doc system), added function is_defined()