<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
</head>
<body bgcolor="#FFFFFF" text="#000000">
Hi experts, <br>
<br>
As I am not familiar with the appropriate tools and the proceedings,
I'd like to request a knowledgeable person to enhance the docs for
some RTL functions that might get rather important to me in the
future: <br>
<br>
1)
<a class="moz-txt-link-freetext" href="http://www.freepascal.org/docs-html/rtl/classes/checksynchronize.html">http://www.freepascal.org/docs-html/rtl/classes/checksynchronize.html</a><br>
<br>
IMHO this is not a documentation at all but just a vague hit on how
this function might be used. <br>
<br>
I think a more appropriate description could be similar to <br>
<br>
<hr size="2" width="100%"><b><var>CheckSynchronize </var></b><b>checks
if there are entries in the event queue, pulls them and fires
events (aka callbacks) for each of them until the event queue is
empty. </b><b><br>
</b><b><br>
</b><b>The Events </b><b><var>CheckSynchronize </var></b><b>pulls
from the queue have been generated by </b><b><a
href="http://www.freepascal.org/docs-html/rtl/classes/tthread.html">TThread.Synchronize</a></b><b>
and TThread.Queue calls. </b><b><br>
</b><b><br>
</b><b>Calling </b><b><var>CheckSynchronize</var></b><b> is only
allowed in the Main thread, but not ion worker threads generated
by TThread siblings.</b><br>
<br>
<var>CheckSynchronize</var> should be called regularly by the main
application thread to handle any <a
href="http://www.freepascal.org/docs-html/rtl/classes/tthread.html">TThread.Synchronize</a><b>
and TThread.Queue</b> calls that may be waiting for execution by
the main thread. <br>
<hr size="2" width="100%"><br>
<br>
2)
<a class="moz-txt-link-freetext" href="http://www.freepascal.org/docs-html/rtl/classes/wakemainthread.html">http://www.freepascal.org/docs-html/rtl/classes/wakemainthread.html</a>
<br>
<br>
<hr size="2" width="100%"><var>WakeMainThread</var> is called by the
<a
href="http://www.freepascal.org/docs-html/rtl/classes/tthread.html">TThread.synchronize</a><b>
and the TThread.Queue</b> call. ,,,,<br>
(In fact I don't really understand the rest of the text, but that
might be my own silliness. Of course I do know exactly what <var>WakeMainThread</var>
is supposed to do.<var></var>)<br>
<hr size="2" width="100%"><br>
<br>
3) <a class="moz-txt-link-freetext" href="http://www.freepascal.org/docs-html/rtl/classes/tthread.html">http://www.freepascal.org/docs-html/rtl/classes/tthread.html</a><br>
<br>
- The function Synchronize is missing even though
<a class="moz-txt-link-freetext" href="http://www.freepascal.org/docs-html/rtl/classes/checksynchronize.html">http://www.freepascal.org/docs-html/rtl/classes/checksynchronize.html</a>
links here on that behalf<br>
- the function Queue is missing (which of course has been
implemented only recently) <br>
<br>
Thanks a lot !<br>
<br>
-Michael<br>
<br>
<br>
<br>
<br>
</body>
</html>