BIND 10 trac2856, updated. d9b56777aaa3a4e70c9b80ecde1b69aab30cb0ee [2856] Include the state transition diagram

[BIND 10 source code commits]

The branch, trac2856 has been updated
       via  d9b56777aaa3a4e70c9b80ecde1b69aab30cb0ee (commit)
      from  7027266480db82481529f3680c506a23289ea460 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit d9b56777aaa3a4e70c9b80ecde1b69aab30cb0ee
Author: Mukund Sivaraman <muks at isc.org>
Date:   Thu Jul 11 14:47:08 2013 +0530

    [2856] Include the state transition diagram

-----------------------------------------------------------------------

Summary of changes:
 src/lib/python/isc/memmgr/datasrc_info.py |   17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

-----------------------------------------------------------------------
diff --git a/src/lib/python/isc/memmgr/datasrc_info.py b/src/lib/python/isc/memmgr/datasrc_info.py
index 2846302..61b6474 100644
--- a/src/lib/python/isc/memmgr/datasrc_info.py
+++ b/src/lib/python/isc/memmgr/datasrc_info.py
@@ -33,10 +33,17 @@ class SegmentInfo:
     segment-type specific details.  Such details are expected to be
     delegated to subclasses corresponding to specific types of segments.
 
-    The implementation is still incomplete.  It will have more attributes
-    such as a set of current readers, methods for adding or deleting
-    the readers.  These will probably be implemented in this base class
-    as they will be independent from segment-type specific details.
+    A summarized (and simplified) state transition diagram (for __state)
+    would be as follows:
+                                                +--sync_reader()/remove_reader()
+                                                |  still have old readers
+                                                |          |
+                UPDATING-----complete_--->SYNCHRONIZING<---+
+                  ^          update()           |
+    start_update()|                             | sync_reader()/remove_reader()
+    events        |                             V no more old reader
+    exist       READY<------complete_----------COPYING
+                            update()
 
     """
     # Common constants of user type: reader or writer
@@ -57,6 +64,8 @@ class SegmentInfo:
               # handle further updates (e.g., from xfrin).
 
     def __init__(self):
+        # Holds the state of SegmentInfo. See the class description
+        # above for the state transition diagram.
         self.__state = self.READY
         # __readers is a set of 'reader_session_id' private to
         # SegmentInfo. It consists of the (ID of) reader modules that