View source for Calligra/Release Howto

This page contains notes on what needs to be done when releasing a new version of Calligra.

{{InProgress}}

__TOC__

= Tarball creation =

*Create tarball using release-calligra.rb
*Upload http://download.kde.org/stable/calligra-X.Y.Z/calligra-X.Y.Z.tar.xz, calligra-l10n/ and MD5SUMS*
*Remove previous files http://download.kde.org/stable/calligra-latest/calligra-*.tar.xz
*Upload http://download.kde.org/stable/calligra-latest/calligra-X.Y.Z.tar.xz, calligra-l10n/ and MD5SUMS*

= Branching =

== Code ==
 git checkout -b calligra/${VERSION}
 git push origin calligra/${VERSION}
(VERSION = 2.4, 2.5, etc.)

== Translation ==

As a general advice it's better to move messages when scripty is not running, so before 1 AM CE(S)T (or UTC, I don't remember now) or after ~8:30 AM (same timezone as starting time).

Prepare yourself for a lot of suffering:
* warn the i18n coordinator in advance
* copy translation to stable-kde4 (use the calligra-release.rb scripts in [http://quickgit.kde.org/index.php?p=scratch%2Fberger%2Fcalligra-release-scripts.git&a=summary calligra's release scripts ])
* update scripty for stable translations (edit scripts/get_paths  change the get_path function, and check that list_modules contains calligra):
 svn co svn+ssh://svn@svn.kde.org/home/kde/branches/stable/l10n-kde4/scripts scripts-stable
* update scripty for trunk translations
 svn co svn+ssh://svn@svn.kde.org/home/kde/trunk/l10n-kde4/scripts scripts-trunk
* update branches/stable/l10n-kde4/scripts/documentation_paths with the calligra git branch
* announce it to translators (CCMAIL:kde-i18n-doc@kde.org)
* update branch in calligra project page settings: https://projects.kde.org/projects/calligra/settings

= Information updates =
*Update version info in the source code:
**bump version info to '''N''' for libs in calligra/CMakeLists.txt (10 for 2.5, 11 for 2.6...)<br/><tt>set(GENERIC_CALLIGRA_LIB_VERSION "'''N'''.0.0")<br/>set(GENERIC_CALLIGRA_LIB_SOVERSION "'''N'''")</tt>
**update version info in calligra/libs/main/calligraversion.h:<br/><tt>#define CALLIGRA_VERSION_STRING "<b>x.y Pre-Alpha|Alpha|Beta|RC</b>"<br/>#define CALLIGRA_VERSION_MAJOR '''x'''<br/>#define CALLIGRA_STABLE_VERSION_MINOR <b>y</b><br/>#define CALLIGRA_VERSION_RELEASE '''89 (Pre-Alpha)|90 (Alpha)|91 (Beta)|92 (RC)'''<br/>#define CALLIGRA_ALPHA '''0|1'''<br/>#define CALLIGRA_BETA '''0|1'''<br/>#define CALLIGRA_RC '''0|1'''<br/>#define CALLIGRA_STABLE '''0|1'''<br/></tt>
* Collect changelog items
* Collect screenshots
* Write announcement for calligra.org
** See which packages will be ready at release day (*Linux, Windows, OSX), push people to have them ready
* Set version tag in git repo to the commit the tarball is made from
* Add version for all Calligra bug.kde.org products
* Major release:
**Create tour
**Update stable major version at [http://community.kde.org/index.php?title=Template:Calligra/StableBranch&action=edit community.kde.org] and [http://userbase.kde.org/index.php?title=Template:Calligra/StableBranch&action=edit userbase.kde.org]
**Update unstable major version at [http://community.kde.org/index.php?title=Template:Calligra/UnstableBranch&action=edit community.kde.org] and [http://userbase.kde.org/index.php?title=Template:Calligra/UnstableBranch&action=edit userbase.kde.org]
**Update color at http://community.kde.org/Calligra/Schedules#Important_information
* Update info on http://userbase.kde.org/Calligra/Download
* Update stable release version at [http://community.kde.org/index.php?title=Template:Calligra/Stable&action=edit community.kde.org] and [http://userbase.kde.org/index.php?title=Template:Calligra/Stable&action=edit userbase.kde.org]
* Update info in channel topic of #calligra
* Update unstable stage at [http://community.kde.org/index.php?title=Template:Calligra/Stage&action=edit community.kde.org] and [http://userbase.kde.org/index.php?title=Template:Calligra/Stage&action=edit userbase.kde.org]
* Ask admin to update build.kde.org config to point to right major version for stable: config/projects/calligra.cfg (when master/stable != translation devel/stable) and http://quickgit.kde.org/?p=repo-management.git&a=blob&f=hooks%2Fpost-update
* Kexi
** Update [http://kexi-project.org kexi-project.org]
*** Add link to the Calligra announcement
*** Update Kexi version on the front page
** Update version on [http://kde-apps.org/content/show.php?content=12365 KDE-Apps.org]
** Optional: Publish news on Kexi forum: http://forum.kde.org/viewforum.php?f=220
** Optional: Publish news on Calligra forum: https://forum.kde.org/viewforum.php?f=203
** Publish news on http://identi.ca/kexi, https://twitter.com/kexi_project. https://www.facebook.com/kexi.project fetches news from Twitter.
** Publish news on kexi@kde.org
** Major release: Publish news on http://www.linkedin.com
*Publish news on [https://www.facebook.com/pages/Calligra/161929600510563 Calligra Facebook page]
* Wikipedia
** Update version at http://en.wikipedia.org/wiki/Calligra and http://pl.wikipedia.org/wiki/Calligra
* Update version at http://directory.fsf.org/wiki/Kexi