From commits-return-4446-archive-asf-public=cust-asf.ponee.io@celix.apache.org Wed Jan 24 14:33:59 2018 Return-Path: X-Original-To: archive-asf-public@eu.ponee.io Delivered-To: archive-asf-public@eu.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by mx-eu-01.ponee.io (Postfix) with ESMTP id 9AC72180630 for ; Wed, 24 Jan 2018 14:33:59 +0100 (CET) Received: by cust-asf.ponee.io (Postfix) id 8BC44160C2E; Wed, 24 Jan 2018 13:33:59 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id AB3D7160C3C for ; Wed, 24 Jan 2018 14:33:58 +0100 (CET) Received: (qmail 12576 invoked by uid 500); 24 Jan 2018 13:33:57 -0000 Mailing-List: contact commits-help@celix.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@celix.apache.org Delivered-To: mailing list commits@celix.apache.org Received: (qmail 12567 invoked by uid 99); 24 Jan 2018 13:33:57 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 24 Jan 2018 13:33:57 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 17987EF792; Wed, 24 Jan 2018 13:33:57 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: pnoltes@apache.org To: commits@celix.apache.org Date: Wed, 24 Jan 2018 13:33:58 -0000 Message-Id: <2f3fe1cf6b5e4c8d946b7e46f12ff453@git.apache.org> In-Reply-To: <210e241e2a6a4800b05a85deaf92c95d@git.apache.org> References: <210e241e2a6a4800b05a85deaf92c95d@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [3/3] celix-site git commit: Updates releasing documentation to reflect usage of git Updates releasing documentation to reflect usage of git Project: http://git-wip-us.apache.org/repos/asf/celix-site/repo Commit: http://git-wip-us.apache.org/repos/asf/celix-site/commit/dc8b8ff1 Tree: http://git-wip-us.apache.org/repos/asf/celix-site/tree/dc8b8ff1 Diff: http://git-wip-us.apache.org/repos/asf/celix-site/diff/dc8b8ff1 Branch: refs/heads/asf-site Commit: dc8b8ff18f8a153802ac8d4f925a02d08cfe5c58 Parents: e8ec1bc Author: Pepijn Noltes Authored: Wed Jan 24 14:40:55 2018 +0100 Committer: Pepijn Noltes Committed: Wed Jan 24 14:40:55 2018 +0100 ---------------------------------------------------------------------- src/markdown/releasing.md | 60 +++++++++--------------------------------- 1 file changed, 12 insertions(+), 48 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/celix-site/blob/dc8b8ff1/src/markdown/releasing.md ---------------------------------------------------------------------- diff --git a/src/markdown/releasing.md b/src/markdown/releasing.md index 7bf80d1..488cb69 100644 --- a/src/markdown/releasing.md +++ b/src/markdown/releasing.md @@ -36,7 +36,7 @@ for more information. This updated file needs to be uploaded to SVN, be sure to ## Update release related files For every release the related files must be updated. The following files are relevant: - - CHANGES + - CHANGES.md Add a list of fixed issues which can be created using Jira. @@ -66,26 +66,7 @@ Note: The DEFAULT_VERSION property is used as default version for new bundles an Before creating a branch, be sure that the source compiles and tests run successfully. If there are any known shortcomings, make sure they are listed in the RELEASE_NOTES. Details for compiling and testing are available in the BUILDING file. - // Create a directory as sibling of the celix release directory - > mkdir celix-build - > cd celix-build - // Run CMake to generate the makefiles. Enable all BUILD options. - > ccmake ../celix - > make - > make deploy - > make test - -Also verify that the provides examples work as expected. If needed ask other committers to test parts, eg the GTK examples. - - // Go to the deploy directory to see all examples - > cd deploy - // Test the different examples, eg - > cd hello_world - > sh run.sh - // Depending on the example the output might be different. Most examples provide a shell to inspect the framework. - // To list the commands use the "help" command. - -> help - .... +Also verify that the provides examples work as expected. If needed ask other committers to test parts. After verifying the build, run Apache RAT to check for any licensing problems. If Apache RAT is configured in the CMake build the "rat" target can be used to run the check. @@ -93,35 +74,23 @@ the check. // From the celix-build directory // Run CMake to set the APACHE_RAT library (path to the JAR file). > ccmake ../celix - // Run RAT + // Configure location of the apache-rat jar > make rat Apache RAT should not raise any concers, if there are, check the source files for a license header. If it is a false positive update the rat-excludes.txt file in the root of the project. Be sure it is a false positive! If in doubt, ask the mailing list! Third party licenses may need to be mentioned in the NOTICE file. -## Create SVN tag -After changing all files a tag for the new release must be made. Before doing so, make sure all changed files are committed. - -The tag should be named like this: celix-X.Y.Z - -To make a tag use the following command: +## Git commit ID +After changing all files a git commit ID can be used for the new release must be made. Before doing so, make sure all changed files are committed. - svn copy http://svn.apache.org/repos/asf/celix/trunk/ \ - http://svn.apache.org/repos/asf/celix/tags/celix-X.Y.Z \ - -m "X.Y.Z release of the Apache Celix project." - -Note: Make sure there are no new changes made on trunk while working on the release. Discuss: Use a branch for staging the release and the files? Or possibly use a revision nr? +Note: Make sure there are no new changes made on release branch while working on the release. ## Create, sign and publish artefacts Since Celix only releases source artefacts, creating the artefact is simple and straightforward - // Create symbolic link so the archive has a directory with version information - > ln -s celix celix-X.Y.Z - // Create GZip archive - > tar -hczf celix-X.Y.Z.tar.gz celix-X.Y.Z - // The create symbolic link can be removed - > celix celix-X.Y.Z + // Create a release artefact using git archive + > git archive --format tar.gz --prefix celix-/ > celix-.tar.gz After creating the artefact, the file has to be signed. More information about signing can be found at (http://www.apache.org/dev/release-signing.html). @@ -132,7 +101,7 @@ After creating the artefact, the file has to be signed. More information about s // Generate ASCII signature > gpg --armor --output celix-X.Y.Z.tar.gz.asc --detach-sig celix-X.Y.Z.tar.gz -Copy the archive of the source to the [Apache Celix release development area](https://dist.apache.org/repos/dist/dev/incubator/celix/KEYS) (using SVN). +Copy the archive of the source to the [Apache Celix release development area](https://dist.apache.org/repos/dist/dev/celix) (using SVN). See the [Apache Release Guide](http://www.apache.org/dev/release.html#host-rc) for more information. @@ -147,14 +116,12 @@ The first vote has to be done on the public mailinglist of the project itself (d > This is the release vote for Apache Celix, version X.Y.Z. -> It fixes the following issues: -> {Create Release Note link using https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12323511} - > Source files: > https://dist.apache.org/repos/dist/dev/celix/celix-X.Y.Z/ -> The tag to be voted upon: -> http://svn.apache.org/repos/asf/celix/tags/celix-X.Y.Z/ +> The commit ID to be voted upon: +> +> https://github.com/apache/celix/tree/ > Celix's keys can be found at: > https://dist.apache.org/repos/dist/dev/incubator/celix/KEYS @@ -239,9 +206,6 @@ The following template must be used: > The release is available here: > http://celix.apache.org/download.cgi -> The full change log is available here: -> {Create Release Note link using https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12323511} - > We welcome your help and feedback. For more information on how to report problems, > and to get involved, visit the project website at http://celix.apache.org/