Difference between revisions of "What to do for a release"
m (→Gramps 4.2.x) |
m (→Changelog and NEWS file) |
||
Line 24: | Line 24: | ||
Create the changelog files: | Create the changelog files: | ||
git log gramps-{{version}}.. --pretty --numstat --summary --no-merges | git2cl > ChangeLog | git log gramps-{{version}}.. --pretty --numstat --summary --no-merges | git2cl > ChangeLog | ||
− | git log gramps-{{version}}.. --pretty --numstat --summary --no-merges -- | + | cd po |
+ | git log gramps-{{version}}.. --pretty --numstat --summary --no-merges -- *.po | git2cl > ChangeLog | ||
Using the <tt>Changelog</tt> files generated with <tt>git2cl</tt> in the step above, edit and update the <tt>NEWS</tt> file. | Using the <tt>Changelog</tt> files generated with <tt>git2cl</tt> in the step above, edit and update the <tt>NEWS</tt> file. |
Revision as of 16:44, 6 January 2016
What to do for a release
Contents
Updated guidelines for Git
Translation update
Run the following steps:
git checkout gramps52 git pull cd po
Gramps 4.x
For Gramps 4.x use (See New environment and differences between tools. See po/update_po.py to generate a new template/catalog (gramps.pot).)
python update_po.py -p git diff gramps.pot
If there have been changes, you'll need to commit gramps.pot and ask translators to update their .po files before you can make a release.
Gramps 3.4 and earlier
For Gramps 3.4 and earlier use:
./genpot.sh
Release name
Refer to (and update) the list of previous releases to select an appropriate name.
Changelog and NEWS file
Create the changelog files:
git log gramps-5.2.1.. --pretty --numstat --summary --no-merges | git2cl > ChangeLog cd po git log gramps-5.2.1.. --pretty --numstat --summary --no-merges -- *.po | git2cl > ChangeLog
Using the Changelog files generated with git2cl in the step above, edit and update the NEWS file. Commit the NEWS file:
git commit -am "update for 5.2.1 release"
Working on VERSION
Gramps 4.2.x
- 4.2.x
Check gramps/version.py to indicate an official release:
gedit gramps/version.py
and if need, update the version for the release:
VERSION_TUPLE = (4, 2, 0)
Modify gramps/gen/const.py to indicate an official release:
- VERSION += git_revision + #VERSION += git_revision
Save change:
git add . git commit -am "make official release"
The version number should be the same on "about" dialog:
python Gramps.py
or
python Gramps.py -v
Gramps 3.4.x
- 3.4.x
Modify configure.in to indicate an official release:
gedit configure.in
There are two changes to make:
- 1) Change the following line:
-RELEASE=0.SVN$(git log -1 --format=%h .) +dnl RELEASE=0.SVN$(git log -1 --format=%h .)
- 2) And change this line:
-dnl RELEASE=1 +RELEASE=1
Save these two changes.
git commit -am "make official release" configure.in
Now run the following and check the version number in the "about" dialog:
./autogen.sh python src/gramps.py
Create a tag
Create the release tag:
git tag -am "tag 5.2.1" v5.2.1
Tags should be prefixed with the letter v.
Push to repository
Push the changes to the repository:
git push origin v5.2.1
Work on tag
Move to the new release number on branch
Gramps 4.2.x
- 4.0.x
Bump the version number in gramps/version.py
Update the version for the release:
VERSION_TUPLE = (4, 0, ...)
Revert change on gramps/gen/const.py to indicate git revision:
- #VERSION += get_git_revision(ROOT_DIR) + VERSION += get_git_revision(ROOT_DIR)
Save change:
git commit -am "bump to <new version number>" git push
Gramps 3.4.x
- 3.4.x
Bump the version number in configure.in and src/const.py.in
Save change:
git commit -am "bump to <new version number>" git push
Release from tag
git checkout <tag> -b <new_branch_name>
Gramps 4.2.x
- Gramps-4.0.x
Modify MANIFEST.in
+ include ChangeLog + include po/ChangeLog
Create the official source tarball:
python setup.py sdist
Gramps 3.4.x
- Gramps-3.4
Build, check and create the official source tarball:
./autogen.sh make distcheck
Making the source tarball available
- access the "Sourceforge Project Admin->File Manager" page at https://sourceforge.net/projects/gramps/
or via your <dev> account:
$ sftp <dev>@frs.sourceforge.net Connecting to frs.sourceforge.net... Password: sftp> cd /home/frs/project/gramps
- create a new folder in the "Stable" hierarchy
- upload the gramps-5.2.1.tar.gz file to the new folder
Announcing the new release
- announce on [email protected], [email protected] and [email protected]
- announce on Gramps blog
- update News section on this wiki
- update the list of previous releases
- update reference to the new version on the wiki template
- update HeadlineNews
- change the topic on the IRC channel #gramps
/TOPIC #gramps Welcome to Gramps! The latest versions are 4.2.1 and the legacy 3.4.9 || http://www.gramps-project.org/ || Please state OS and Gramps version when asking a question. Understand that replies can take up to 2 days depending on whose watching the channel. Please consider asking on the gramps-users mailing list.
- update the version number at Wikipedia
- update mantisdb(Bug/issue database) and enable the new version for reporting issues.
Post-release
- merge forward the NEWS file