<commit_before><?xml version="1.0"?>
<!--
   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You under the Apache License, Version 2.0
   (the "License"); you may not use this file except in compliance with
   the License.  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
-->

<document>

 <properties>
  <title>Commons Configuration User's Guide</title>
  <author email="<EMAIL>"><NAME></author>
 </properties>

<body>

    <section name="About this document">
		<p>
 	 		This document describes the features of the Commons Configuration
            component starting with the very basics and up to the more advanced
            topics. If you read it in a linear way, you should get a sound
            understanding of the provided classes and the possibilities they
            offer. But you can also skip sections and jump directly to the topics
            you are most interested in.
    	</p>
        <p>
            Note that many features described in this guide are only available
            since the 1.3 release of Commons Configuration. If you are using
            a 1.2 version, have a look at the older
            <a href="../userguide-1.2/index.html">Howtos</a> documents, which specifically
            deal with this version.
        </p>
    </section>

	<section name="Table of contents">
    <ul>
      <li><a href="overview.html#Using_Configuration">Using Configuration</a></li>
      <ul>
        <li><a href="overview.html#Configuration_Sources">Configuration Sources</a></li>
        <li><a href="overview.html#Mixing_Configuration_Sources">Mixing Configuration Sources</a></li>
        <li><a href="overview.html#The_Configuration_interface">The Configuration interface</a></li>
        <li><a href="overview.html#Threading_issues">Threading issues</a></li>
      </ul>
      <li><a href="howto_basicfeatures.html#Basic_features_and_AbstractConfiguration">Basic features and AbstractConfiguration</a></li>
      <ul>
        <li><a href="howto_basicfeatures.html#Handling_of_missing_properties">Handling of missing properties</a></li>
        <li><a href="howto_basicfeatures.html#List_handling">List handling</a></li>
        <li><a href="howto_basicfeatures.html#Variable_Interpolation">Variable Interpolation</a></li>
        <li><a href="howto_basicfeatures.html#Customizing_interpolation">Customizing interpolation</a></li>
      </ul>
      <li><a href="howto_properties.html#Properties_files">Properties files</a></li>
      <ul>
        <li><a href="howto_properties.html#Using_PropertiesConfiguration">Using PropertiesConfiguration</a></li>
        <li><a href="howto_properties.html#Includes">Includes</a></li>
        <li><a href="howto_properties.html#Lists_and_arrays">Lists and arrays</a></li>
        <li><a href="howto_properties.html#Saving">Saving</a></li>
        <li><a href="howto_properties.html#Special_Characters_and_Escaping">Special Characters and Escaping</a></li>
        <li><a href="howto_properties.html#Layout_Objects">Layout Objects</a></li>
        <li><a href="howto_properties.html#Custom_properties_readers_and_writers">Custom properties readers and writers</a></li>
      </ul>
      <li><a href="howto_filebased.html#File-based_Configurations">File-based Configurations</a></li>
      <ul>
        <li><a href="howto_filebased.html#Specifying_the_file">Specifying the file</a></li>
        <li><a href="howto_filebased.html#Loading">Loading</a></li>
        <li><a href="howto_filebased.html#Saving">Saving</a></li>
        <li><a href="howto_filebased.html#Automatic_Saving">Automatic Saving</a></li>
        <li><a href="howto_filebased.html#Automatic_Reloading">Automatic Reloading</a></li>
      </ul>
      <li><a href="howto_xml.html#Hierarchical_properties">Hierarchical properties</a></li>
      <ul>
        <li><a href="howto_xml.html#Accessing_properties_in_hierarchical_configurations">Accessing properties in hierarchical configurations</a></li>
        <li><a href="howto_xml.html#Complex_hierarchical_structures">Complex hierarchical structures</a></li>
        <li><a href="howto_xml.html#Accessing_structured_properties">Accessing structured properties</a></li>
        <li><a href="howto_xml.html#Adding_new_properties">Adding new properties</a></li>
        <li><a href="howto_xml.html#Escaping_special_characters">Escaping dot characters in property names</a></li>
        <li><a href="howto_xml.html#Expression_engines">Expression engines</a></li>
        <ul>
          <li><a href="howto_xml.html#The_default_expression_engine">The default expression engine</a></li>
          <li><a href="howto_xml.html#The_XPATH_expression_engine">The XPATH expression engine</a></li>
        </ul>
        <li><a href="howto_xml.html#Validation_of_XML_configuration_files">Validation of XML configuration files</a></li>
      </ul>
      <li><a href="howto_compositeconfiguration.html#Composite_Configuration_Details">Composite Configuration Details</a></li>
      <ul>
        <li><a href="howto_compositeconfiguration.html#Setting_Up_Defaults">Setting Up Defaults</a></li>
        <li><a href="howto_compositeconfiguration.html#Saving_Changes">Saving Changes</a></li>
      </ul>
      <li><a href="howto_combinedconfiguration.html#Combined_Configuration">Combined Configuration</a></li>
      <ul>
        <li><a href="howto_combinedconfiguration.html#How_it_works">How it works</a></li>
        <li><a href="howto_combinedconfiguration.html#Node_combiners">Node combiners</a></li>
        <li><a href="howto_combinedconfiguration.html#Constructing_a_CombinedConfiguration">Constructing a CombinedConfiguration</a></li>
        <li><a href="howto_combinedconfiguration.html#Dealing_with_changes">Dealing with changes</a></li>
      </ul>
      <li><a href="howto_beans.html#Declaring_and_Creating_Beans">Declaring and Creating Beans</a></li>
      <ul>
        <li><a href="howto_beans.html#Basic_Concepts">Basic Concepts</a></li>
        <li><a href="howto_beans.html#An_Example">An Example</a></li>
        <li><a href="howto_beans.html#Extending_the_Basic_Mechanism">Extending the Basic Mechanism</a></li>
      </ul>
      <li><a href="howto_configurationfactory.html#Using_a_Configuration_Factory">Using a Configuration Factory</a></li>
      <ul>
        <li><a href="howto_configurationfactory.html#The_configuration_definition_file">The configuration definition file</a></li>
        <li><a href="howto_configurationfactory.html#Setting_up_a_ConfigurationFactory">Setting up a ConfigurationFactory</a></li>
        <li><a href="howto_configurationfactory.html#Accessing_properties">Accessing properties</a></li>
        <li><a href="howto_configurationfactory.html#Multiple_configuration_sources">Multiple configuration sources</a></li>
        <ul>
          <li><a href="howto_configurationfactory.html#Overriding_properties">Overriding properties</a></li>
          <li><a href="howto_configurationfactory.html#Optional_configuration_sources">Optional configuration sources</a></li>
        </ul>
        <li><a href="howto_configurationfactory.html#Union_configuration">Union configuration</a></li>
        <li><a href="howto_configurationfactory.html#Configuration_definition_file_reference">Configuration definition file reference</a></li>
        <ul>
          <li><a href="howto_configurationfactory.html#Setting_further_options">Setting further options</a></li>
          <li><a href="howto_configurationfactory.html#Referencing_system_properties">Referencing system properties</a></li>
        </ul>
      </ul>
      <li><a href="howto_configurationbuilder.html#Using_DefaultConfigurationBuilder">Using DefaultConfigurationBuilder</a></li>
      <ul>
        <li><a href="howto_configurationbuilder.html#Differences_to_ConfigurationFactory">Differences to ConfigurationFactory</a></li>
        <li><a href="howto_configurationbuilder.html#Enhancements_of_the_configuration_definition_file">Enhancements of the configuration definition file</a></li>
        <li><a href="howto_configurationbuilder.html#An_example">An example</a></li>
        <li><a href="howto_configurationbuilder.html#Extending_the_configuration_definition_file_format">Extending the configuration definition file format</a></li><commit_msg>[CONFIGURATION-459] Updated TOC of user guide.<commit_after><?xml version="1.0"?>
