Update the documentation of VectorTools::project_boundary_values().

This had apparently confused a user on the mailing list earlier today, so structure the
documentation better.