[teklib-general] teklib: merge

[Franciska Schulze]

details:   http://hg.teklib.org/teklib/rev/db374fc01d94
changeset: 264:db374fc01d94
user:      Franciska Schulze <fschulze at neoscientists.org>
date:      Tue Jun 16 14:53:00 2009 +0000
description:
merge

diffs (truncated from 3336 to 100 lines):

diff -r 1515a641e7d2 -r db374fc01d94 doc/manual.html
--- a/doc/manual.html	Mon May 18 12:59:41 2009 +0000
+++ b/doc/manual.html	Tue Jun 16 14:53:00 2009 +0000
@@ -1606,6 +1606,36 @@
 				<hr />
 			</div>
 		</div>
+		<div class="node"><h3><a name="teklib:TGetNextEntry" id="teklib:TGetNextEntry"><code>TGetNextEntry()</code></a></h3>
+<pre>
+entry = TGetNextEntry(handle)
+TAPTR                 struct THandle*
+</pre>
+			<div class="definition"><dfn>FUNCTION</dfn>
+				<p>
+					Get the next entry from a handle by dispatching TMSG_GETNEXTENTRY.
+				</p>
+			</div>
+			<div class="definition"><dfn>RESULTS</dfn>
+				<blockquote>
+					<ul>
+						<li style="list-style-type: none">
+							<code>entry</code> - Next entry, or <code>TNULL</code> if no next entry available
+						</li>
+					</ul>
+				</blockquote>
+			</div>
+			<div class="definition"><dfn>INPUTS</dfn>
+				<blockquote>
+					<ul>
+						<li style="list-style-type: none">
+							<code>handle</code> - Pointer to a generic object handle
+						</li>
+					</ul>
+				</blockquote>
+				<hr />
+			</div>
+		</div>
 		<div class="node"><h2><a name="string" id="string">string </a></h2>
 			<div class="definition"><dfn>FUNCTIONS</dfn>
 				<ul>
@@ -1973,6 +2003,9 @@
 					</li>
 					<li style="list-style-type: none">
 						<a href="#exec:TReplyMsg"><code>exec:TReplyMsg()</code></a> - Return a modified message to its sender
+					</li>
+					<li style="list-style-type: none">
+						<a href="#exec:TScanModules"><code>exec:TScanModules()</code></a> - Scan available TEKlib modules
 					</li>
 					<li style="list-style-type: none">
 						<a href="#exec:TSendMsg"><code>exec:TSendMsg()</code></a> - Send a message synchronously
@@ -4804,6 +4837,78 @@
 				<hr />
 			</div>
 		</div>
+		<div class="node"><h3><a name="exec:TScanModules" id="exec:TScanModules"><code>TScanModules()</code></a></h3>
+<pre>
+handle = TScanModules(tags)
+struct THandle*       TTAGITEM*
+</pre>
+			<div class="definition"><dfn>FUNCTION</dfn>
+				<p>
+					This function searches for modules that are available to TEKlib's module
+					open function and, if successful, returns a handle that can be queried
+					using <a href="#teklib:TGetNextEntry"><code>teklib:TGetNextEntry()</code></a>.
+					Each invocation of <a href="#teklib:TGetNextEntry"><code>teklib:TGetNextEntry()</code></a> on the resulting handle returns
+					a pointer to a taglist, or <code>TNULL</code> when there are no more entries
+					available. Possible tags in this taglist, as currently defined, are:
+				</p>
+				<blockquote>
+					<ul>
+						<li>
+							<code>TExec_ModuleName, (TSTRPTR)</code> - Name of a module that would
+							be available to <a href="#exec:TOpenModule"><code>exec:TOpenModule()</code></a>.
+						</li>
+					</ul>
+				</blockquote>
+				<p>
+					When you are done scanning for modules, the handle should be destroyed
+					with <a href="#teklib:TDestroy"><code>teklib:TDestroy()</code></a>.
+				</p>
+			</div>
+			<div class="definition"><dfn>RESULTS</dfn>
+				<ul>
+					<li style="list-style-type: none">
+						<code>handle</code> - A handle that can be passed to <a href="#teklib:TGetNextEntry"><code>teklib:TGetNextEntry()</code></a>,
+						or <code>TNULL</code> if scanning failed.
+					</li>
+				</ul>
+			</div>
+			<div class="definition"><dfn>INPUTS</dfn>
+				<ul>
+					<li style="list-style-type: none">
+						<code>tags</code> - Pointer to an array of tag items:
+						<blockquote>
+							<ul>
+								<li>
+									<code>TExec_ModulePrefix (TSTRPTR)</code> - Pointer to a prefix string.
+									If specified, only modules whose names begin with this prefix will
+									be returned. Default: <code>TNULL</code> 
+								</li>