b.t.per_bzrdir : package documentation

These test the conformance of all the bzrdir variations to the expected API.
Specific tests for individual formats are in the tests/test_bzrdir.py file
rather than in tests/per_branch/.py. Generic control directory tests not
specific to BzrDir are in tests/per_controldir/.py.