Doc updates.

Original commit message from CVS:
* docs/design/part-MT-refcounting.txt:
* docs/design/part-clocks.txt:
* docs/design/part-gstelement.txt:
* docs/design/part-gstobject.txt:
* docs/design/part-standards.txt:
* gst/gstbin.c: (gst_bin_add_func), (gst_bin_add),
(gst_bin_remove_func), (gst_bin_remove):
* gst/gstbin.h:
* gst/gstbuffer.c:
* gst/gstcaps.h:
* testsuite/clock/clock1.c: (main):
* testsuite/clock/clock2.c: (gst_clock_debug), (element_wait),
(main):
* testsuite/dlopen/loadgst.c: (do_test):
* testsuite/refcounting/bin.c: (add_remove_test1),
(add_remove_test2), (main):
* testsuite/refcounting/element.c: (main):
* testsuite/refcounting/element_pad.c: (main):
* testsuite/refcounting/pad.c: (main):
* tools/gst-launch.c: (sigint_handler_sighandler):
* tools/gst-typefind.c: (main):
Doc updates.
Added doc about clock.
removed gst_bin_iterate_recurse_up(), marked methods
for removal.
Fix more testsuites.

1 files changed, 9 insertions, 0 deletions

diff --git a/docs/design/part-MT-refcounting.txt b/docs/design/part-MT-refcounting.txt
index 3d45064ec1..27654dc454 100644
--- a/docs/design/part-MT-refcounting.txt
+++ b/docs/design/part-MT-refcounting.txt
@@ -123,6 +123,15 @@ Atomic operations
   Atomic operations are generally used for refcounting and for the allocation of
   small fixed size objects in a memchunk. They can also be used to implement a
   lockfree list or stack.
+
+Compare and swap
+
+  As part of the atomic operations, compare-and-swap (CAS) can be used to access
+  or update a single property or pointer in an object without having to take a
+  lock.
+
+  This technique is currently not used in GStreamer but might be added in the
+  future in performance critical places.
  
 
 Objects