This is an automated email from the ASF dual-hosted git repository. swebb2066 pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/logging-log4cxx.git
The following commit(s) were added to refs/heads/master by this push: new df63471a Bump version to 1.5.0 (#496) df63471a is described below commit df63471a3c6330d91a3afc5c1ddf400e72a8e954 Author: Stephen Webb <stephen.w...@ieee.org> AuthorDate: Mon Apr 21 12:26:07 2025 +1000 Bump version to 1.5.0 (#496) * Improve the description of the reuseAddress TelnetAppender option --- src/cmake/projectVersionDetails.cmake | 2 +- src/main/include/log4cxx/net/telnetappender.h | 15 ++++++++------- src/site/markdown/change-report-gh.md | 15 +++++++++++++++ src/site/markdown/download.md.in | 1 + 4 files changed, 25 insertions(+), 8 deletions(-) diff --git a/src/cmake/projectVersionDetails.cmake b/src/cmake/projectVersionDetails.cmake index 85adf450..357b6d8f 100644 --- a/src/cmake/projectVersionDetails.cmake +++ b/src/cmake/projectVersionDetails.cmake @@ -2,4 +2,4 @@ # setting the project version. The variable name must not # clash with the log4cxx_VERSION* variables automatically # defined by the project() command. -set(log4cxx_VER 1.4.0.0) +set(log4cxx_VER 1.5.0.0) diff --git a/src/main/include/log4cxx/net/telnetappender.h b/src/main/include/log4cxx/net/telnetappender.h index a35169b1..e38d344c 100644 --- a/src/main/include/log4cxx/net/telnetappender.h +++ b/src/main/include/log4cxx/net/telnetappender.h @@ -42,8 +42,9 @@ especially when monitoring a servlet remotely. If no layout is provided, the log message only is sent to attached client(s). -The ReuseAddress option is disabled by default, -enable it if you want it to be able to bind to the address immediately after restarting / crashing +The \c ReuseAddress option is disabled by default. +Enable it to be able to connect to this appender +immediately after the logging process restarts. See TelnetAppender::setOption() for the available options. @@ -99,7 +100,7 @@ class LOG4CXX_EXPORT TelnetAppender : public AppenderSkeleton Port | {int} | 23 MaxConnections | {int} | 20 Encoding | C,UTF-8,UTF-16,UTF-16BE,UTF-16LE,646,US-ASCII,ISO646-US,ANSI_X3.4-1968,ISO-8859-1,ISO-LATIN-1 | UTF-8 - ReuseAddress | True,False | True + ReuseAddress | True,False | False \sa AppenderSkeleton::setOption() */ @@ -130,13 +131,13 @@ class LOG4CXX_EXPORT TelnetAppender : public AppenderSkeleton void setMaxConnections(int newValue); /** - Set the SO_REUSEADDR option to of the server socket. - This allows the socket to bind to an address that is in a TIME_WAIT state. - This is useful for restarting immediately after it has been closed. + Use \c newValue for the SO_REUSEADDR option of the socket accepting connections. + When set to \c true, a telnet client can connect when the socket is in a TIME_WAIT state, + so log message delivery will resume quickly when a terminated process restarts. \sa setOption */ - void setReuseAddress(bool reuseAddress); + void setReuseAddress(bool newValue); /** Shutdown this appender. */ void close() override; diff --git a/src/site/markdown/change-report-gh.md b/src/site/markdown/change-report-gh.md index 5fd92223..396e21e1 100644 --- a/src/site/markdown/change-report-gh.md +++ b/src/site/markdown/change-report-gh.md @@ -25,6 +25,7 @@ Change Log {#changelog} | Version | Date | Description | | ------------------- | ---------- | -------------------- | +| [1.5.0](#rel_1_5_0) | 2025-XX-XX | Maintenance release | | [1.4.0](#rel_1_4_0) | 2025-03-01 | Maintenance release | | [1.3.1](#rel_1_3_1) | 2024-11-30 | Bugfix release | | [1.3.0](#rel_1_3_0) | 2024-10-21 | Maintenance release | @@ -48,6 +49,20 @@ Change Log {#changelog} | [0.1.0](#rel_1_0) | 2003-07-08 | | | [0.0.1](#rel_0_1) | 2003-05-31 | | +## Release 1.5.0 - 2025-XX-XX {#rel_1_5_0} + +Release 1.5.0 includes the following new features: + +* Qt6 can be used when building with LOG4CXX_QT_SUPPORT=on + \[[#488](https://github.com/apache/logging-log4cxx/pull/488)\] +* TelnetAppender can now deliver messages when the socket is in a TIME_WAIT state + \[[#495](https://github.com/apache/logging-log4cxx/pull/495)\] + +The following issues have been addressed: + +* It was possible for logging events to be lost when reloading a configuration file + \[[#491](https://github.com/apache/logging-log4cxx/issues/491)\] + ## Release 1.4.0 - 2025-03-01 {#rel_1_4_0} Release 1.4.0 includes the following new features: diff --git a/src/site/markdown/download.md.in b/src/site/markdown/download.md.in index cc431282..07a4100b 100644 --- a/src/site/markdown/download.md.in +++ b/src/site/markdown/download.md.in @@ -56,6 +56,7 @@ in many unix distributions. | Version | Release Date | | :--------------------------: | :----------------------: | +| [1.4.0](${LOG4CXX_DOCUMENTATION_URL}/1.4.0/download.html) | Mar-2025 | | [1.3.1](${LOG4CXX_DOCUMENTATION_URL}/1.3.1/download.html) | Nov-2024 | | [1.2.0](${LOG4CXX_DOCUMENTATION_URL}/1.2.0/download.html) | Jan-2024 | | [1.1.0](${LOG4CXX_DOCUMENTATION_URL}/1.1.0/download.html) | May-2023 |