X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?p=ngircd-alex.git;a=blobdiff_plain;f=doc%2FHowToRelease.txt;h=2bd98486375e94526439379fae34d6c68a890ccc;hp=54551bd599f5dbf3071d7a0db1251a5e382fc778;hb=HEAD;hpb=bc728f92de5aca1ae14c51696e35103b77a71657 diff --git a/doc/HowToRelease.txt b/doc/HowToRelease.txt index 54551bd5..35514230 100644 --- a/doc/HowToRelease.txt +++ b/doc/HowToRelease.txt @@ -2,7 +2,7 @@ ngIRCd - Next Generation IRC Server http://ngircd.barton.de/ - (c)2001-2017 Alexander Barton and Contributors. + (c)2001-2024 Alexander Barton and Contributors. ngIRCd is free software and published under the terms of the GNU General Public License. @@ -35,19 +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 ;-) - - is the AUTHORS file up to date? - -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,13 +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) Update the ngIRCd website and its mirrors! -m) Write an announcement to the mailing list, Twitter, ... +n) Write an announcement to the mailing list, Twitter, ... -n) Relax :-) +o) Relax :-)