From: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Date: Fri, 22 Sep 2023 21:23:47 +0000 (+0200)
Subject: docs: refresh stale release information
X-Git-Tag: pool-3.2.0~48
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f7135d07d97b7fa71f0d108baf73e051095fa7c6;p=thirdparty%2Fpsycopg.git

docs: refresh stale release information
---

diff --git a/docs/release.rst b/docs/release.rst
index 8fcadaf3f..d793cc923 100644
--- a/docs/release.rst
+++ b/docs/release.rst
@@ -3,13 +3,17 @@
 How to make a psycopg release
 =============================
 
-- Change version number in:
+- Check if there is a new version or libpq_ or OpenSSL_; in such case
+  update ``LIBPQ_VERSION`` and/or ``OPENSSL_VERSION`` in
+  ``.github/workflows/packages-bin.yml``.
 
-  - ``psycopg_c/psycopg_c/version.py``
-  - ``psycopg/psycopg/version.py``
-  - ``psycopg_pool/psycopg_pool/version.py``
+    .. _libpq: https://www.postgresql.org/ftp/source/
 
-- Change docs/news.rst to drop the "unreleased" mark from the version
+    .. _OpenSSL: https://www.openssl.org/source/
+
+- Use ``tools/bump_version.py`` to upgrade package version numbers.
+
+- Change ``docs/news.rst`` to drop the "unreleased" mark from the version
 
 - Push to GitHub to run `the tests workflow`__.
 
@@ -19,21 +23,27 @@ How to make a psycopg release
 
   .. __: https://github.com/psycopg/psycopg/actions/workflows/packages.yml
 
-- If all went fine, create a tag named after the version::
+- Delete the ``wheelhouse`` directory there is one.
+
+- Build m1 packages by running ``./tools/build/run_build_macos_arm64.sh BRANCH``.
+  On successful completion it will save built packages in ``wheelhouse``
+
+- If all packages were built ok, push the new tag created by ``bump_version.py``::
 
-    git tag -a -s 3.0.dev1
     git push --tags
 
 - Download the ``artifacts.zip`` package from the last Packages workflow run.
 
-- Unpack the packages locally::
+- Unpack the packages in the wheelhouse dir::
 
-    mkdir tmp
-    cd tmp
+    mkdir -p wheelhouse
+    cd wheelhouse
     unzip ~/Downloads/artifact.zip
 
 - If the package is a testing one, upload it on TestPyPI with::
 
-    $ twine upload -s -r testpypi *
+    $ twine upload -r testpypi *
+
+- If the package is stable, omit ``-r testpypi``::
 
-- If the package is stable, omit ``-r testpypi``.
+    $ twine upload *
diff --git a/tools/build/build_libpq.sh b/tools/build/build_libpq.sh
index 7e9cf9a93..b191ce551 100755
--- a/tools/build/build_libpq.sh
+++ b/tools/build/build_libpq.sh
@@ -5,17 +5,19 @@
 set -euo pipefail
 set -x
 
-# Last release: https://www.postgresql.org/ftp/source/
+# WARNING: the version used in CI are defined in .github/workflows/packages-bin.yml
+
+# Latest release: https://www.postgresql.org/ftp/source/
 # IMPORTANT! Change the cache key in packages.yml when upgrading libraries
 postgres_version="${LIBPQ_VERSION:-15.4}"
 
-# last release: https://www.openssl.org/source/
+# Latest release: https://www.openssl.org/source/
 openssl_version="${OPENSSL_VERSION:-1.1.1v}"
 
-# last release: https://openldap.org/software/download/
+# Latest release: https://openldap.org/software/download/
 ldap_version="2.6.6"
 
-# last release: https://github.com/cyrusimap/cyrus-sasl/releases
+# Latest release: https://github.com/cyrusimap/cyrus-sasl/releases
 sasl_version="2.1.28"
 
 export LIBPQ_BUILD_PREFIX=${LIBPQ_BUILD_PREFIX:-/tmp/libpq.build}