Update the notes on how to create a branch prior to a new release.

This commit is contained in:
Nick Clifton 2020-01-18 14:37:55 +00:00
parent 1b1bb2c67b
commit b248e9ce9a
2 changed files with 24 additions and 18 deletions

View File

@ -1,3 +1,8 @@
2020-01-18 Nick Clifton <nickc@redhat.com>
* README-how-to-make-a-release: Update notes on how to cut a
branch for a release.
2020-01-18 Nick Clifton <nickc@redhat.com> 2020-01-18 Nick Clifton <nickc@redhat.com>
* configure: Regenerate. * configure: Regenerate.

View File

@ -96,7 +96,7 @@ How to perform a release.
Make sure that this includes the .pot files as well as the Make sure that this includes the .pot files as well as the
configure and makefiles. configure and makefiles.
8. Create an initial pre-release: 9. Create an initial pre-release:
a. Remove any auto-generated files, in order to force the a. Remove any auto-generated files, in order to force the
src-release script to rebuild them. src-release script to rebuild them.
@ -110,12 +110,12 @@ How to perform a release.
c. Build a test target using this tarball. c. Build a test target using this tarball.
cp binutils-<version>.tar.xz /dev/shm cp binutils-<OLD_VERSION>.90.tar.xz /dev/shm
cd /dev/shm cd /dev/shm
tar xvf binutils-<version>.tar.xz tar xvf binutils-<OLD_VERSION>.90.tar.xz
mkdir build mkdir build
cd build cd build
../<version>/configure --quiet --enable-gold ../binutils-<OLD_VERSION>.90/configure --quiet --enable-gold
make make
If there are problems, fix them. If there are problems, fix them.
@ -123,45 +123,45 @@ How to perform a release.
d. Upload the pre-release snapshot to the sourceware FTP site: d. Upload the pre-release snapshot to the sourceware FTP site:
cd <branch-sources> cd <branch-sources>
scp binutils-<version>.tar.xz sourceware.org:~ftp/pub/binutils/snapshots scp binutils-<OLD_VERSION>.90.tar.xz sourceware.org:~ftp/pub/binutils/snapshots
ssh sourceware.org md5sum ~ftp/pub/binutils/snapshots/binutils-<version>.tar.xz ssh sourceware.org md5sum ~ftp/pub/binutils/snapshots/binutils-<OLD_VERSION>.90.tar.xz
e. Clean up the source directory again. e. Clean up the source directory again.
git clean -fdx . git clean -fdx .
9. Tell the Translation Project where to find the new tarball. 10. Tell the Translation Project where to find the new tarball.
<coordinator@translationproject.org> <coordinator@translationproject.org>
qv: http://translationproject.org/html/maintainers.html qv: http://translationproject.org/html/maintainers.html
------------------------------------------------------------------------ ------------------------------------------------------------------------
Dear Translation Project Dear Translation Project
The 2.3x release branch has been created for the FSF binutils. The <NEW_VERSION> release branch has been created for the GNU binutils.
A snapshot of the branch sources can be found here: A snapshot of the branch sources can be found here:
https://sourceware.org/pub/binutils/snapshots/binutils-2.3x.90.tar.xz https://sourceware.org/pub/binutils/snapshots/binutils-<OLD_VERSION>.90.tar.xz
We hope to make the official release of the sources on the 8th July We hope to make the official release of the sources on the <DATE>
although that could change if there are important bugs that need to although that could change if there are important bugs that need to
be fixed before the release. be fixed before the release.
------------------------------------------------------------------------ ------------------------------------------------------------------------
10. Announce the availability of the snapshot and the branch on the 11. Announce the availability of the snapshot and the branch on the
binutils mailing list. Set a date for when the release will binutils mailing list. Set a date for when the release will
actually happen. Something like: actually happen. Something like:
------------------------------------------------------------------------ ------------------------------------------------------------------------
Hi Everyone, Hi Everyone,
The 2.3x branch has now been created: The <NEW_VERSION> branch has now been created:
git clone git://sourceware.org/git/binutils-gdb.git -b binutils-2_3x-branch 2.3x git clone git://sourceware.org/git/binutils-gdb.git -b binutils-<NEW_VERSION>-branch <NEW_VERSION>
A snapshot of the sources is also available here: A snapshot of the sources is also available here:
https://sourceware.org/pub/binutils/snapshots/binutils-2.3x.90.tar.xz https://sourceware.org/pub/binutils/snapshots/binutils-<OLD_VERSION>.90.tar.xz
Please could all patches for the branch be run by me. Please could all patches for the branch be run by me.
The rules for the branch are: The rules for the branch are:
@ -174,14 +174,15 @@ Hi Everyone,
* Fixes for testsuite failures are OK. * Fixes for testsuite failures are OK.
Ideally I would like to make the release happen in two weeks time, Ideally I would like to make the release happen in two weeks time,
i.e. Saturday 27th Jan. Which I hope will be enough time for everyone i.e. <DATE>. Which I hope will be enough time for everyone
to get their final fixes in. to get their final fixes in.
------------------------------------------------------------------------ ------------------------------------------------------------------------
11. Build various different toolchains, test them and nag 12. Build various different toolchains, test them and nag
maintainers to fix any testsuite failures for their maintainers to fix any testsuite failures for their
architectures... architectures...
==============================================================================
When the time comes to actually make the release.... When the time comes to actually make the release....
@ -195,7 +196,7 @@ When the time comes to actually make the release....
21. Update the release number in bfd/version.m4 on the release 21. Update the release number in bfd/version.m4 on the release
branch to a whole new minor version number, without a point branch to a whole new minor version number, without a point
value. Eg "2.29.90" becomes "2.30". Change bfd/development.sh value. Eg "2.33.90" becomes "2.34". Change bfd/development.sh
to set all values to "false". Regenerate the configure and to set all values to "false". Regenerate the configure and
makefiles. And *info* files. Add ChangeLog entries for the makefiles. And *info* files. Add ChangeLog entries for the
updates and add a "this-is-the-2.3x-release" comment and updates and add a "this-is-the-2.3x-release" comment and
@ -283,7 +284,7 @@ When the time comes to actually make the release....
directories had to be made by hand, as shown above). directories had to be made by hand, as shown above).
cd as cd as
lcd <build-dir>/gas/doc/as.html lcd <build-dir>/gas/doc/as.html<
put * put *
cd ../bfd cd ../bfd
lcd ../../../bfd/doc/bfd.html lcd ../../../bfd/doc/bfd.html