From d1e6df1356c6851115561df095830a3910ddd2f7 Mon Sep 17 00:00:00 2001
From: Dave Renshaw <dsr@php.net>
Date: Wed, 7 Feb 2007 10:29:24 +0000
Subject: [PATCH] *** empty log message ***

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@229256 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/sam/constants.xml                        |  4 ++--
 reference/sam/functions/SAM-Connection-connect.xml | 14 +++++++++-----
 reference/sam/reference.xml                        |  6 +++---
 3 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/reference/sam/constants.xml b/reference/sam/constants.xml
index e1cc170a76..1094401d52 100644
--- a/reference/sam/constants.xml
+++ b/reference/sam/constants.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <section id="mq.constants">
  &reftitle.constants;
  &extension.constants;
@@ -187,7 +187,7 @@
   <varlistentry>
    <term>
     <constant>SAM_MQTT_CLEANSTART</constant>
-     (<type>string</type>)
+     (<type>bool</type>)
    </term>
    <listitem>
     <simpara>
diff --git a/reference/sam/functions/SAM-Connection-connect.xml b/reference/sam/functions/SAM-Connection-connect.xml
index 728912471f..3c2370e178 100644
--- a/reference/sam/functions/SAM-Connection-connect.xml
+++ b/reference/sam/functions/SAM-Connection-connect.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id='function.samconnection-connect'>
  <refnamediv>
   <refname>SAMConnection->connect()</refname>
@@ -134,8 +134,9 @@
              </row>
              <row>
                <entry>SAM_PORT</entry>
-               <entry>1414 for SAM_WMQ
-                or 1506 for SAM_WPM
+               <entry>1414 for SAM_WMQ,
+                1506 for SAM_WPM,
+                or 1883 for SAM_MQTT
                </entry>
                <entry>
                 The port number on which to attempt communication with the messaging server.
@@ -166,11 +167,14 @@
              </row>
              <row>
                <entry>SAM_MQTT_CLEANSTART</entry>
-               <entry>none</entry>
+               <entry>false</entry>
                <entry>
                 Optional connect option to indicate to an MQTT server that all previous connection data
                 for this client should be removed and that subscriptions should be deleted when the client
-                disconnects explicitly or unexpectedly.
+                disconnects explicitly or unexpectedly. Setting the value to &true causes SAM to discard
+                any subscription already in place for the client when it connects and also to discard
+                subscription when the client disconnects. Setting the option to &false, or using the
+                default, allows subscriptions to be durable and survive across client disconnects.
                </entry>
              </row>
              <row>
diff --git a/reference/sam/reference.xml b/reference/sam/reference.xml
index ad0b23f4c6..06e2333dc9 100644
--- a/reference/sam/reference.xml
+++ b/reference/sam/reference.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
  <reference id="ref.sam">
   <title>SAM - Simple Asynchronous Messaging</title>
   <titleabbrev>SAM</titleabbrev>
@@ -308,12 +308,12 @@ sam.factory.wmq=xms
 sam.factory.wmq:client=xms
 sam.factory.wmq:bindings=xms
 sam.factory.wpm=xms
-sam.factory.wrtt=xms
+sam.factory.rtt=xms
 ]]>
       </screen>
 As can be seen from these examples the entries take the form of "sam.factory.pppp=xxx" where pppp is the protocol
 string specified on the connect call and xxx is a factory suffix.  Note: SAM defines constants for these protocol
-strings such that SAM_WMQ=wmq, SAM_WPM=wpm, SAM_MQTT=mqtt, etc.
+strings such that SAM_WMQ=wmq, SAM_WPM=wpm, SAM_RTT=rtt, SAM_MQTT=mqtt, etc.
       </para>
       <para>
 When identifying the support code to use on a connect call SAM looks up the protocol name in the &php.ini; entries