These constants have the correct value now

Add a warning about tagsets without a fallback


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@328539 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Hannes Magnusson 2012-11-28 18:05:53 +00:00
parent 9832636ca9
commit 6a0c2c3a7d

View file

@ -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>