--- nfo/php/libs/org.netfrag.glib/DataSource/Locator.php 2003/03/11 00:12:49 1.11 +++ nfo/php/libs/org.netfrag.glib/DataSource/Locator.php 2003/03/11 01:10:00 1.12 @@ -21,9 +21,12 @@ * Cvs-Log: * *
- * $Id: Locator.php,v 1.11 2003/03/11 00:12:49 joko Exp $
+ * $Id: Locator.php,v 1.12 2003/03/11 01:10:00 joko Exp $
  *
  * $Log: Locator.php,v $
+ * Revision 1.12  2003/03/11 01:10:00  joko
+ * + fixed metadata for phpDocumentor
+ *
  * Revision 1.11  2003/03/11 00:12:49  joko
  * + fixed metadata for phpDocumentor
  *
@@ -64,14 +67,18 @@
 /**
  * It helps DataSource::Generic working in different "operation modes".
  *
+ * 

+ *

+ *

* - * + *

* 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) @@ -88,14 +95,16 @@ * by the DataSource::Generic 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 * - builds a larger locator from a minimum of information passed in via constructor-arguments * - direct fallback mode to some predefined constant names if locator is empty and above method fails * - direct fallback mode to some predefined values if just *everything* fails + *

* - * + *

* How to use? * * Pass an array holding "locator metadata" to the constructor. @@ -122,6 +131,7 @@ * $source = ne w DataSource::Generic($locator); * $this->set_data_source( &$source ); * + *

* * * @@ -145,10 +155,11 @@ * using metadata from $_options and some * other presets. * - * @see function build, which acts as a dispatcher + * @see build, which acts as a dispatcher * depending on $_options[datasource]. * (main dispatching level) * + *
     * The structure of a full blown locator looks like this:
     *
     * 
@@ -179,6 +190,7 @@
     *    )
     *  );
     * 
+    * 
* * @deprecated *