[Babeldoc-devel] babeldoc/modules/core/src/com/babeldoc/core TieredConfigurationHelper.java,1.1,1.2

[<tr...@us...>]

Update of /cvsroot/babeldoc/babeldoc/modules/core/src/com/babeldoc/core
In directory sc8-pr-cvs1:/tmp/cvs-serv18992/core/src/com/babeldoc/core

Modified Files:
	TieredConfigurationHelper.java 
Log Message:
refactorings and meanderings.  Serious looking at the PipelineStageFactory to arrive a simplest yet most adequate interface to facilitate parallel execution of multiple pipeline stage results.

Index: TieredConfigurationHelper.java
===================================================================
RCS file: /cvsroot/babeldoc/babeldoc/modules/core/src/com/babeldoc/core/TieredConfigurationHelper.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** TieredConfigurationHelper.java	1 Jul 2003 12:48:07 -0000	1.1
--- TieredConfigurationHelper.java	16 Jul 2003 05:17:38 -0000	1.2
***************
*** 1,2 ****
--- 1,67 ----
+ /* ====================================================================
+  * The Apache Software License, Version 1.1
+  *
+  * Copyright (c) 2000 The Apache Software Foundation.  All rights
+  * reserved.
+  *
+  * Redistribution and use in source and binary forms, with or without
+  * modification, are permitted provided that the following conditions
+  * are met:
+  *
+  * 1. Redistributions of source code must retain the above copyright
+  *    notice, this list of conditions and the following disclaimer.
+  *
+  * 2. Redistributions in binary form must reproduce the above copyright
+  *    notice, this list of conditions and the following disclaimer in
+  *    the documentation and/or other materials provided with the
+  *    distribution.
+  *
+  * 3. The end-user documentation included with the redistribution,
+  *    if any, must include the following acknowledgment:
+  *       "This product includes software developed by the
+  *        Apache Software Foundation (http://www.apache.org/)."
+  *    Alternately, this acknowledgment may appear in the software itself,
+  *    if and wherever such third-party acknowledgments normally appear.
+  *
+  * 4. The names "Apache" and "Apache Software Foundation" must
+  *    not be used to endorse or promote products derived from this
+  *    software without prior written permission. For written
+  *    permission, please contact ap...@ap....
+  *
+  * 5. Products derived from this software may not be called "Apache",
+  *    nor may "Apache" appear in their name, without prior written
+  *    permission of the Apache Software Foundation.
+  *
+  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
+  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+  * SUCH DAMAGE.
+  * ====================================================================
+  *
+  * This software consists of voluntary contributions made by many
+  * individuals on behalf of the Apache Software Foundation.  For more
+  * information on the Apache Software Foundation, please see
+  * <http://www.apache.org/>.
+  *
+  * Portions of this software are based upon public domain software
+  * originally written at the National Center for Supercomputing Applications,
+  * University of Illinois, Urbana-Champaign.
+  * ====================================================================
+  *
+  * Babeldoc:  The Universal Document Processor
+  *
+  * $Header$
+  * $DateTime$
+  * $Author$
+  *
+  */
  package com.babeldoc.core;
  
***************
*** 6,9 ****
--- 71,77 ----
  
  /**
+  * The Tiered configuration helper assists when dealing with names (keys) in the
+  * configuration file that are separated by periods (.) that imply some kind of nesting
+  * or tiering.  This is used a lot in babeldoc.
   */
  public class TieredConfigurationHelper {
***************
*** 11,18 ****
--- 79,96 ----
    private Map configs;
  
+   /**
+    * Construct with a configuration object that has nested or tiered options.
+    *
+    * @param config
+    */
    public TieredConfigurationHelper(IConfig config) {
      this.config = config;
    }
  
+   /**
+    * Get the map of configuration values.
+    *
+    * @return
+    */
    public Map getNamedConfigs() {
      if(configs==null) {
***************
*** 22,25 ****
--- 100,107 ----
    }
  
+   /**
+    * Extract the nested configurations.  This is map that whose elements are either strings
+    * or maps of nested values or sub-maps (and so on).
+    */
    protected void extractedTieredConfigs() {
      configs = new HashMap();