X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?p=ngircd-alex.git;a=blobdiff_plain;f=doc%2FHowToRelease.txt;h=35514230e96b1924c15a5924b938c119c4e44625;hp=c965b798ed4406723f253dfb7765552d0920218d;hb=HEAD;hpb=f33a4067a16747c8fc5f1c0b5eb5e5520ee1e7a7 diff --git a/doc/HowToRelease.txt b/doc/HowToRelease.txt index c965b798..35514230 100644 --- a/doc/HowToRelease.txt +++ b/doc/HowToRelease.txt @@ -1,9 +1,8 @@ ngIRCd - Next Generation IRC Server + http://ngircd.barton.de/ - (c)2001-2010 Alexander Barton, - alex@barton.de, http://www.barton.de/ - + (c)2001-2024 Alexander Barton and Contributors. ngIRCd is free software and published under the terms of the GNU General Public License. @@ -36,18 +35,28 @@ up-to-date (e.g. using ./autogen.sh) before generating the archives! II. How to prepare a new ngIRCd release? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -a) Make sure the source tree is in a releasable state ;-) - -b) Make sure you have working versions of GNU autoconf and GNU automake +a) Make sure you have working versions of GNU autoconf and GNU automake installed on the system you use for generating the release: - as of October 2010 we are using GNU autoconf 2.67 and GNU automake 1.11.1 + as of May 2020 we are using GNU autoconf 2.69 and GNU automake 1.11.6 which seem to work just fine. + NOTE: new releases of GNU automake DO NOT work, as they lack support for + the "ansi2knr" wrapper and "de-ANSI-fication" support! + +b) Make sure the source tree is in a releasable state ;-) + - Are all branches & patches merged? Check GitHub issues, pull requests + and milestones! + - Run as many tests as you can! + - Is the AUTHORS.md file up to date? This command may be helpful: + "( grep '>$' AUTHORS.md; git shortlog -se|cut -c8-|sed 's/^/- /' ) \ + | grep -Ev '(alex@barton.de|fw@strlen.de)' \ + | LC_ALL=de_DE.UTF-8 sort -u" c) Update the files describing the new release: - ChangeLog - NEWS d) Update the version numbers in the following files: + - contrib/de.barton.ngircd.metainfo.xml - contrib/ngircd.spec e) Generate a new Debian change log entry in the following file, e.g. using @@ -65,15 +74,16 @@ h) Run "./autogen.sh" to update the ./configure script with the correct i) Run "./configure" to rebuild all generated Makefiles. -j) Run "make distcheck" to generate the distribution archives. +j) Run "make distcheck" (and "make dist-tarZ && make dist-xz") to generate all + of the distribution archives. k) Sign the distribution archive(s) using GnuPG: "gpg -b " l) Upload and distribute the newly generated ngIRCd release archive(s) - and GnuPG signatures. + and GnuPG signatures (to the website, its mirrors, and GitHub). -m) Write an announcement to the mailing list, freshmeat, Twitter, ... +m) Update the ngIRCd website and its mirrors! -n) Update the list of releases in our bug tracker. +n) Write an announcement to the mailing list, Twitter, ... o) Relax :-)