16,602
edits
Changes
m
cd gramps30git checkout gramps{{Stable_branch}} svn updategit pull
make ===Gramps 4.x===For Gramps 4.x use (See [[Translation_environment4|New environment]] and [[Talk:Translation_environment4|differences between tools]]. See [https://github.com/gramps-project/gramps/blob/master/po/update_po.py po/update_po.py] to generate a new template/catalog (gramps.pot).) python update_po.py -p svn git diff gramps.pot
svn2cl git log gramps-{{version}}.. --pretty -reparagraph -numstat -include-rev summary --authors=src/data/authors.xmlno-merges | git2cl > ChangeLog cd po svn2cl git log gramps-{{version}}.. --pretty --numstat --reparagraph summary --includeno-rev merges --authorspo/*.po | git2cl > po/ChangeLog Using the <tt>Changelog</tt> files generated with <tt>git2cl</tt> in the step above, edit and update the <tt>NEWS</tt> file.Commit the NEWS file: git commit -am "update for {{version}} release" ==Working on VERSION== ===Gramps 4.2.x===* 4.2.x Check <tt>[https://github.com/gramps-project/srcgramps/datablob/authorsmaster/gramps/version.py gramps/version.xmlpy]</tt> to indicate an official release: cd gedit gramps/version.py and if need, update the version for the release: VERSION_TUPLE = (4, 2, 0) Modify <tt>[https://github.com/gramps-project/gramps/blob/master/gramps/gen/const.py#L132 gramps/gen/const.py]</tt> to indicate an official release: - VERSION += git_revision + #VERSION += git_revision
Using the <tt>Changelog</tt> files generated with <tt>svn2cl</tt> in the step above, edit and update the <tt>NEWS</tt> file.Save change:Commit the NEWS file git add . Note the svn commit revision number, which you'll need in the next step when you create the subversion tag: svn git commit -m am "update for 3.0.3 make official release" Committed revision 11159.
==Subversion tag==Create a tag for The version number should be the releasesame on "about" dialog: svn copy -r 11159 https://grampspython Gramps.svn.sourceforge.net/svnroot/gramps/branches/gramps30 https://gramps.svn.sourceforge.net/svnroot/gramps/tags/gramps-3.0pyor python Gramps.3 py -m "tag 3.0.3"v
svn git commit -m am "make official release" configure.in
make
Note you should now have the file <tt>gramps-3.0.3.tar.gz</tt>, approximately 5.5 MB in size.
Run * access the following steps"Sourceforge Project Admin->File Manager" page at https://sourceforge.net/projects/gramps/or via your ''<dev>'' account: $ sftp s_charette<dev>@frs.sourceforge.net cd uploads put gramps-3Connecting to frs.sourceforge.0net.3.tar.gz* access the Sourceforge <tt Password: sftp>admin</tt> tab at http:cd /home/sourceforge.netfrs/projectsproject/gramps/* go to <tt>File Releases</tt>* add create a new release folder in the <tt>"Stable</tt> package" hierarchy* fill in name, e.g., upload the <tt>3gramps-{{version}}.0tar.3</tt>* enter release notes (usually this is the text from <tt>NEWSgz</tt>)* add uploaded file(s) to the release by checking the appropriate check button and then clicking the "<tt>Add Files and/or Refresh View</tt>" button* set architecture and file type, click "<tt>Update/Refresh</tt>" new folder
==See also==* [[Git|Brief introduction to SVNGit]]
==External links==* httphttps://grampsgithub.svn.sourceforge.net/viewvccom/gramps/-project
→Gramps 4.2.x
'''What to do for a release''' These notes are based on version 3.0.3, released in October 2008. The steps assume a working <tt>gramps30</tt> source directory. See [[Running a development version of Gramps]] if this is not the case.=Updated guidelines for Git =
==Translation update==
Run the following steps:
cd po
If there have been changes, you'll need to commit <tt>gramps.pot</tt> and ask translators to update their <tt>.po</tt> 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 [[Previous releasesof Gramps|list of previous releases]] to select an appropriate name.
==Changelog and NEWS file==
Create the changelog files:
==Working on the tag==Check out the new tag: cd .. svn co https://gramps.svn.sourceforge.net/svnroot/gramps/tags/gramps-Gramps 3.04.3x=== cd gramps-* 3.04.3x
Modify <tt>configure.in</tt> to indicate an official release:
There are two changes to make:
:1) Change the following line:
-RELEASE=0.SVN$(svnversion git log -n 1 --format=%h .) +dnl RELEASE=0.SVN$(svnversion git log -1 -n -format=%h .)
:2) And change this line:
-dnl RELEASE=1
+RELEASE=1
Save these two changes.
Now run the following and check the version number in the "about" dialog:
./autogen.sh
python src/gramps.py
==Changelog and source tarballCreate a tag==ReCreate the release tag: git tag -create (or copy from above) am "tag {{version}}" v{{version}} Tags should be prefixed with the letter v. ==Push to repository==Push the changes to the repository: git push origin v{{version}} ==Work on tag == ===Move to the new release number on branch =======Gramps 4.2 Changelog files. The Changelog files are required x====* 4.0.x Bump the version number in <tt>gramps/version.py</tt> Update the version for the source tarballrelease: VERSION_TUPLE = (4, but do not commit 0, ...) Revert change on <tt>gramps/gen/const.py</tt> to subversionindicate git revision: svn2cl --reparagraph --include-rev --authors#VERSION +=src/data/authors.xmlget_git_revision(ROOT_DIR) cd po+ VERSION += get_git_revision(ROOT_DIR) Save change: svn2cl git commit --reparagraph --include-rev --authorsam "bump to <new version number>" git push ====Gramps 3.4.x====* 3.4.x Bump the version number in <tt>configure.in</tt> and <tt>src/dataconst.py.in</authorstt> 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.xmlx==== cd * Gramps-4.0.x Modify <tt>MANIFEST.in</tt> + 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==
==Announcing the new release==
* announce on Gramps blog
* update [[News]] section on this wiki
* update the list of [[Previous releases of Gramps|previous releases]]* update reference to the new version on the [[installationTemplate:Version|installation pagewiki template]]* update [[HeadlineNews]]
* change the topic on the IRC channel #gramps
<code> /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. </code>* update the version number at [http://en.wikipedia.org/wiki/GRAMPS Gramps Wikipedia]* update mantisdb(Bug/issue database) and enable the new version for reporting issues.
==Post-release==
* in <tt>gramps30</tt>, bump the version number in <tt>configure.in</tt>* in <tt>trunk</tt>, merge forward the <tt>NEWS</tt> file
* [[Running a development version of Gramps]]
* [[:Category:Developers/Packaging]]
* http://gramps-project.org/cpanel
* http://svn.code.sf.net/p/gramps/code/
* http://sourceforge.net/projects/gramps/
[[Category:Developers/General]]
