@@ -829,53 +829,19 @@ slightly different steps. We'll call attention where the steps differ.
829
829
for posting the release announcement to Mastodon. Posts need to be
830
830
approved.
831
831
832
- # # Re-releasing the same version or a patch-level (i.e., `-plN`)
832
+ # # Re-releasing the same version
833
833
834
834
While 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.
839
837
840
838
> 💬 ** Hint** \
841
839
> This is one of the reasons we package releases two days before announcing
842
840
> them.
843
841
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.
879
845
880
846
881
847
# # Soft feature freeze
0 commit comments