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 103ceb64 Explain configuration file benefits in the web-site
information (#538)
103ceb64 is described below
commit 103ceb644b923b277fb8db928c7c22785167f89f
Author: Stephen Webb <[email protected]>
AuthorDate: Mon Sep 15 12:59:56 2025 +1000
Explain configuration file benefits in the web-site information (#538)
---
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}
