Improve documentation of data type declarations (Trac #1901)