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.

diff --git a/maint/README-release b/maint/README-release
new file mode 100644 (file)
index 0000000..fa2a22d
--- /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 (executable)
index 0000000..8cb8e48
--- /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 (executable)
index 0000000..f23d091
--- /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 (executable)
index 0000000..6c376b8
--- /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>'