improved description of variables