--- nfo/php/libs/org.netfrag.glib/DataSource/Locator.php	2003/03/05 16:10:08	1.6
+++ nfo/php/libs/org.netfrag.glib/DataSource/Locator.php	2003/03/05 17:13:16	1.7
@@ -9,17 +9,21 @@
  * to be informed about the most important stuff it
  * has to do.
  *
- *
  * @author Andreas Motl <andreas.motl@ilo.de>
  * @package org.netfrag.glib
- * @module DataSource::Locator
+ * @name DataSource::Locator
+ * @filesource
  *
- */
-
-/**
- * $Id: Locator.php,v 1.6 2003/03/05 16:10:08 joko Exp $
+ *
+ * <b>Cvs-Log:</b>
+ *
+ * <pre>
+ * $Id: Locator.php,v 1.7 2003/03/05 17:13:16 joko Exp $
  *
  * $Log: Locator.php,v $
+ * Revision 1.7  2003/03/05 17:13:16  joko
+ * updated docu (phpDocumentor testing....)
+ *
  * Revision 1.6  2003/03/05 16:10:08  joko
  * updated docu (phpDocumentor testing....)
  *
@@ -37,6 +41,7 @@
  *
  * Revision 1.1  2003/03/05 12:04:37  joko
  * + initial commit
+ * </pre>
  *
  *
  */
@@ -44,38 +49,42 @@
 /**
  * It helps DataSource::Generic working in different "operation modes".
  *
- * - Pass-Through-Reference: php Object will get passed through all layers
- * - Pass-Through-Memory: reference to a memory area will get used
- * + Build-Locator: build locator from datasource-type and adapter-type
- * - Use-Locator: directly use DataSource::Locator instance passed in
- * - Merge-Locators: merge metadata of two or more DataSource::Locator instances
- * - Build-AutoLocator: use global constants making up our metadata
+ * <ul>
+ * o Pass-Through-Reference: php Object will get passed through all layers
+ * o Pass-Through-Memory: reference to a memory area will get used
+ * x Build-Locator: build locator from datasource-type and adapter-type
+ * o Use-Locator: directly use DataSource::Locator instance passed in
+ * o Merge-Locators: merge metadata of two or more DataSource::Locator instances
+ * o Build-AutoLocator: use global constants making up our metadata
+ * </ul>
  *
- * <b>It can/should contain:</b>
  *
- * <pre>
+ * <b>It can/should contain:</b>
  * (flexible, just some parameters are required for each operation mode)
- * - an oldschool "dsn"-string (e.g. for rdbms-connection via PEAR)
- * + name of a Proxy module to use to *wrap/hide* the connection/transport-layer
+ * <ul>
+ * o an oldschool "dsn"-string (e.g. for rdbms-connection via PEAR)
+ * x name of a Proxy module to use to *wrap/hide* the connection/transport-layer
  *   (e.g. DataSource::Proxy::XMLRPC via DesignPattern::RemoteProxy)
- * + metadata (a hash) directly describing *where* to connect to (e.g. 'Host', 'Port')
- * - an instance of an already instantiated arbitrary datasource handler (e.g. 'source')
+ * x metadata (a hash) directly describing *where* to connect to (e.g. 'Host', 'Port')
+ * o an instance of an already instantiated arbitrary datasource handler (e.g. 'source')
  *   this will get propagated (pass-through-mode)
- * - a datasource-type (of 'rpc|mysql|csv-file|xml-file')
+ * o a datasource-type (of 'rpc|mysql|csv-file|xml-file')
  *   this will be mapped to a module name and used as a *Proxy* 
  *   by the DataSource::Generic at runtime
- * + an adapter-type (of 'phpHtmlLib|pear')
+ * x an adapter-type (of 'phpHtmlLib|pear')
  *   this will be mapped to a module name and used as an *Adapter*
  *   by the DataSource::Generic at runtime
- * - names of global constants where to find these informations
- * - datasource-type ('rpc|csv-file|...') <-> datasource-family ('orm|rdbms|odbms')
- * </pre>
+ * o names of global constants where to find these informations
+ * o datasource-type ('rpc|csv-file|...') <-> datasource-family ('orm|rdbms|odbms')
+ * </ul>
  *
  *
  * <b>It can do</b>
- * + builds a larger locator from a minimum of information passed in via constructor-arguments
+ * <ul>
+ * # builds a larger locator from a minimum of information passed in via constructor-arguments
  * o direct fallback mode to some predefined constant names if locator is empty and above method fails
  * o direct fallback mode to some predefined values if just *everything* fails
+ * </ul>
  *
  *
  * <b>How to use?</b>
@@ -114,12 +123,11 @@
  * @license GNU LGPL (GNU Lesser General Public License)
  * @link http://www.gnu.org/licenses/lgpl.txt
  *
+ * @package org.netfrag.glib
+ * @subpackage DataSource
  * @name DataSource::Locator
- * @filesource
  *
  */
-
-
 class DataSource_Locator {
 
   /**