revised comments in plotting functions