ngIRCd Release 27

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

diff --git a/doc/HowToRelease.txt b/doc/HowToRelease.txt
index 54551bd599f5dbf3071d7a0db1251a5e382fc778..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-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.
 
                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,13 +74,16 @@ 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" 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 <archivefile>"
 
 l) Upload and distribute the newly generated ngIRCd release archive(s)
 
 k) Sign the distribution archive(s) using GnuPG: "gpg -b <archivefile>"
 
 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 :-)