Skip to content

GitLab

GIMP
GIMP
Commit 1ed8f63c authored by Alexandre Prokoudine's avatar Alexandre Prokoudine
Browse files
Options

Sync the release howto to the version from the 'gimp-2-8' branch

parent 35556c91
Hide whitespace changes
Inline Side-by-side
Showing with 86 additions and 47 deletions
devel-docs/release-howto.txt
View file @ 1ed8f63c
...@@ -3,17 +3,34 @@ ...@@ -3,17 +3,34 @@
---------------------------- ----------------------------
a check-list for doing a GIMP release a check-list for doing a GIMP release
( ) Announce a string freeze on the GIMP Developer mailing list.
Mention that a release is planned, what brach will be frozen, and
how long the string freeze is going to last. Plan for a couple of
weeks at least. No translatable strings must be touched during
this time. An example announcement message is:
https://mail.gnome.org/archives/gimp-developer-list/2016-October/msg00004.html
( ) Check that you have working ssh access to download.gimp.org and ( ) Announce the planned release on the GNOME I18N mailing list.
that you are a member of the gimpadmins group.
Let them know about the planned release, what branch it's based
on, and how many changes to expect. An example message is:
https://mail.gnome.org/archives/gnome-i18n/2016-October/msg00035.html
( ) Wait until the date specified in the announcements, use this time
to get bug fixes applied which don't modify strings.
( ) Check that you have working ssh access to pentagon.gnome.org and
that you are a member of the gimpadmins group. If not, ask
Michael Natterer or Michael Schumacher for assistance.
( ) Check that download.gimp.org has enough space to upload the ( ) Check that download.gimp.org has enough space to upload the
release and to place it into the FTP area. If not, make place or release and to place it into the download area. If not, make
have somebody do that. place or ask Michael Natterer or Michael Schumacher to do that.
( ) Check that you have admin access to the GIMP product on ( ) 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 bugzilla.gimp.org and commit access to the gimp-web module, or
someone can do the changes for you. that someone can do the changes for you.
( ) Check if NEWS, authors.xml (and the generated AUTHORS), README or ( ) Check if NEWS, authors.xml (and the generated AUTHORS), README or
INSTALL need to be updated, as well as any release notes on INSTALL need to be updated, as well as any release notes on
...@@ -25,16 +42,19 @@ ...@@ -25,16 +42,19 @@
( ) Bump the version number to an even micro in configure.ac and ( ) Bump the version number to an even micro in configure.ac and
commit this change. It should be the version number of the commit this change. It should be the version number of the
release you are about to make. Releases always have even micro release you are about to make. Releases always have even micro
numbers. Don't forget to also bump the interface age for stable numbers.
releases. For devel releases, read libtool-instructions.txt.
[ ] In configure.ac, modify gimp_micro_version accordingly.
[ ] In configure.ac, modify gimp_interface_age accordingly.
( ) Make dist tarballs: ( ) Make dist tarballs:
[ ] Start with a checkout of the GIMP tree. Make sure the checkout [ ] Start with a checkout of the GIMP tree. Make sure the
is up to date, clean from uncommitted changes. checkout is up to date, clean from uncommitted changes.
[ ] Run 'git clean -x -d -f' (Warning: you will lose any files that [ ] Run 'git clean -x -d -f' (Warning: you will lose any files
are not added). that are not added).
[ ] Run 'git diff'. This should not generate any output, or your [ ] Run 'git diff'. This should not generate any output, or your
tree has local modifications. tree has local modifications.
...@@ -47,57 +67,76 @@ ...@@ -47,57 +67,76 @@
cause mysterious fails. cause mysterious fails.
[ ] If changes to generated files are made by the above command [ ] If changes to generated files are made by the above command
(run 'git diff' to find out), commit+push them and repeat from (run 'git diff' to find out), commit+push them and repeat
the beginning of this sub-section. from the beginning of this sub-section.
[ ] If there are problems reported by 'make distcheck', fix [ ] If there are problems reported by 'make distcheck', fix
them. If you made changes in the tree to get 'make distcheck' them. If you made changes in the tree to get 'make distcheck'
running, commit+push them and repeat from the beginning of this running, commit+push them and repeat from the beginning of
sub-section. this sub-section.
[ ] If 'make distcheck' passed and created tarballs, go to the next [ ] If 'make distcheck' passed and created tarballs, go to the
item. next item.
[ ] A successful run of the 'make distcheck' would create the final ( ) A successful run of the 'make distcheck' would create the final
dist tarballs. It will include a ChangeLog generated from the 'git dist tarballs. It will include a ChangeLog generated from the
log'. Note that we don't bother with any release commit, that's 'git log'. Note that we don't bother with any release commit,
what tags are for (see below). that's what tags are for (see below).
( ) Use md5sum to create a checksum of the tarball (tar.bz2). ( ) Tag the release (don't forget to push the tag)
git tag -s GIMP_2_x_y
git push origin GIMP_2_x_y
( ) Upload the tarball (tar.bz2) and the .md5 file to your home directory ( ) Bump the version number (past the tagged version) in configure.ac
on download.gimp.org. Keep a copy of the .md5 file around. to the next odd micro and commit this change. GIT versions always
have odd micro numbers.
( ) Tag the release (don't forget to push the tag) ( ) Publish dist tarballs:
git tag -s GIMP_2_x_y
git push origin GIMP_2_x_y
( ) Copy the tarball and the .md5 file to its final destination in [ ] Use md5sum to create a checksum of the tarball (tar.bz2).
the FTP area (/srv/ftp/pub/gimp/v2.x). Really use cp not mv
because a moved file from the home directory will need extra
selinux magic to make it readable by the web server.
( ) Update the 0.0_LATEST-IS- file in the directory on the FTP server. [ ] Upload the tarball (tar.bz2) and the .md5 file to your home
directory on pentagon.gnome.org. Keep a copy of the .md5
file around.
( ) Change permissions of the new files to make them writable by the [ ] Copy the tarball and the .md5 file to its final destination
'gimpadmins' group. This will allow other members of this group in the download area (/srv/ftp/pub/gimp/v2.x).
to correct mistakes and to update the 0.0_LATEST-IS- file next
time. [ ] Update the 0.0_LATEST-IS- file in the corresponding directory
on the download server.
[ ] Change permissions of the new files to make them writable by
the 'gimpadmins' 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. ( ) Add the new version to the GIMP product on bugzilla.gimp.org.
( ) Check out or update the 'gimp-web' module and change ( ) Check out or update the 'gimp-web' module, check out its testing
downloads/index.htrw. Commit this change, the web server should branch.
then update itself soon (usually less than an hour).
( ) Bump the version number (past the tagged version) in configure.ac [ ] Change the file content/downloads/index.md to reference the
to the next odd micro and commit this change. GIT version always new source release.
have odd micro numbers. Don't forget to also bump the interface
age for stable releases. For devel releases, read [ ] Create a news items for the release in content/news/
libtool-instructions.txt.
[ ] Commit and push the changes, the web server should then
update itself soon (every 5 minutes). Go to
https://testing.gimp.org to verify the changes.
( ) Grab a properly chilled beverage and enjoy yourself. ( ) Grab a properly chilled beverage and enjoy yourself.
( ) Give the mirrors a reasonably long time to update, then announce ( ) Give the mirrors a reasonably long time to update, then announce
the release on gimp.org and on the gimp-user and gimp-developer the release on gimp.org and send a release announcement to the
mailing lists. gimp-user and gimp-developer mailing lists.
[ ] Check out the gimp-web master branch and merge or cherry-pick
the changes you did in the testing branch.
[ ] Push the changes, the web server should then update itself
soon (every 15 minutes). Got to https://www.gimp.org to
verify the changes.
[ ] Due to the tendency of news sites to front-run release
articles even before actual announcements appear, publish
everything as fast as possible.
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment