[Telepathy-commits] [telepathy-spec/master] Tubes: Tube_Channel_State: how do you move from a state to another

[Alban Crequy]

---
 spec/Channel_Interface_Tube.xml |   16 ++++++++++++----
 1 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/spec/Channel_Interface_Tube.xml b/spec/Channel_Interface_Tube.xml
index b42a325..8f569c8 100644
--- a/spec/Channel_Interface_Tube.xml
+++ b/spec/Channel_Interface_Tube.xml
@@ -77,22 +77,30 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
     <tp:enum name="Tube_Channel_State" type="u">
       <tp:enumvalue suffix="Local_Pending" value="0">
         <tp:docstring>
-          The tube is waiting to be accepted/closed locally.
+          The initiator offered the tube. The tube is waiting to be
+          accepted/closed locally. If the client accepts the tube, the tube's
+          state will be Open.
         </tp:docstring>
       </tp:enumvalue>
       <tp:enumvalue suffix="Remote_Pending" value="1">
         <tp:docstring>
-          The tube is waiting to be accepted/closed remotely.
+          The tube is waiting to be accepted/closed remotely. If the
+          recipient accepts the tube, the tube's state will be Open.
         </tp:docstring>
       </tp:enumvalue>
       <tp:enumvalue suffix="Open" value="2">
         <tp:docstring>
-          The tube is open for traffic.
+          The initiator offered the tube and the recipient accepted it. The
+          tube is open for traffic. The tube's state stays in this state until
+          it is closed.
         </tp:docstring>
       </tp:enumvalue>
       <tp:enumvalue suffix="Not_Offered" value="3">
         <tp:docstring>
-          The tube is not yet offered.
+          The tube channel has been requested but the tube is not yet offered.
+          The client should offer the tube to the recipient and the tube's
+          state will be Remote_Pending. The method to offer the tube depend on
+          the tube type.
         </tp:docstring>
       </tp:enumvalue>
     </tp:enum>
-- 
1.5.6.5