modify some function comments and add in test comments