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

Bug#489460: remove alternative changelog formats from main Policy manual



Package: debian-policy
Version: 3.8.0.1
Severity: wishlist

Currently, Policy contains section 4.4.1, which documents the possible
use of alternative changelog formats.  I don't think this section is
useful or relevant; I think the chances of changing the changelog format
for the archive are essentially non-existent, and therefore documentation
of this dpkg feature doesn't properly belong in Policy.

I propose removing it.

I also propose changing the "should"s in the following sentences in
Policy 4.4 to "must":

    The date should be in RFC822 format[17]; it should include the time
    zone specified numerically, with the time zone name or abbreviation
    optionally present as a comment in parentheses.

    The first "title" line with the package name should start at the left
    hand margin; the "trailer" line with the maintainer and date details
    should be preceded by exactly one space. The maintainer details and the
    date must be separated by exactly two spaces.

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

Kernel: Linux 2.6.24-1-686 (SMP w/1 CPU core)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

-- no debconf information



Reply to: