(MCO-84) deprecate and remove flattened output

This commit adds deprecation warnings when using the :flatten display
preference.
Merge pull request #140 from ploubser/bug/master/mco-84

(MCO-84) deprecate and remove flattened output