add vlength
add documntation.