modified comments in shared functions