document some of the vector functions