makefile: use Python 3 by default when building docs as well
I copied the snippet defining `PYTHON` from the root Makefile.
Differential Revision: https://phab.mercurial-scm.org/D10251
To run the tests, do:cd tests/python run-tests.pySee https://mercurial-scm.org/wiki/WritingTests formore information on writing tests.