r11135 - /website/policy.pod

Tue Dec 11 22:04:26 UTC 2007

Author: bremner-guest
Date: Tue Dec 11 22:04:26 2007
New Revision: 11135

URL: http://svn.debian.org/wsvn/?sc=1&rev=11135
Log:
Some wording changes to description of debian/changelog handling 

Modified:
    website/policy.pod

Modified: website/policy.pod
URL: http://svn.debian.org/wsvn/website/policy.pod?rev=11135&op=diff
==============================================================================

--- website/policy.pod (original)
+++ website/policy.pod Tue Dec 11 22:04:26 2007
@@ -7,12 +7,13 @@
 Project Internal Policy
 
 This document describes how we do stuff internally. It is of course work in
-progress and will probably always be.
-
-We are using a subversion repository to keep the packages under revision
-control. It is recommended that you read the Debian Perl Group Subversion
-Guide (L<http://pkg-perl.alioth.debian.org/subversion.html>) to see how our
-repository should be used, it is out of scope of this document.
+progress and probably always will be.
+
+We are using a subversion repository to keep the packages under
+revision control. Details of working with this repository are out of
+scope of this document;  it is recommended that you read the Debian
+Perl Group Subversion Guide  
+(L<http://pkg-perl.alioth.debian.org/subversion.html>) for these.
 
 =head1 INDEX
 
@@ -53,16 +54,18 @@
 =head1 debian/changelog handling and versioning
 
 We use the debian revision to count our releases to the debian archive, not
-internal steps. So if and only if you do the first change after a release, 
-you add another debian/changelog entry (dch -i). Since your name and e-mail 
-will then be in there, you have to check that you are listed in Uploaders: 
-in debian/control (otherwise katie or whoever will think that you are doing 
-an NMU), if you actually plan to upload the package (i.e. if you are a DD or a DM
-allowed to upload the specific package).
+internal steps. So if and only if you do the first change after a release, you
+add another debian/changelog entry (dch -i).  Note that the name and email
+address in the debian/changelog entry (i.e. after --) must be present in in
+Uploaders: in debian/control (otherwise katie or whoever will think that you
+are doing an NMU).  Also note that in order to upload a package, you need to be
+either a DD (Debian Developer) or a DM (Debian Maintainer) with package
+specific approval by a DD; more details on this topic below.
 
 If you change something that has to be noted in debian/changelog, just add a
 line to the current entry (dch -a). The [firstname lastname] markers added by
-dch are okay to give credit to non-upload-permitted contributors.
+dch are okay to give credit to non-upload-permitted contributors (also for the
+initial changelog entry).
 
 Important NOTES to other group members may be placed at the top of the current
 changelog entry of packages that are not yet ready for upload (e.g. why a


