--- parser3/src/include/pa_threads.h	2001/01/29 11:17:49	1.1
+++ parser3/src/include/pa_threads.h	2026/04/25 13:38:46	1.40
@@ -1,37 +1,69 @@
-/*
-  $Id: pa_threads.h,v 1.1 2001/01/29 11:17:49 paf Exp $
+/** @file
+	Parser: mutex & helpers decls.
+
+	Copyright (c) 2001-2026 Art. Lebedev Studio (https://www.artlebedev.com)
+	Authors: Konstantin Morshnev <moko@design.ru>, Alexandr Petrosian <paf@design.ru>
 */
 
 #ifndef PA_THREADS_H
 #define PA_THREADS_H
 
-#ifdef HAVE_CONFIG_H
-#	include "pa_config.h"
-#endif
+#define IDENT_PA_THREADS_H "$Id: pa_threads.h,v 1.40 2026/04/25 13:38:46 moko Exp $"
 
+#include "pa_config_includes.h"
 #include "pa_types.h"
 
+#ifdef _MSC_VER
+#include <windows.h>
+#endif
+
+/// get caller thread ID
+uint pa_get_thread_id();
 
-#ifdef MULTITHREAD
+class AutoSYNCHRONIZED;
 
+/// simple semaphore object
 class Mutex {
-	uint handle;
+	friend class AutoSYNCHRONIZED;
+
+#ifdef _MSC_VER
+HANDLE handle;
+#else
+pthread_mutex_t handle;
+#endif
+
 public:
 	Mutex();
 	~Mutex();
-	void lock();
-	void unlock();
+private: // for AutoSYNCHRONIZED
+	void acquire();
+	void release();
 };
 
-#else
+extern Mutex global_mutex;
 
-class Mutex {
-	Mutex() {}
-	~Mutex() {}
-	void lock() {}
-	void unlock() {}
+/** 
+	Helper to ensure paired Mutex::acquire() and Mutex::release().
+	Use it with SYNCHRONIZED macro
+*/
+
+class AutoSYNCHRONIZED {
+public:
+	AutoSYNCHRONIZED() { global_mutex.acquire(); }
+	~AutoSYNCHRONIZED() { global_mutex.release(); }
 };
 
-#endif
+/** 
+	put it to first line of a function to ensure thread safety.
+	@verbatim
+		void someclass::somefunc(...) { SYNCHRONIZED;
+			...
+		}
+	@endverbatim
+
+	WARNING: don't use THROW or PTHROW with such thread safety mechanizm -
+	longjmp would leave global_mutex acquired, which is wrong!
+*/
+#define SYNCHRONIZED AutoSYNCHRONIZED autoSYNCHRONIZED
 
 #endif