[teklib-general] teklib: Gendoc utility: -e option now considered in module index...

Sun Feb 22 18:19:37 CET 2009

details:   http://hg.teklib.org/teklib/rev/8d5ad9ed061b
changeset: 255:8d5ad9ed061b
user:      Timm S. Mueller <tmueller at neoscientists.org>
date:      Sun Feb 22 18:15:13 2009 +0100
description:
Gendoc utility: -e option now considered in module index; Windows Display:
Improved font and input handling, now using struct TVRequest instead of struct
TVFBRequest again; X11 Display: Minor corrections and optimizations; Visual
module: Stronger internal typing, open font handles are now reusable I/O
requests; Makefile: docs target added

diffs (truncated from 1838 to 100 lines):

diff -r 3de116db3a55 -r 8d5ad9ed061b Makefile

--- a/Makefile	Wed Feb 18 15:04:55 2009 +0100
+++ b/Makefile	Sun Feb 22 18:15:13 2009 +0100
@@ -14,15 +14,15 @@
 ###############################################################################
 
 help:
-	@echo
+	@echo "==============================================================================="
 	@echo "Build configuration (pass as variables or override in Makefile):"
 	@echo "-------------------------------------------------------------------------------"
 	@echo "TEKLIB = ................ $(TEKLIB)"
 	@echo "PLATFORM = .............. $(PLATFORM) [available: posix, winnt]"
 	@echo "HOST = .................. $(HOST) [available: linux, fbsd, winnt]"
 	@echo "COMPILER = .............. $(COMPILER) [available: gcc]"
-	@echo
-	@echo "Build targets:"
+	@echo "==============================================================================="
+	@echo "Standard build targets:"
 	@echo "-------------------------------------------------------------------------------"
 	@echo "all, $(HOST) .............. default build"
 	@echo "release ................. release build"
@@ -30,8 +30,12 @@
 	@echo "install ................. install"
 	@echo "make .................... regenerate makefiles"
 	@echo "clean ................... delete executables, modules, object files"
+	@echo "==============================================================================="
+	@echo "Extra build targets:"
+	@echo "-------------------------------------------------------------------------------"
+	@echo "docs .................... (re-)generate documentation"
 	@echo "distclean ............... delete all temporary files"
-	@echo
+	@echo "==============================================================================="
 
 all: $(HOST)
 release: $(HOST)_release
@@ -100,3 +104,6 @@
 
 kdiff:
 	-(a=$$(mktemp -du) && hg clone $$PWD $$a && kdiff3 $$a $$PWD; rm -rf $$a)
+
+docs:
+	etc/gendoc.lua . -e -n TEKlib reference manual > doc/manual.html
diff -r 3de116db3a55 -r 8d5ad9ed061b doc/manual.html
--- a/doc/manual.html	Wed Feb 18 15:04:55 2009 +0100
+++ b/doc/manual.html	Sun Feb 22 18:15:13 2009 +0100
@@ -7,49 +7,50 @@
 		<link rel="stylesheet" href="manual.css" />
 	</head>
 	<body>
-		<div class="node"><h1><a name="index" id="index">TEKlib reference manual</a></h1>
-			<h2>
-				Modules and libraries
-			</h2>
-			<blockquote>
-				<ul>
-					<li>
-						astro
-					</li>
-					<li>
-						display
-					</li>
-					<li>
-						<a href="#exec">exec</a> 
-					</li>
-					<li>
-						hal
-					</li>
-					<li>
-						io
-					</li>
-					<li>
-						lua5
-					</li>
-					<li>
-						ps2
-					</li>
-					<li>
-						<a href="#string">string</a> 
-					</li>
-					<li>
-						<a href="#teklib">teklib</a> 
-					</li>
-					<li>
-						<a href="#util">util</a> 
-					</li>
-					<li>
-						visual
-					</li>
-				</ul>
-			</blockquote>
-			<hr />
-		</div>
+		<h1>
+			TEKlib reference manual
+		</h1>
+		<h2>
+			Modules and libraries
+		</h2>
+		<blockquote>
