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

RFC: New Upload Procedure



Hi folks!

We've developed a new upload procedure on debian-policy in the last weeks.
(The major change is that bug reports will be closed by Guy's dinstall
script on master, after the package has actually been installed in the
archive.)

Here is the current proposal. If noone objects I'll report this as a
`wish-list' bug report against ftp.debian.org and dpkg to get it
implemented.

Any comments are welcome! (But please consider that this topic has been
discussed in detail already.)


Thanks,

Chris

----------------------------------------------------------------------------

Procedure for package uploads
-----------------------------

 Maintainer's part:

  1.) [Only for new packages:] discuss the package on debian-devel

  2.) Upload package to master, chiark, erlangen, whatever

 dinstall's part:

  3.) [check for new packages every ten minutes]
      Check if package upload was complete and files are correct
      (i.e. check PGP signature, MD5 sums, correct .changes file, etc.)
      If there is an error send mail to maintainer and stop

  4.) Send announcement to debian-changes or debian-devel-changes

  5.) [once a day]
      Install packages into the archive
      (In case of a new package or a stable upload, this requires the
      acknowledgement of the archive maintainer)

  6.) [For source uploads only]
      Close bug reports that are fixed with this package upload
      (see below for details).
     

Details about how bug reports are closed
----------------------------------------

If a package upload fixes some bugs, the maintainer should include
markers in the debian/changelog file that use the following syntax
(Perl regexp syntax, case-sensitive):

      /closes:Bug\#\d+\(,Bug\#\d+\)*/

Here is an example for those that do not speak Perl:

  foo (1.0-5) unstable; urgency=low

    * Recompiled with libc6, closes:Bug#98765,Bug#98766
    * Removed `rm -rf /' from postrm script, closes:Bug#99999

   -- Wile E. Coyote <coyote@debian.org>  Wed, 29 Oct 1997 14:22:37 -0600

The new updated parsechangelog/debian script will check for these
markers and insert a new field into the .changes file (this has not
been implemented, yet!):

  Format: 1.5
  Date: Wed, 29 Oct 1997 14:22:37 -0600
  Source: foo
  Binary: foo
  Architecture: source all
  Version: 1.0-5
  Distribution: unstable
  Urgency: low
  Maintainer: Wile E. Coyote <coyote@debian.org>
  Closed: 98765 98766 99999
  Description: 
   foo        - Foos and Bars
  Changes: 
   foo (1.0-1) unstable; urgency=low
   .
     * Recompiled with libc6, closes:Bug#98765,Bug#98766
     * Removed `rm -rf /' from postrm script, closes:Bug#99999
  Files: 
   66909c6d1adc62c961f0618bb58fd2b5 194 doc extra foo_1.0-5.dsc
   c4b3cabd889396dcf5251e0ea529bea7 983 doc extra foo_1.0-5.tar.gz
   6d653b5f4dffd6e45109380e86dfe4e6 1038 doc extra foo_1.0-5_all.deb

When dinstall discovers a source upload which contains the `Closed:'
field it closes the listed bug reports by sending messages to the bug
tracking system of the following form: (Note, that the exact form of
the message from dinstall is quite important.  It must appear to come
from the developer submitting the package, so that the bug system
sends its notifications &c to the right place, and it must make sense
to the user.)

  From: <maintainer from changes file>
  To: <nnn>-submitter@bugs
  Bcc: <maintainer from changes file>, <nnn>-close@bugs
  Subject: Bug#<nnn>: fixed in <package> <version>

  We believe that the bug you reported is fixed in the latest version
  of <package> (<version>), which has been installed in the
  Debian FTP archive as:
    <path/to/binary/package>
    <path/to/source/package>
#if NOT_INSTALLED_INTO_STABLE
  NB that this package is not part of the released stable Debian
  distribution; it may have dependencies on other unreleased software,
  or other instabilities.  Please take care if you wish to install it.
  The bugfix will eventually make its way into the next released
  Debian distribution.
#endif

  A summary of the changes between this version and the previous one
  is attached.

  Thank you for reporting the bug, which will now be closed.  If you
  have further comments please address them to <nnn>@bugs, and the
  maintainer will if appropriate reopen the bug report while your
  concerns are addressed.

  Debian distribution maintenance software
  pp.
  <maintainer from changes file> (supplier of updated <package>)

  (This message was generated automatically at their request; if you
  believe that there is a problem with it please contact the archive
  administrators by mailing <contact address>.)

  <.changes entry>

----end-of-email----


Problems that are not covered by this solution
----------------------------------------------

With the current proposal, bug reports are only closed for source uploads.
(That's important since we don't want our bugs being closed several
times, once for each architecture :-)

However, some bug reports may be architecture specific. In these cases,
the bug reports have to be closed by the maintainer "by hand".

--                 Christian Schwarz
Do you know         schwarz@monet.m.isar.de, schwarz@schwarz-online.com,
Debian GNU/Linux?    schwarz@debian.org, schwarz@mathematik.tu-muenchen.de
      
Visit                  PGP-fp: 8F 61 EB 6D CF 23 CA D7  34 05 14 5C C8 DC 22 BA
http://www.debian.org   http://fatman.mathematik.tu-muenchen.de/~schwarz/



--
TO UNSUBSCRIBE FROM THIS MAILING LIST: e-mail the word "unsubscribe" to
debian-devel-request@lists.debian.org . 
Trouble?  e-mail to templin@bucknell.edu .


Reply to: