--- nfo/php/libs/org.netfrag.glib/DataSource/Locator.php	2003/03/05 12:04:37	1.1
+++ nfo/php/libs/org.netfrag.glib/DataSource/Locator.php	2003/03/05 15:01:10	1.2
@@ -1,8 +1,7 @@
 <?php
 /**
- * --- @about
- *
  * This file contains the DataSource::Locator class.
+ *
  * It acts as a container for DataSource connection 
  * metadata. Think of it as an enhanced dsn.
  *
@@ -11,16 +10,18 @@
  * has to do.
  *
  *
- * @author Andreas Motl <andreas.motl@ilo.de>
  * @package org.netfrag.glib
  * @module DataSource::Locator
  *
  */
 
 /**
- * $Id: Locator.php,v 1.1 2003/03/05 12:04:37 joko Exp $
+ * $Id: Locator.php,v 1.2 2003/03/05 15:01:10 joko Exp $
  *
  * $Log: Locator.php,v $
+ * Revision 1.2  2003/03/05 15:01:10  joko
+ * updated docu
+ *
  * Revision 1.1  2003/03/05 12:04:37  joko
  * + initial commit
  *
@@ -28,9 +29,7 @@
  */
 
 /**
- * --- @description
- *
- * --- It helps GenericDataSource working in different "operation modes".
+ * It helps GenericDataSource working in different "operation modes".
  *
  *    o Pass-Through-Reference: php Object will get passed through all layers
  *    o Pass-Through-Memory: reference to a memory area will get used
@@ -40,22 +39,22 @@
  *    o Build-AutoLocator: use global constants making up our metadata
  *
  *
- * --- It can/should contain (flexible, just some parameters are required for each operation mode)
+ * It can/should contain (flexible, just some parameters are required for each operation mode)
  *
- *    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)
- *    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)
- *    x 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 GenericDataSource at runtime
- *    x an adapter-type (of 'phpHtmlLib|pear')
- *        this will be mapped to a module name and used as an *Adapter*
- *        by the GenericDataSource at runtime
- *    o names of global constants where to find these informations
- *    o datasource-type ('rpc|csv-file|...') <-> datasource-family ('orm|rdbms|odbms')
+ * o 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
+ *   (e.g. DataSource::Proxy::XMLRPC via DesignPattern::RemoteProxy)
+ * + 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')
+ *   this will be mapped to a module name and used as a *Proxy* 
+ *   by the GenericDataSource at runtime
+ * + an adapter-type (of 'phpHtmlLib|pear')
+ *   this will be mapped to a module name and used as an *Adapter*
+ *   by the GenericDataSource at runtime
+ * o names of global constants where to find these informations
+ * o datasource-type ('rpc|csv-file|...') <-> datasource-family ('orm|rdbms|odbms')
  *
  *
  * --- It can do
@@ -90,15 +89,15 @@
  *
  *
  * @author Andreas Motl <andreas.motl@ilo.de>
+ * @link http://www.netfrag.org/~joko/
  * @copyright (c) 2003 - All Rights reserved.
- * @license GNU LGPL (GNU Lesser General Public License)
  *
- * @author-url http://www.netfrag.org/~joko/
- * @license-url http://www.gnu.org/licenses/lgpl.txt
+ * @license GNU LGPL (GNU Lesser General Public License)
+ * @link http://www.gnu.org/licenses/lgpl.txt
  *
- * @author Andreas Motl <andreas.motl@ilo.de>
- * @package org.netfrag.glib
- * @module DataSource::Locator
+ * @subpackage DataSource
+ * @name DataSource::Locator
+ * @filesource
  *
  */