docs/README.stable-point-release

   1 Rough Guide to doing Stable Point Releases in Debian
   2 ----------------------------------------------------
   3
   4 o Dump projectb for backup purposes.
   5 o get everything listed, dak control-suite -l proposed-updates > p-u.list
   6 o generate the changelog using dak make-changelog
   7 o add everything to stable:  cat p-u.list |dak control-suite --add stable
   8 o remove everything from proposed-updates, dak control-suite -r proposed-updates < p-u.list
   9 o sync with stable RM if there is any propup needed. do it, if so.
  10 o ask rms if they have RMs to do.
  11 o If you installed a debian-installer upload; migrate the relevant
  12   installer-*/$release directory from proposed-updates to stable.
  13   (Including potentially removing older versions)
  14 o Update version number in README, README.html and dists/README
  15 o Update the 'Debian<n>.<n>r<n>' symlink in dists/
  16 o Clean up dists/stable/ChangeLog (add header, basically)
  17 o Update fields in suite table in postgresql (see below)
  18
  19 o Run 'dak dominate --force -s stable'
  20 o Run 'dak generate-filelist -s stable'
  21 o Run apt-ftparchive generate apt.conf.stable
  22 o Run 'dak generate-releases --force-touch --apt-conf apt.conf.stable stable'
  23
  24
  25
  26
  27 begin;
  28 update suite set version = '5.0.6' where suite_name = 'stable';
  29 update suite set description = 'Debian 5.0.6 Released 04 September 2010' where suite_name = 'stable';
  30
  31 ------------------------------------------------------------------------
  32 Old doc:
  33
  34
  35 o run 'dak clean-proposed-updates' to get rid of obsolete .changes
  36   from p-u ['dak clean-proposed-updates *.changes' from within p-u]
  37 o [also check for obsolete .changes caused by 'dak rm'-ing from p-u]
  38 o Update dak.conf (at least the section for Reject-Proposed-Updates,
  39   before using 'dak reject-proposed-updates')
  40 o Install, reject and remove packages as directed by the SRM using
  41   'dak process-accepted' (installs), 'dak reject-proposed-updates'
  42   (rejects) and 'dak rm' (removals)
  43
  44   NB: removing packages are not logged to the stable ChangeLog; you
  45       need to do that byhand.
  46
  47
  48 o Decruft stable in coordination with SRMs
  49
  50 o Do anything in proposed-updates/TODO
  51 o Close any applicable stable bugs
  52   (hint: http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=ftp.debian.org&include=etch)
  53 o Update version number in README, README.html and dists/README
  54 o Update the 'Debian<n>.<n>r<n>' symlink in dists/
  55 o Clean up dists/stable/ChangeLog (add header, basically)
  56 o Update version fields in dak.conf
  57 o Update fields in suite table in postgresql (see below)
  58
  59 o Run 'dak make-suite-file-list --force -s stable'
  60 o Run apt-ftparchive generate apt.conf.stable
  61 o Run 'dak generate-releases --force-touch --apt-conf apt.conf.stable stable'
  62
  63 [Yes, this sucks and more of it should be automated. c.f. ~ajt/pointupdate]
  64
  65 #######################################################
  66
  67 update suite set version = '4.0r3' where suite_name = 'stable';
  68 update suite set description = 'Debian 4.0r3 Released 16th February 2008' where suite_name = 'stable';
  69
  70 Rough Guide to doing Old-Stable Point Releases in Debian
  71 --------------------------------------------------------
  72
  73 Pretty much as above, except that process-accepted doesn't know about
  74 oldstable, so you have to do some surgery on it first to make it
  75 support that.  Probably want to disable cron.daily whilst doing so.
  76 Also watch out for the installing_to_stable detection which doesn't
  77 work well with the current layout of oldstable-proposed-updates (as a
  78 symlink to $distro-proposed-updates).  clean-proposed-updates,
  79 cruft-report and most everything else support a -s/--suite so they
  80 sould be fine to use.