[teklib-general] teklib: Stricter typing in the TEKlib link library API, namely a...

[Timm S. Mueller]

details:   http://hg.teklib.org/teklib/rev/9565b0d70b48
changeset: 250:9565b0d70b48
user:      Timm S. Mueller <tmueller at neoscientists.org>
date:      Mon Feb 16 00:18:08 2009 +0100
description:
Stricter typing in the TEKlib link library API, namely affecting TDestroy()
and TInitVectors(); added string library interface description file; completed
documentation in teklib interface description file

diffs (truncated from 2306 to 100 lines):

diff -r c9a1538c56b0 -r 9565b0d70b48 doc/manual.html
--- a/doc/manual.html	Sun Feb 15 17:03:33 2009 +0100
+++ b/doc/manual.html	Mon Feb 16 00:18:08 2009 +0100
@@ -37,6 +37,9 @@
 					ps2
 				</li>
 				<li>
+					<a href="#string">string</a> 
+				</li>
+				<li>
 					<a href="#teklib">teklib</a> 
 				</li>
 				<li>
@@ -88,24 +91,45 @@
 			<div class="definition"><dfn>FUNCTIONS</dfn>
 				<ul>
 					<li style="list-style-type: none">
+						<a href="#teklib:TAddDate"><code>teklib:TAddDate()</code></a> - Add number of days and a time to a date
+					</li>
+					<li style="list-style-type: none">
 						<a href="#teklib:TAddHead"><code>teklib:TAddHead()</code></a> - Add a node at the head of a list
 					</li>
 					<li style="list-style-type: none">
 						<a href="#teklib:TAddTail"><code>teklib:TAddTail()</code></a> - Add a node at the tail of a list
 					</li>
 					<li style="list-style-type: none">
+						<a href="#teklib:TAddTime"><code>teklib:TAddTime()</code></a> - Add a time to another
+					</li>
+					<li style="list-style-type: none">
+						<a href="#teklib:TCallHookPkt"><code>teklib:TCallHookPkt()</code></a> - Invoke a hook
+					</li>
+					<li style="list-style-type: none">
+						<a href="#teklib:TCmpTime"><code>teklib:TCmpTime()</code></a> - Compare times
+					</li>
+					<li style="list-style-type: none">
+						<a href="#teklib:TCreateTime"><code>teklib:TCreateTime()</code></a> - Create a time from days, seconds, micros
+					</li>
+					<li style="list-style-type: none">
 						<a href="#teklib:TDestroy"><code>teklib:TDestroy()</code></a> - Destroy a handle
 					</li>
 					<li style="list-style-type: none">
 						<a href="#teklib:TDestroyList"><code>teklib:TDestroyList()</code></a> - Unlink all nodes in a list and destroy them
 					</li>
 					<li style="list-style-type: none">
+						<a href="#teklib:TDiffDate"><code>teklib:TDiffDate()</code></a> - Calculate days and time difference between dates
+					</li>
+					<li style="list-style-type: none">
 						<a href="#teklib:TEKCreate"><code>teklib:TEKCreate()</code></a> - Create an initial TEKlib task/thread context
 					</li>
 					<li style="list-style-type: none">
 						<a href="#teklib:TEKMain"><code>teklib:TEKMain()</code></a> - Entrypoint for a freestanding application
 					</li>
 					<li style="list-style-type: none">
+						<a href="#teklib:TExtractTime"><code>teklib:TExtractTime()</code></a> - Extract days, seconds, micros from a time
+					</li>
+					<li style="list-style-type: none">
 						<a href="#teklib:TFindHandle"><code>teklib:TFindHandle()</code></a> - Find a named handle in a list
 					</li>
 					<li style="list-style-type: none">
@@ -118,6 +142,12 @@
 						<a href="#teklib:TGetTag"><code>teklib:TGetTag()</code></a> - Get a value from a list of tagitems
 					</li>
 					<li style="list-style-type: none">
+						<a href="#teklib:TInitHook"><code>teklib:TInitHook()</code></a> - Initialize a hook with a function and data
+					</li>
+					<li style="list-style-type: none">
+						<a href="#teklib:TInitInterface"><code>teklib:TInitInterface()</code></a> - Initialize an interface structure
+					</li>
+					<li style="list-style-type: none">
 						<a href="#teklib:TInitList"><code>teklib:TInitList()</code></a> - Initialize a list structure
 					</li>
 					<li style="list-style-type: none">
@@ -140,6 +170,12 @@
 					</li>
 					<li style="list-style-type: none">
 						<a href="#teklib:TRemTail"><code>teklib:TRemTail()</code></a> - Remove a node from the tail of a list
+					</li>
+					<li style="list-style-type: none">
+						<a href="#teklib:TSubDate"><code>teklib:TSubDate()</code></a> - Subtract a number of days and a time from a date
+					</li>
+					<li style="list-style-type: none">
+						<a href="#teklib:TSubTime"><code>teklib:TSubTime()</code></a> - Subtract a time from another
 					</li>
 				</ul>
 				<hr />
@@ -239,8 +275,8 @@
 void API_func(TTAGITEM *tags)
 {
     TINT numv = (TINT) TGetTag(tags, MY_NumPoints, (TTAG) 3);
-    TFLOAT *v = (TFLOAT *) TGetTag(tags, MY_Points, default_vertices);
-    TSTRPTR n = (TSTRPTR) TGetTag(tags, MY_Name, &quot;Default Triangle&quot;);
+    TFLOAT *v = (TFLOAT *) TGetTag(tags, MY_Points, def_vertices);
+    TSTRPTR n = (TSTRPTR) TGetTag(tags, MY_Name, &quot;Def. Triangle&quot;);
     TUINT rgb = (TUINT) TGetTag(tags, MY_Color, (TTAG) 0xff0000);
     /* ... more tags in the future ... */
 }
@@ -250,9 +286,9 @@
 					<ul>
 						<li>
 							As the sizes of <code>TFLOAT</code> and <code>TDOUBLE</code> types are not regulated