added some general comments about functions