added some doc comments