Some cosmetic tweaks and special char escaping.

* bzrlib/tests/doc_generate/builders/test_texinfo.py:
(TestTextGeneration.test_special_chars): Test all the used special
chars.

* bzrlib/doc_generate/writers/texinfo.py:
(TexinfoTranslator.depart_Text): texinfo requires some special
chars to be protected.
(TexinfoTranslator.depart_table): Leave an empty line after a table.

* bzrlib/doc_generate/builders/texinfo.py:
(TexinfoBuilder.get_target_uri): We really want the finally
produced document.