fix docs, refs #1209
that part makes no sense, refs #1209
allow configuration of serialization behavior, closes #1210
merge 017b5452d4fe1bc008a8aeddb545e41d5ac33f39 to 2370672ab3e98bc36eb8c49a81d37ab5247e5a24 (from 1.0)