tests: update test to match upstreamable version
Name have been clarified, documentation has been updated and some test-case have
been updated to match the intended test.
doc generated with sphinx. tutorial exported using sphinxedhghttp://hg.piranha.org.ua/sphinxedhg/