updated comments / ldoc documentation