[Kst] kdeextragear-2/kst/devel-docs

[George Staikos]

CVS commit by staikos: 

proposed changes to the update counter


  M +16 -0     updates.txt   1.5


--- kdeextragear-2/kst/devel-docs/updates.txt  #1.4:1.5
@@ -39,2 +39,18 @@
    - We won't add more threads yet but hope to do so in the future.
    - Painting continues to work as it does.  There is no reason to move it.
+
+- update counter:
+   - 0 is special, means "first update" - that's a forced one.  Never happens
+     after the first time.
+   - > 0 is a sequenced update.  Use the helper method in KstObject to
+     determine if you should update or not
+   - < 0 is a forced update.  It is still sequenced inline with the positive
+     updates.  Think of it as a one-bit flag set.  Use the usual test
+     mechanisms.
+
+   In a sense, this somewhat breaks behaviour from previous Kst versions for
+   data sources.  In the past, -1 was always used for "force".  This was not
+   particularly documented though, so I think it's OK.  Objections are welcome
+   in which case we have to come up with a different workaround.
+
+