added some remarks on CDEF versus VDEF to the docs -- Pablo Sanchez