@@ -829,53 +829,19 @@ slightly different steps. We'll call attention where the steps differ.
829829 for posting the release announcement to Mastodon. Posts need to be
830830 approved.
831831
832- # # Re-releasing the same version or a patch-level (i.e., `-plN`)
832+ # # Re-releasing the same version
833833
834834While unlikely, there may be times we need to re-release the same version. This
835- might happen if the tarballs have a corrupted file, for example.
836-
837- Should this occur * before* announcing the release, you may choose to delete the
838- tag and go through the full packaging process again, as described above.
835+ might happen if the tarballs have a corrupted file, for example, or when there
836+ is a build error.
839837
840838> 💬 ** Hint** \
841839> This is one of the reasons we package releases two days before announcing
842840> them.
843841
844- If this happens * after* announcing the release, you may choose to tag, package,
845- and release a patch-level (i.e., * pl* ) release. If it is not critical and/or
846- affects a very limited subset of users, then you may choose to wait until the
847- next release.
848-
849- If you choose to create a patch-level release, follow these steps:
850-
851- 1. Commit the new binaries to ` web-php-distributions`
852-
853- 2. Update $data [' X.Y' ] in ` web-php:/include/version.inc`
854- (X.Y=major.minor release, e.g. ' 8.0' ):
855-
856- * ` version` to the full version number (e.g. ' 8.0.1-pl1' )
857- * ` date` to the release date in ` j M Y` format (e.g. ' 9 Jan 2021' )
858- * ` tags` array should include ` security` if this is a security release
859- * ` sha256` array and sub-elements for all SHA256 sums
860-
861- 3. Add a short notice to ` web-php` stating that there is a new release, and
862- highlight the major important things (security fixes) and when it is
863- important to upgrade.
864-
865- * Call ` php bin/createReleaseEntry -v < version> [ --security ]` in your
866- local web-php checkout.
867-
868- 4. Commit all the changes (` include/version.inc` , ` archive/archive.xml` ,
869- ` archive/entries/YYYY-MM-DD-N.xml` ).
870-
871- 5. Wait an hour or two, then send a mail to [email protected] , 872- 873- the news entry.
874-
875- Please make sure that the mail to php-announce@ is its own completely
876- separate email. This is to make sure that replies to the announcement on
877- php-general@ or internals@ will not accidentally hit the php-announce@
878- mailinglist.
842+ You * must not* delete and recreate a pushed tag. Instead, you need to go
843+ through the full packaging process again, as described above, whilst increasing
844+ the version number. This is unfortunate, but published tags must be immutable.
879845
880846
881847# # Soft feature freeze
0 commit comments