(logging-log4cxx) branch explain_configuration_file_benefits created (now 56acb439)

[sw...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

swebb2066 pushed a change to branch explain_configuration_file_benefits
in repository https://gitbox.apache.org/repos/asf/logging-log4cxx.git


      at 56acb439 Explain configuration file benefits in the web-site information

This branch includes the following new commits:

     new 56acb439 Explain configuration file benefits in the web-site information

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.

(logging-log4cxx) 01/01: Explain configuration file benefits in the web-site information

[sw...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

swebb2066 pushed a commit to branch explain_configuration_file_benefits
in repository https://gitbox.apache.org/repos/asf/logging-log4cxx.git

commit 56acb4398d57a339c9cbfd8cf5f1e2a7be536a4c
Author: Stephen Webb <sw...@gmail.com>
AuthorDate: Sun Sep 14 11:03:58 2025 +1000

    Explain configuration file benefits in the web-site information
---
 src/site/markdown/configuration-samples.md | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/src/site/markdown/configuration-samples.md b/src/site/markdown/configuration-samples.md
index c1eb08e6..416f9f99 100644
--- a/src/site/markdown/configuration-samples.md
+++ b/src/site/markdown/configuration-samples.md
@@ -22,20 +22,25 @@ Configuration Files {#configuration-files}
 -->
 
 [TOC]
+Configuring Log4cxx by loading a file allows you to
+specify the instantiated appender/layout/filter classes and
+the properties of those class instances
+without recompiling and rebuilding.
 
 As Log4cxx was designed to be extendable,
-option names are not constrained by the core library.
+property names and values are not constrained by the core library.
 The configuration file parsers,
 [DOMConfigurator](@ref log4cxx.xml.DOMConfigurator) and
 [PropertyConfigurator](@ref log4cxx.PropertyConfigurator),
 just send the key/value pair to an instance of
 the named appender/layout/filter class.
 Refer to the [setOption method documentation](@ref log4cxx::spi::OptionHandler::setOption)
-for configurable option names and supported values.
-Note that a base class may implement some options
+for configurable property names and supported values.
+Note that a base class may implement some properties
 while the concrete class implements others.
 Check the full class hierarchy when looking
-for a configuration option.
+for the configurable property names
+and the supported values.
 
 # Default Initialization Behaviour {#default-initialization}