Changelog
debian-policy (4.0.0.4) unstable; urgency=medium
* Fix URLs to Policy documents. Policy previously used the full URL as
the link but a partial URL as anchor text, and then sometimes added
the full URL in parentheses. The result was very ugly in the text
version. Replace that style with just the full URL as anchor text for
a link to that URL, which is not ideal for HTML output but produces
reasonable results for both HTML and text.
* Extensive reformatting of the maintainer script section.
- Use <cmdsynopsis> in the summary of how maintainer scripts are
called, with a single <term>. This avoids gluing all the command
summaries together with commas. The output in text is radically
better; HTML has some font issues, but isn't awful.
- Avoid trailing newlines in <screen> examples, which produce extra
whitespace in text and HTML output.
- Use different numeration methods at different levels of the nested
ordered lists and ensure there is some introductory text for each
list element to avoid awkward formatting.
* Convert many of the <screen> tags in Policy to </programlisting> since
the semantics are slightly more correct.
* Remove the newline before </screen> or </programlisting> end tags,
since it produces an extraneous and distracting blank line in both
text and HTML output.
* Change the mapping of Perl module names to Debian package names in
the Perl Policy from a verbatim block to a table.
* Change the list of cron directories from a verbatim block to a list.
-- Russ Allbery <email address hidden> Sun, 25 Jun 2017 20:34:27 -0700
