RELEASE.rst

   1 Release
   2 =======
   3
   4 For this team's purposes, the job is not done until the package gets into
   5 Debian Testing. This is a rigorous QA process the details of which can be read
   6 about elsewhere. The short version for us, is to run::
   7
   8   dev/rust-excuses.mk refresh all
   9
  10 which will generate a nice pretty graph of packages trying to enter Debian
  11 Testing, along with their dependencies, and sometimes a colour representing the
  12 reason why it's being held back. (The colours could be more sophisticated,
  13 please help with improving the script. White does not always mean there is no
  14 problem; the excuses page is the authoritative source on the matter.)
  15
  16 Generally, you should look at the bottom-most packages in this diagram, and
  17 deal with their issues first. More details for each package can be found at:
  18
  19   https://qa.debian.org/excuses.php?package=rust-$crate
  20
  21 or by clicking the relevant "Excuse" link on this team's `QA page`_.
  22
  23 .. _QA page: https://qa.debian.org/developer.php?login=pkg-rust-maintainers@lists.alioth.debian.org
  24
  25 It should be fairly self-explanatory on how to deal with each of the issues
  26 mentioned on that page. Ask in #debian-rust or #debian-release or #debian-devel
  27 if you get stuck, whichever channel seems most suitable.
  28
  29 Once you have dealt with all of the excuses, wait a day or so. If the excuses
  30 page then says "Will attempt migration (Any information below is purely
  31 informational)" and it remains in this state for more than 2 days, it means
  32 that we have failed "Migration phase 2", whose specific failure reasons are not
  33 mentioned in the excuses for `technical reasons`_.
  34
  35 .. _technical reasons: https://release.debian.org/doc/britney/short-intro-to-migrations.html#migration-phase-2-installability-regression-testing
  36
  37 However the reason is basically that there are other crates already in Debian
  38 Testing that depend on the old version of the $crate you were looking at, i.e.
  39 the one in Debian Testing not Debian Unstable. To view a summary of this, run::
  40
  41   dev/list-rdeps.sh $crate
  42
  43 It will also give you some follow-up instructions to fix the problem.
  44
  45
  46 Source-only re-upload
  47 =====================
  48
  49 Two aspects of Debian infrastructure policy, run by two different teams,
  50 interact badly when it comes to the Debian Rust Team:
  51
  52 1. Uploads with new binary packages have to be done as binary (not source-only)
  53    uploads, into the FTP team's NEW queue.
  54 2. Uploads that are valid candidates for Debian Testing have to be source-only
  55    uploads, to be considered by the Release team's migration script.
  56
  57 For your convenience, ``./release.sh`` can do these quickly. After a
  58 binary-upload is accepted from the NEW queue, and you merge the relevant
  59 pending branch, do a source-only re-upload by simply running::
  60
  61   RERELEASE=1 ./release.sh <rust-crate-name> [<old-version>]
  62
  63
  64 Remove an obsolete package
  65 ==========================
  66
  67 ::
  68
  69   $ reportbug ftp.debian.org
  70   [..]
  71   What sort of request is this?
  72   [..]
  73    6 ROM       Package removal - Request Of Maintainer.
  74   [..]
  75   Choose the request type: 6
  76   [..]
  77   Is the removal to be done in a suite other than "unstable"? Don't select anything for "unstable"
  78   [..]
  79   Choose the suite: # input nothing here, i.e. "unstable"
  80   Please enter the reason for removal: obsolete package, prevents others from migrating to testing
  81   Is this removal request for specific architectures? [y|N|?]? n
  82   [..]
  83   # An editor will spawn, probably nano. add
  84   #   X-Debbugs-Cc: pkg-rust-maintainers@alioth-lists.debian.net
  85   # to the header, and then add the following text to the body:
  86
  87   Hi, please remove this package on all architectures. It is an old rust library
  88   that is preventing newer ones from migrating to testing. Nothing else in the
  89   archive depends on it these days.
  90
  91   # then save and exit, and proceed with submitting the report.