This is mostly for use in *other* grid constructors, as it enables
putting a grid into a defined state before allocating and/or filling
the specific fields of the UnstructuredGrid.
While here, add a Doxygen \file command lest function documentation
not be output to the documentation set.