This is an automated email from the ASF dual-hosted git repository.
markt pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/tomcat-native.git
The following commit(s) were added to refs/heads/main by this push:
new d4e08d665 Document the release process
d4e08d665 is described below
commit d4e08d665d23672891f043c0679f039811d6dbf0
Author: Mark Thomas <ma...@apache.org>
AuthorDate: Thu Jun 30 09:24:15 2022 +0100
Document the release process
---
HOWTO-RELEASE.txt | 84 +++++++++++++++++++++++++++++++++++++++
TODO.txt | 2 -
xdocs/miscellaneous/changelog.xml | 3 ++
3 files changed, 87 insertions(+), 2 deletions(-)
diff --git a/HOWTO-RELEASE.txt b/HOWTO-RELEASE.txt
new file mode 100644
index 000000000..461b4a7b4
--- /dev/null
+++ b/HOWTO-RELEASE.txt
@@ -0,0 +1,84 @@
+================================================================================
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+================================================================================
+
+How to do a Tomcat Native release
+=================================
+
+Requirements
+------------
+
+Java 11
+Apache Ant 1.9 or later
+Apache APR 1.7.0 or later source
+
+
+Preparation
+-----------
+
+Review the open issues in Bugzilla.
+Review open PRs in GitHub.
+
+If you haven't already, add your public PGP key to KEYS.
+
+Ensure dates and/or version numbers are up to date:
+- build.properties.default
+- native/build/rpm/tcnative.spec.in
+- native/include/tcn_version.h
+- native/os/win32/libtcnative.rc
+- xdocs/miscellaneous/changelog.xml
+
+Run the release script to check the Java code is aligned with the current
10.1.x
+source.
+./jnirelease.sh --ver=main --with-apr=/path/to/apr/source
+
+
+Tagging
+-------
+
+# Check clone is up to date and clean
+git pull
+git status
+
+# Edit files to remove / disable dev build flags
+# - build.properties.default
+# - tcn_version.h
+
+# Confirm the previous edits
+git diff
+
+# Tag (modify version as appropriate)
+git commit -a -m "Tag 2.0.0"
+git tag 2.0.0
+git push origin 2.0.0
+
+# Reset main
+git reset --hard HEAD~1
+
+
+Create the source release
+-------------------------
+
+# Modify version as appropriate
+./jnirelease.sh --ver=2.0.0 --with-apr=/path/to/apr/source
+
+
+Create the binary release for Windows
+-------------------------------------
+
+See native/building
+
+
diff --git a/TODO.txt b/TODO.txt
index ed95823ce..fe4c30daa 100644
--- a/TODO.txt
+++ b/TODO.txt
@@ -24,8 +24,6 @@
Releasing
---------
-- Document how to release.
-
- ZIP download seems to have group write permissions set
(at least after I extract it on Solaris).
It's a bit strange that permissions differ between the
diff --git a/xdocs/miscellaneous/changelog.xml
b/xdocs/miscellaneous/changelog.xml
index 609673dce..766f4cfad 100644
--- a/xdocs/miscellaneous/changelog.xml
+++ b/xdocs/miscellaneous/changelog.xml
@@ -64,6 +64,9 @@
Vista and Windows Server 2008. The minimum Windows version is now Windows
7 / Windows Server 2008 R2. (markt)
</update>
+ <docs>
+ Add HOWTO-RELEASE.txt that describes the release process. (markt)
+ </docs>
</changelog>
</section>
<section name="Changes in 1.2.x">
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
