ngIRCd Release 27

[ngircd-alex.git] / doc / HowToRelease.txt

diff --git a/doc/HowToRelease.txt b/doc/HowToRelease.txt
index 909aa56b388ef20e40d4bcbb5597b9ea81f6d648..35514230e96b1924c15a5924b938c119c4e44625 100644 (file)
--- a/doc/HowToRelease.txt
+++ b/doc/HowToRelease.txt
@@ -2,7 +2,7 @@
                      ngIRCd - Next Generation IRC Server
                            http://ngircd.barton.de/
 
                      ngIRCd - Next Generation IRC Server
                            http://ngircd.barton.de/
 

-               (c)2001-2018 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.
 
                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?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 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:
    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.
    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:
 
 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
     - contrib/ngircd.spec
 
 e) Generate a new Debian change log entry in the following file, e.g. using


@@ -65,8 +74,8 @@ h) Run "./autogen.sh" to update the ./configure script with the correct
 
 i) Run "./configure" to rebuild all generated Makefiles.
 
 
 i) Run "./configure" to rebuild all generated Makefiles.
 

-j) Run "make distcheck" (and "make dist-tarZ dist-xz") to generate all of 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 <archivefile>"
 
 
 k) Sign the distribution archive(s) using GnuPG: "gpg -b <archivefile>"