mergestate: document mergestate records in an organized way
This makes clear which mergestate record is used for what and group them based
on how they are used right now.
Differential Revision: https://phab.mercurial-scm.org/D8719
#require docutils gettext
$ $TESTDIR/check-gendoc zh_CN
checking for parse errors