doc/ReleaseChecklist.txt

   1 Barry Release Checklist:
   2 ------------------------
   3 - bump version numbers in
   4         Note: make sure you check all control files below for both current
   5         versions (i.e. libbarry0 (>= 0.18)) and the next version
   6         (i.e. libbarry0 (<< 0.19)) since the binary packages should prevent
   7         interaction with incompatible libraries this way.
   8                 - configure.ac
   9                 - gui/configure.ac
  10                 - gui/src/BackupWindow.cc (about dialog)
  11                 - desktop/src/Makefile.am (oswrapper lib version & include dir)
  12                 - Doxyfile
  13                 - rpm/barry.spec
  14                 - debian/changelog
  15                 - debian/control (libbarry's name includes version number)
  16                 - debian/libbarry*.* (files need to be renamed)
  17                 - debian/rules (the barry18 includedir)
  18                 - opensync-plugin/configure.ac
  19                 - opensync-plugin/src/barry_sync.cc
  20                 - opensync-plugin-0.4x/configure.ac
  21                 - opensync-plugin-0.4x/src/barry_sync.cc
  22                 - opensync-plugin/debian/control (libbarry-dev)
  23                 - opensync-plugin/debian/changelog (libbarry-dev)
  24                 - opensync-plugin-0.4x/debian/control (libbarry-dev)
  25                 - opensync-plugin-0.4x/debian/changelog (libbarry-dev)
  26                 - files under po/
  27                 - desktop/src/barrydesktop.cc
  28 - test ABI / API and bump major or minor version as appropriate
  29 - run all tests on a clean git tree, including build test script
  30 - write release notes, including contributors, known issues, new
  31         features and bugs fixed
  32         - include mention of distros that support Barry:
  33                 (see AUTHORS file for distro list)
  34         - include description at the top of what Barry is
  35 - web docs:
  36         - bump version number and release date on index.php
  37         - update known issues list
  38         - check that all external links work, and point to proper content
  39         - upload latest web docs to netdirect project page
  40                 - run: ./static.sh netdirect
  41         - upload latest doxygen docs to netdirect project page
  42 - update root README file
  43 - snip this version's changelog history into its own file
  44 - tag CVS repo and sign-tag git repo with latest version
  45 - run maintainer/tagged-release.sh
  46 - manually push git tags to repo.or.cz and sourceforge.net
  47 - upload packages to SourceForge
  48         ssh -x -a -2 -t USER,PROJECT@shell.sourceforge.net create
  49            then use sf-help for details
  50         MAKE SURE that the tar source files are under
  51                 /files/barry/barry-{version}/barry_{version}.tar.gz,
  52                 so that debian/watch remains accurate
  53         - Ubuntu: 7.10, 8.04, 9.04
  54         - Fedora: 7, 8, 9, 11
  55         - Debian: stable (lenny)
  56         - openSUSE: ?
  57 - submit tracker news item at SourceForge
  58 - send announcement to devel and announce mailing list, including:
  59         - release notes
  60         - changelog
  61         - URLs to sourceforge and OpenSUSE Build Service binary packages
  62         - URL to netdirect doc page
  63 - update Freshmeat entry
  64 - update Sourceforge screenshots / icons if applicable
  65 - send identi.ca/cdfrey and blog notices
  66 - update source project, bumping revision numbers in source code
  67
  68
  69 A note on the tags in Barry's git repository:
  70 ---------------------------------------------
  71 Each release will now have at least 3 tags.  For example, if releasing
  72 version 0.14, the tags will be:
  73
  74         barry-0.14              Tag on master branch, signifying the
  75                                 development point that the release occured
  76         barry-0.14.tar.bz2      Contains the exact contents of the
  77                                 full tar.bz2 release tarball.  If you
  78                                 look far enough in the history logs, you will
  79                                 find the barry-0.14 tag.
  80         barry_0.14.orig.tar.gz  Contains the exact contents of the debian
  81                                 source package tarball.  Again, barry-0.14
  82                                 will be in this tag's history.
  83
  84 Basically, the first tag contains only the source code, and no generated
  85 files.  The second tag (tar.bz2) contains the source code and all
  86 generated files.  And the third tag (orig) contains all of tar.bz2
  87 *except* the debian/ directory.  They are arranged so all history
  88 merges back into the main non-generated source development tree.
  89