maketgz: put docs/RELEASE-TOOL.md into the tarball

Generated with scripts/release-tools.sh

The script lists the exact Debian package names and version numbers for
the tools that are used to generate the tarball.

Closes #13239

diff --git a/maketgz b/maketgz
index 4ebda82a99356c2c9559679e8bc3de3174c9a774..602f1071b0082148035409199de4abcaf9d3ef1b 100755 (executable)
--- a/maketgz
+++ b/maketgz
@@ -158,6 +158,9 @@ make -s vc-ide
 echo "produce CHANGES"
 git log --pretty=fuller --no-color --date=short --decorate=full -1000 | ./scripts/log2changes.pl > CHANGES.dist
 
+echo "produce RELEASE-TOOLS.md"
+./scripts/release-tools.sh > docs/RELEASE-TOOLS.md.dist
+
 ############################################################################
 #
 # Now run make dist to generate a tar.gz archive

diff --git a/scripts/release-tools.sh b/scripts/release-tools.sh
new file mode 100755 (executable)
index 0000000..92134be
--- /dev/null
+++ b/scripts/release-tools.sh
@@ -0,0 +1,67 @@
+#!/bin/sh
+#***************************************************************************
+#                                  _   _ ____  _
+#  Project                     ___| | | |  _ \| |
+#                             / __| | | | |_) | |
+#                            | (__| |_| |  _ <| |___
+#                             \___|\___/|_| \_\_____|
+#
+# Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
+#
+# This software is licensed as described in the file COPYING, which
+# you should have received as part of this distribution. The terms
+# are also available at https://curl.se/docs/copyright.html.
+#
+# You may opt to use, copy, modify, merge, publish, distribute and/or sell
+# copies of the Software, and permit persons to whom the Software is
+# furnished to do so, under the terms of the COPYING file.
+#
+# This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
+# KIND, either express or implied.
+#
+# SPDX-License-Identifier: curl
+#
+###########################################################################
+
+cat <<MOO
+# Release tools
+
+The following tools and their Debian package version numbers were used to
+produce this release tarball.
+
+MOO
+
+exists=`which dpkg`;
+if test ! -e "$exists"; then
+    echo "(unknown, could not find dpkg)"
+    exit
+fi
+
+debian() {
+    echo - $1: `dpkg -l $1 | grep ^ii | awk '{print $3}'`
+}
+debian autoconf
+debian automake
+debian libtool
+debian make
+debian perl
+debian git
+
+cat <<MOO
+
+# Reproduce the tarball
+
+- Clone the repo and checkout the release tag
+- Install the same set of tools + versions as listed above
+
+## Do a standard build
+
+- autoreconf -fi
+- ./configure [...]
+- make
+
+## Generate the tarball
+
+- ./maketgz [version]
+
+MOO