Bug#609160: debian-policy: include DEP5
Charles Plessy <plessy@debian.org> writes:
> Pong :)
> Here is DEP-5 in DocBook format, and the changes needed to the
> debian-policy package to build it in HTML and text formats. I have
> followed the same way as the Debconf spec. In the long term, there is
> probably a smarter way to do, but for the moment, it will allow people
> to inspect the converted version of the DEP.
> DocBook does not allow simple paragraphs to follow a section. Therefore,
> I had to move a couple of things (see below). Also, the current style
> uses a lot of bullet points, which nead heavy XML tagging, and do not
> match the style of the Policy in general. I changed this to a more
> paragraph-oriented style, but I can easily revert it.
> There are two issues that I did not have time to investigate. The first
> is that the HTML file does not declare that it is encoded in UTF-8, and
> the second is that the sections are not numbered.
Okay, I've installed this in the Policy Git repository, because I think
it's a good basis for additional work and I don't see a good reason to
wait. However, I think it could definitely use additional proofreading,
and I'd really like Lars to review the results as well.
My inclination is to include it in the next debian-policy package upload,
but (since that's happening tomorrow, not giving people much time), remove
the reference to it in Policy proper for right now and not make a big deal
out of the fact that it's there. That includes not putting it up on the
web site yet. Then, we'll use the next bit for further review and any
fixes to formatting, wording, markup, and so forth, and we'll add in the
formal linkage and the rest for 3.9.3 (which I intend to not take nearly
as long as 3.9.2 did, and I see Bill is of the same opinion).
Does this sound reasonable to everyone?
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: