From f52ff7d49ca6d0db87b45db6accc724e5cbcb50f Mon Sep 17 00:00:00 2001
From: "Dmitry V. Levin" <ldv@altlinux.org>
Date: Thu, 14 Jun 2018 11:00:00 +0000
Subject: [PATCH] maint: document release procedure

* maint/README-release: New file.
* maint/gen-release-notes.sh: Likewise.
* maint/gen-release-github.sh: Likewise.
* maint/gen-release-gitlab.sh: Likewise.
---
 maint/README-release        | 21 +++++++++++++++++++++
 maint/gen-release-github.sh | 12 ++++++++++++
 maint/gen-release-gitlab.sh | 22 ++++++++++++++++++++++
 maint/gen-release-notes.sh  |  5 +++++
 4 files changed, 60 insertions(+)
 create mode 100644 maint/README-release
 create mode 100755 maint/gen-release-github.sh
 create mode 100755 maint/gen-release-gitlab.sh
 create mode 100755 maint/gen-release-notes.sh

diff --git a/maint/README-release b/maint/README-release
new file mode 100644
index 00000000..fa2a22d8
--- /dev/null
+++ b/maint/README-release
@@ -0,0 +1,21 @@
+* commit changes prepared by maint/update_copyright_years.sh
+* update copyright year number range in COPYING and debian/copyright
+* prepare NEWS for release
+* generate release notes for strace.io and git repository mirrors
+  using maint/gen-release-notes.sh, maint/gen-release-github.sh
+  and maint/gen-release-gitlab.sh
+* create a release tag using maint/gen-tag-message.sh
+* generate a release tarball using make-dist
+* send the tarball to release farms for the final testing
+* prepare and test package builds for ALT and Rawhide
+* generate a detached signature for the tarball using gpg -ab
+* push the release tag to all git repository mirrors
+* upload the tarball, it's signature and release notes to strace.io
+  and all git repository mirrors
+* adjust the link to the latest release at strace.io
+* submit a release announce to strace-devel
+* update irc #strace topic using /topic #strace
+* update https://en.wikipedia.org/wiki/Strace
+* tweet the news
+* announce the new release at http://freshcode.club/projects/strace
+* announce the new release at other news-related sites
diff --git a/maint/gen-release-github.sh b/maint/gen-release-github.sh
new file mode 100755
index 00000000..8cb8e486
--- /dev/null
+++ b/maint/gen-release-github.sh
@@ -0,0 +1,12 @@
+#!/bin/sh -efu
+
+"$(dirname "$0")"/gen-tag-message.sh |
+	sed 's/\([^[:space:]]\)\*/\1\\*/g'
+
+cat <<'EOF'
+
+Downloads
+=========
+
+**Please ignore so called "Source code" links provided by github above, they are useless**.
+EOF
diff --git a/maint/gen-release-gitlab.sh b/maint/gen-release-gitlab.sh
new file mode 100755
index 00000000..f23d091a
--- /dev/null
+++ b/maint/gen-release-gitlab.sh
@@ -0,0 +1,22 @@
+#!/bin/sh -efu
+
+cat <<'EOF'
+Downloads
+=========
+
+EOF
+
+set +f
+set -- strace-*.tar.xz*
+set -f
+for f; do
+	printf '[%s](/uploads/%s/%s)\n' "$f" "..." "$f"
+done
+
+cat <<'EOF'
+**Please ignore so called "Source code" links provided by gitlab, they are useless**.
+
+EOF
+
+"$(dirname "$0")"/gen-tag-message.sh |
+	sed 's/\([^[:space:]]\)\*/\1\\*/g'
diff --git a/maint/gen-release-notes.sh b/maint/gen-release-notes.sh
new file mode 100755
index 00000000..6c376b8f
--- /dev/null
+++ b/maint/gen-release-notes.sh
@@ -0,0 +1,5 @@
+#!/bin/sh -efu
+
+echo '<pre>'
+"$(dirname "$0")"/gen-tag-message.sh
+echo '</pre>'
-- 
2.40.0