[prev in list] [next in list] [prev in thread] [next in thread] 

List:       php-doc-cvs
Subject:    [DOC-CVS] =?utf-8?q?svn:_/phpdoc/en/trunk/reference/mongo/_readpreferences.xml?=
From:       Hannes_Magnusson <bjori () php ! net>
Date:       2012-11-28 18:05:53
Message-ID: svn-bjori-1354125953-328539-1083504566 () svn ! php ! net
[Download RAW message or body]

bjori                                    Wed, 28 Nov 2012 18:05:53 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=328539

Log:
These constants have the correct value now
Add a warning about tagsets without a fallback

Changed paths:
    U   phpdoc/en/trunk/reference/mongo/readpreferences.xml

Modified: phpdoc/en/trunk/reference/mongo/readpreferences.xml
===================================================================
--- phpdoc/en/trunk/reference/mongo/readpreferences.xml	2012-11-28 17:53:04 UTC (rev 328538)
+++ phpdoc/en/trunk/reference/mongo/readpreferences.xml	2012-11-28 18:05:53 UTC (rev 328539)
@@ -186,12 +186,8 @@
    for tag sets.
   </para>
   <para>
-   When specifying read preference modes in a query string, the names
-   <literal>primary</literal>, <literal>primaryPreferred</literal>,
-   <literal>secondary</literal>, <literal>secondaryPreferred</literal>, and
-   <literal>nearest</literal> should be used instead of the constants for the
-   <literal>readPreference</literal> value. Tag sets for the
-   <literal>readPreferenceTags</literal> value should be a comma-delimited
+   When specifying read preference modes in a query string, the Tag sets for
+   the <literal>readPreferenceTags</literal> value should be a comma-delimited
    sequence of colon-delimited key/value pairs.
   </para>
   <note>
@@ -203,6 +199,14 @@
     they appear in the query string.
    </para>
   </note>
+  <warning>
+   <para>
+    If the driver cannot find a matching TagSet the read will fail!  It is
+    your responsibility of providing suitable fallback, such as an empty
+    <literal>readPreferenceTags</literal> value to fallback to "no TagSet
+    preference".
+   </para>
+  </warning>
   <para>
    <example>
     <title>Connection URI read preferences with query string syntax</title>



-- 
PHP Documentation Commits Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

[prev in list] [next in list] [prev in thread] [next in thread]