[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#661417: Policy document cleanups



Package: debian-policy
Severity: wishlist

This is a tracking bug that will block on non-normative Policy cleanup
issues.  Tasks that don't warrant separate discussion will be collected
in this bug.  Tasks that warrant further discussion will be filed as
separate bugs and marked as blocking this bug.

These cleanups should be done in conjunction with a major Policy layout
overhaul, since they may break external links, require changes for
www.debian.org deployment, and the like, and should be batched and done
together as much as possible.

Changes with separate bugs:

* Update copyright and license statements.  (#47438)
* Use RFC 2119 language.  (#647570)
* Convert to DocBook XML and support UTF-8.  (#175064)
* Remove old packaging manual appendices.  (#598645)

Changes that can be done separately but would benefit from other
overhauls.

* Upgrading checklist links (#639663).  Would benefit from being an
  appendix of Policy rather than a separate document.

Other changes that don't have separate bugs (at least currently):

* Alphabetize control field sections again.
* Remove stub sections (examples: 5.6.10, 10.3).
* Section 3 (Binary packages) is a grab bag overlapping other sections.
* Break the Policy source into separate files for easier maintenance.
* Incorporate the virtual package list into Policy for prettier formatting.

-- System Information:
Debian Release: wheezy/sid
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable'), (1, 'experimental')
Architecture: i386 (i686)

Kernel: Linux 3.1.0-1-686-pae (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash



Reply to: