Doc: Describe general rules for reentrancy

diff --git a/ucw/THREADS b/ucw/THREADS
deleted file mode 100644 (file)
index ec58d49..0000000
--- a/ucw/THREADS
+++ /dev/null
@@ -1,7 +0,0 @@
-Generally, functions in the UCW library are reentrant as long as you call them
-on different data. Calling on the same object is not, unless otherwise told,
-which also includes functions acting on any kind of global state.
-
-There are some exceptions:
-
-- setproctitle() is not safe, it modifies global state

diff --git a/ucw/doc/basics.txt b/ucw/doc/basics.txt
index 42f009778e1ce3f06f0911f6fccf3536068dbcd5..8cc5414f579fbfe4d77c5c6e8b16576a9c9d0686 100644 (file)
--- a/ucw/doc/basics.txt
+++ b/ucw/doc/basics.txt
@@ -19,6 +19,12 @@ on Darwin, too. The authors did not try using it on other systems, but most of
 the code is written for a generic POSIX system, so porting to any UNIX-like system
 should be a piece of cake.
 
+Threads
+-------
+Generally, functions in the UCW library are reentrant as long as you call them
+on different data. Accessing the same object from different threads is not supported,
+unless otherwise told. This also applies to functions acting on any kind of global state.
+
 ucw/lib.h
 ---------
 *Only partially documented.*