vec_for_vertex and vec_for_normal both use world coordinates and behave exactly as described - I've checked the code to make sure. So, the manual is not to blame in this case.