From 4fd053d6b29a1b6724eda17a3daddb29b1bf1ca3 Mon Sep 17 00:00:00 2001
From: ArthurHoaro See Git - Maintaining a project - Tagging your [](.html) This guide assumes that you have:Release Shaarli
releases.Prerequisites
+Prerequisites
upstream
pointing to the main Shaarli repository$ cd /path/to/shaarli
+$ cd /path/to/shaarli
# create a new branch
-$ git fetch upstream
-$ git checkout upstream/master -b v0.5.0
+$ git fetch upstream
+$ git checkout upstream/master -b v0.5.0
# bump the version number
-$ vim index.php shaarli_version.php
+$ vim index.php shaarli_version.php
# rebuild the documentation from the wiki
-$ make htmldoc
+$ make htmldoc
# commit the changes
-$ git add index.php shaarli_version.php doc
-$ git commit -s -m "Bump version to v0.5.0"
+$ git add index.php shaarli_version.php doc
+$ git commit -s -m "Bump version to v0.5.0"
# push the commit on your GitHub fork
-$ git push origin v0.5.0
+$ git push origin v0.5.0
This one is pretty straightforward ;-)
# update your local copy
-$ git checkout master
-$ git fetch upstream
-$ git pull upstream master
+$ git checkout master
+$ git fetch upstream
+$ git pull upstream master
# create a signed tag
-$ git tag -s -m "Release v0.5.0" v0.5.0
+$ git tag -s -m "Release v0.5.0" v0.5.0
# push it to "upstream"
-$ git push --tags upstream
v0.5.0
is the first GPG-signed tag pushed on the Community Shaarli.
Let's have a look at its signature!
-$ cd /path/to/shaarli
-$ git fetch upstream
+$ cd /path/to/shaarli
+$ git fetch upstream
# get the SHA1 reference of the tag
-$ git show-ref tags/v0.5.0
-f7762cf803f03f5caf4b8078359a63783d0090c1 refs/tags/v0.5.0
+$ git show-ref tags/v0.5.0
+f7762cf803f03f5caf4b8078359a63783d0090c1 refs/tags/v0.5.0
# verify the tag signature information
-$ git verify-tag f7762cf803f03f5caf4b8078359a63783d0090c1
-gpg: Signature made Thu 30 Jul 2015 11:46:34 CEST using RSA key ID 4100DF6F
-gpg: Good signature from "VirtualTam <virtualtam@flibidi.net>" [ultimate][](.html)
+$ git verify-tag f7762cf803f03f5caf4b8078359a63783d0090c1
+gpg: Signature made Thu 30 Jul 2015 11:46:34 CEST using RSA key ID 4100DF6F
+gpg: Good signature from "VirtualTam <virtualtam@flibidi.net>" [ultimate][](.html)
Users with a shared hosting may have:
+To ease Shaarli installations, it is possible to generate and upload additional release archives,
+that will contain Shaarli code plus all required third-party libraries:
$ make release_archive
This will create the following archives:
+shaarli-vX.Y.Z-full.tar
shaarli-vX.Y.Z-full.zip
The archives need to be manually uploaded on the previously created GitHub release.