Bug#175064: DocBook XML conversion is read with this script

[Russ Allbery <rra@debian.org>]

Guillem Jover <guillem@debian.org> writes:

> Ok, here's the updated patch series for the conversion omitting the
> actual conversion commit. Attached and in the pu/markup-singularity
> branch at <https://git.hadrons.org/cgit/debian/policy.git/>.

This has now been applied including the conversion generated by the
script.  Thank you both for all your work on this!  This is a huge
milestone.

I have also gone through and reformatted and rewrapped the resulting
DocBook source to make it a bit more human-maintainable.  Not saying that
it's the best possible format (unfortunately, DocBook has fairly long tag
names), but it's a bit better than no indentation whatsoever, and is at
least relatively consistent.  And it's the formatting that I like and I'm
doing most of the patch merging right now, so....  :P

There's almost certainly going to be a bunch of remaining minor issues and
formatting bugs introduced by this conversion.  One thing I noticed
already is that the heavy use of footnotes gets more awkward for most of
the output formats, and I think I may go looking for a better way of
representing some of that data and moving it out of footnotes.  But we can
start tweaking things more easily now, and investigate better markup
language usage using the broader power of DocBook.

The next step is an upload.  More on that in another message.

-- 
Russ Allbery (rra@debian.org)               <http://www.eyrie.org/~eagle/>