py3: add pycompat.open and replace open() calls
open() requires mode argument as unicodes on Python 3. This patch introduces
pycompat.open() which is inserted to files using transformer and replaces
builtins.open() calls.
#require docutils gettext $ $TESTDIR/check-gendoc da checking for parse errors