maint: improve release procedure instructions.

* gnulib: Update, in particular (README-release).
* bootstrap.conf: don't require gendocs, provided by gnu-web-doc-update,
provided by readme-release.
* README-hacking: Update accordingly.
This commit is contained in:
Akim Demaille
2012-06-07 14:41:56 +02:00
parent cc9fb4f6b6
commit 6733d02476
3 changed files with 16 additions and 29 deletions

View File

@@ -248,25 +248,10 @@ copyright statement for each Bison file, check the copyright statements
that the skeletons insert into generated parsers, and check all that the skeletons insert into generated parsers, and check all
occurrences of PACKAGE_COPYRIGHT_YEAR in configure.ac. occurrences of PACKAGE_COPYRIGHT_YEAR in configure.ac.
** Update NEWS ** Update NEWS, commit and tag.
The version number, *and* the date of the release (including for See do-release-commit-and-tag in README-release.
betas).
** Mention the release name in a commit message ** make alpha, beta, or stable
Should have an entry similar to "Version 2.3b.".
** Tag the release
Before Bison will build with the right version number, you must tag
the release in git. Do this after all other changes. The command is
similar to:
git tag -a v2.3b -m "Bison 2.3b."
** Push
Once "make distcheck" passes, push your changes and the tag.
"git push" without arguments will not push the tag.
** make alpha, beta, or release
See README-release. See README-release.
** Upload ** Upload
@@ -287,8 +272,8 @@ where F125BDF3 should be replaced with your key ID.
*** Using gnupload *** Using gnupload
You need "ncftp". You need "ncftp".
At the end "make release" (or alpha/beta) will display the prodecure At the end "make stable" (or alpha/beta) will display the prodecure to
to run. Just copy and paste it in your shell. run. Just copy and paste it in your shell.
*** By hand *** By hand
@@ -359,7 +344,8 @@ function 'index', once for the table of contents); you can ignore this
issue. issue.
** Announce ** Announce
To generate a template announcement file: The "make stable" (or alpha/beta) command just created a template,
$HOME/announce-bison-X.Y. Otherwise, to generate it, run:
make RELEASE_TYPE=alpha gpg_key_ID=F125BDF3 announcement make RELEASE_TYPE=alpha gpg_key_ID=F125BDF3 announcement
@@ -379,11 +365,12 @@ newsgroup by sending email to compilers@iecc.com. Do not make any Cc as
the moderator will throw away anything cross-posted or Cc'ed. It really the moderator will throw away anything cross-posted or Cc'ed. It really
needs to be a separate message. needs to be a separate message.
** Bump the version number ** Prepare NEWS
In configure.ac. Run "make". So that developers don't accidentally add new So that developers don't accidentally add new items to the old NEWS
items to the old NEWS entry, create a new empty NEWS entry something like: entry, create a new empty entry in line 3 (without the two leading
spaces):
Changes in version ?.? (????-??-??): * Noteworthy changes in release ?.? (????-??-??) [?]
Push these changes. Push these changes.

View File

@@ -17,13 +17,13 @@
# gnulib modules used by this package. # gnulib modules used by this package.
gnulib_modules=' gnulib_modules='
announce-gen argmatch assert calloc-posix close closeout config-h c-strcase argmatch assert calloc-posix close closeout config-h c-strcase
configmake configmake
dirname dirname
error extensions fdl fopen-safer gendocs getopt-gnu error extensions fdl fopen-safer getopt-gnu
gettext git-version-gen gitlog-to-changelog gettext git-version-gen gitlog-to-changelog
gpl-3.0 hash inttypes isnan javacomp-script gpl-3.0 hash inttypes isnan javacomp-script
javaexec-script ldexpl maintainer-makefile malloc-gnu mbschr mbsrchr javaexec-script ldexpl malloc-gnu mbschr mbsrchr
mbswidth obstack perror progname mbswidth obstack perror progname
quote quotearg quote quotearg
readme-release readme-release

2
gnulib

Submodule gnulib updated: db60bb41e9...b42157dd01