release-howto.txt 2.86 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12

                        How to do a GIMP release
                      ----------------------------
                  a check-list for doing a GIMP release


 ( ) Check that you have working ssh access to ftp.gimp.org and that you
     are a member of the ftp group.

 ( ) Check that ftp.gimp.org has enough space to upload the release and to
     place it into the FTP area. If not, make place or ask Yosh to do that.

13 14 15 16
 ( ) Check that you have admin access to the GIMP product on
     bugzilla.gimp.org and to the news section on www.gimp.org, or that
     someone can do the changes for you.

17 18
 ( ) Make sure the checkout is up to date, clean from uncommitted changes.

19
 ( ) Check that the version number is correct in configure.ac
20

21
 ( ) Run 'make maintainer-clean -k' or 'git clean -x -d -f'
22

23 24 25 26
 ( ) Run ./autogen.sh --enable-gtk-doc

 ( ) Do a complete build of the source tree.

27
 ( ) Check if NEWS, authors.xml, README or INSTALL need to be updated,
28 29 30
     as well as any release notes on gimp.org. Don't forget to add any
     "Index of new symbols in GIMP 2.x" to the gtk-doc generated
     devel-docs.
31 32 33

 ( ) Does the splash screen need to be changed?

34 35
 ( ) Run 'make distcheck'. Avoid passing make -j since that can cause
     mysterious fails
36 37 38 39 40

 ( ) If there are problems with 'make distcheck', fix them and try again.

 ( ) Commit changes that you had to do to get 'make distcheck' running.

41
 ( ) Run 'make dist' to create the final tarball. This will generate
42 43
     ChangeLog. Note that we don't bother with any release commit,
     that's what tags are for (see below).
44 45 46 47 48 49

 ( ) Use md5sum to create a checksum of the tarball (tar.bz2).

 ( ) Upload the tarball (tar.bz2) and the .md5 file to your home directory
     on ftp.gimp.org.  Keep a copy of the .md5 file around.

50 51
 ( ) Commit the changes to generated files that were changed by
     running 'make dist'.
52

53 54
 ( ) Tag the release (don't forget to push the tag)
        git tag -s GIMP_2_x_y
55
        git push origin GIMP_2_x_y
56 57 58 59 60 61 62 63 64 65 66 67 68 69

 ( ) Move the tarball and the .md5 file to its final destination in the
     FTP area (/home/ftp/pub/gimp/v2.x).

 ( ) Update the 0.0_LATEST-IS- file in the directory on the FTP server.

 ( ) Change permissions of the new files to make them writable by the 'ftp'
     group. This will allow other members of this group to correct mistakes
     and to update the 0.0_LATEST-IS- file next time.

 ( ) Add the new version to the GIMP product on bugzilla.gimp.org.

 ( ) Check out or update the 'gimp-web' module and change
     downloads/index.htrw.  Commit this change, the web server should
70
     then update itself soon (usually less than an hour).
71

72
 ( ) Bump the version number in configure.ac and commit this change.
73 74

 ( ) Grab a properly chilled beverage and enjoy yourself.
75 76 77 78

 ( ) Give the mirrors a reasonably long time to update, then announce the
     release on gimp.org and on the GIMP mailing lists (don't forget
     gimp-announce).