<!--
   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You under the Apache License, Version 2.0
   (the "License"); you may not use this file except in compliance with
   the License.  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
-->
<!-- $Id$ -->

<document>

 <properties>
  <title>Commons Configuration User's Guide</title>
 </properties>

<body>

    <section name="About this document">
		<p>
 	 		This document describes the features of the Commons Configuration
            component starting with the very basics and up to the more advanced
            topics. If you read it in a linear way, you should get a sound
            understanding of the provided classes and the possibilities they
            offer. But you can also skip sections and jump directly to the topics
            you are most interested in.
    	</p>
    </section>

	<section name="Table of contents">
    <ul>
      <li><a href="overview.html#Using_Configuration">Using Configuration</a></li>
      <ul>
        <li><a href="overview.html#Configuration_Sources">Configuration Sources</a></li>
        <li><a href="overview.html#Mixing_Configuration_Sources">Mixing Configuration Sources</a></li>
        <li><a href="overview.html#The_Configuration_interface">The Configuration interface</a></li>
        <li><a href="overview.html#Threading_issues">Threading issues</a></li>
      </ul>
      <li><a href="howto_basicfeatures.html#Basic_features_and_AbstractConfiguration">Basic features and AbstractConfiguration</a></li>
      <ul>
        <li><a href="howto_basicfeatures.html#Handling_of_missing_properties">Handling of missing properties</a></li>
        <li><a href="howto_basicfeatures.html#List_handling">List handling</a></li>
        <li><a href="howto_basicfeatures.html#Variable_Interpolation">Variable Interpolation</a></li>
        <li><a href="howto_basicfeatures.html#Customizing_interpolation">Customizing interpolation</a></li>
      </ul>
      <li><a href="howto_properties.html#Properties_files">Properties files</a></li>
      <ul>
        <li><a href="howto_properties.html#Using_PropertiesConfiguration">Using PropertiesConfiguration</a></li>
        <li><a href="howto_properties.html#Includes">Includes</a></li>
        <li><a href="howto_properties.html#Lists_and_arrays">Lists and arrays</a></li>
        <li><a href="howto_properties.html#Saving">Saving</a></li>
        <li><a href="howto_properties.html#Special_Characters_and_Escaping">Special Characters and Escaping</a></li>
        <li><a href="howto_properties.html#Layout_Objects">Layout Objects</a></li>
        <li><a href="howto_properties.html#Custom_properties_readers_and_writers">Custom properties readers and writers</a></li>
      </ul>
      <li><a href="howto_filebased.html#File-based_Configurations">File-based Configurations</a></li>
      <ul>
        <li><a href="howto_filebased.html#Specifying_the_file">Specifying the file</a></li>
        <li><a href="howto_filebased.html#Loading">Loading</a></li>
        <li><a href="howto_filebased.html#Saving">Saving</a></li>
        <li><a href="howto_filebased.html#Automatic_Saving">Automatic Saving</a></li>
        <li><a href="howto_filebased.html#Automatic_Reloading">Automatic Reloading</a></li>
      </ul>
      <li><a href="howto_xml.html#Hierarchical_properties">Hierarchical properties</a></li>
      <ul>
        <li><a href="howto_xml.html#Accessing_properties_in_hierarchical_configurations">Accessing properties in hierarchical configurations</a></li>
        <li><a href="howto_xml.html#Complex_hierarchical_structures">Complex hierarchical structures</a></li>
        <li><a href="howto_xml.html#Accessing_structured_properties">Accessing structured properties</a></li>
        <li><a href="howto_xml.html#Adding_new_properties">Adding new properties</a></li>
        <li><a href="howto_xml.html#Escaping_special_characters">Escaping dot characters in property names</a></li>
        <li><a href="howto_xml.html#Expression_engines">Expression engines</a></li>
        <ul>
          <li><a href="howto_xml.html#The_default_expression_engine">The default expression engine</a></li>
          <li><a href="howto_xml.html#The_XPATH_expression_engine">The XPATH expression engine</a></li>
        </ul>
        <li><a href="howto_xml.html#Validation_of_XML_configuration_files">Validation of XML configuration files</a></li>
      </ul>
      <li><a href="howto_compositeconfiguration.html#Composite_Configuration_Details">Composite Configuration Details</a></li>
      <ul>
        <li><a href="howto_compositeconfiguration.html#Setting_Up_Defaults">Setting Up Defaults</a></li>
        <li><a href="howto_compositeconfiguration.html#Saving_Changes">Saving Changes</a></li>
      </ul>
      <li><a href="howto_combinedconfiguration.html#Combined_Configuration">Combined Configuration</a></li>
      <ul>
        <li><a href="howto_combinedconfiguration.html#How_it_works">How it works</a></li>
        <li><a href="howto_combinedconfiguration.html#Node_combiners">Node combiners</a></li>
        <li><a href="howto_combinedconfiguration.html#Constructing_a_CombinedConfiguration">Constructing a CombinedConfiguration</a></li>
        <li><a href="howto_combinedconfiguration.html#Dealing_with_changes">Dealing with changes</a></li>
      </ul>
      <li><a href="howto_beans.html#Declaring_and_Creating_Beans">Declaring and Creating Beans</a></li>
      <ul>
        <li><a href="howto_beans.html#Basic_Concepts">Basic Concepts</a></li>
        <li><a href="howto_beans.html#An_Example">An Example</a></li>
        <li><a href="howto_beans.html#Extending_the_Basic_Mechanism">Extending the Basic Mechanism</a></li>
      </ul>
      <li><a href="howto_configurationbuilder.html#Using_DefaultConfigurationBuilder">Using DefaultConfigurationBuilder</a></li>
      <ul>
        <li><a href="howto_configurationbuilder.html#The_configuration_definition_file">The configuration definition file</a></li>
        <li><a href="howto_configurationbuilder.html#Setting_up_a_DefaultConfigurationBuilder">Setting up a ConfigurationFactory</a></li>
        <li><a href="howto_configurationbuilder.html#Overriding_properties">Overriding properties</a></li>
        <li><a href="howto_configurationbuilder.html#Optional_configuration_sources">Optional configuration sources</a></li>
        <li><a href="howto_configurationbuilder.html#Union_configuration">Union configuration</a></li>
        <li><a href="howto_configurationbuilder.html#Configuration_definition_file_reference">Configuration definition file reference</a></li>
        <li><a href="howto_configurationbuilder.html#An_example">An example</a></li>
        <li><a href="howto_configurationbuilder.html#Extending_the_configuration_definition_file_format">Extending the configuration definition file format</a></li>
{'fraction_non_alphanumeric': 0.12868054700012319, 'fraction_numerical': 0.001293581372428237, 'mean_word_length': 4.522108843537415, 'pattern_counts': {'":': 0, '<': 552, '<?xml version=': 2, '>': 552, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 22}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '235769', 'n_tokens_mistral': 4739, 'n_tokens_neox': 4662, 'n_words': 938}