kbs -- kitgen build system (version 0.4.3 for tcl/tk 8.5.12 and 8.6b3)
==========================
The system can generate [Tclkit] and [Tclkit Lite] executables and
Tcl packages for different operating systems.
Tested are Linux, SunOS and Windows.
[Tclkit]: http://www.equi4.com/tclkit/tclkitlite.html
[Tclkit Lite]: http://www.equi4.com/tclkit/tclkitlite.html
Additional documentation can be found under <http://wiki.tcl.tk/18146>
Sources are available from <http://sourceforge.net/projects/kbskit>
-------
* kbs.tcl - single source file, all you need
Metakit tclkit interpreter, read/write of kitfiles, C++ libs necessary:
*kbsmk*cli* - shell application
*kbsmk*dyn* - tk dynamic loadable
*kbsmk*gui* - tk static inserted
Vlerq tclkit lite interpreter, readonly kitfiles:
*kbsvq*cli* - shell application
*kbsvq*dyn* - tk dynamic loadable
*kbsvq*gui* - tk static inserted
Batteries included interpreter:
*kbsvq*bi
with (8.5 and 8.6):
bwidget1.9.5 gridplus2.9 icons1.2 img1.4.1
memchan2.2.1 mentry3.6 nsf2.0b3 ral0.10 rbc0.1 sqlite3.7.14
tablelist5.6 tcllib1.14 tclx8.4 tdom0.8.3 thread2.6.7 tkcon tkdnd2.6
tklib0.5 tktable2.10 treectrl2.4.1 trofs0.4.6 udp1.0.8 wcb3.4 xotcl1.6.7
only 8.5:
itcl3.4 itk3.4 iwidgets4.0.2
only 8.6:
itcl4.0 itk4.0 iwidgets4.1
Quick start
-----------
* Build [Tclkit] executables:
./kbs.tcl -r -mk install kbskit8.5
* Build [Tclkit Lite] executables:
./kbs.tcl -r -vq install kbskit8.5
* Build user defined batteries included executables:
./kbs.tcl -r -vqi-bi -bi=".." install kbskit8.5
* Build kit-file:
./kbs.tcl -r install kbspkg8.5
* Show used configuration:
./kbs.tcl config
* Start graphical user interface:
./kbs.tcl gui
* Display options and online help:
./kbs.tcl help
Build requirements
------------------
The following external programs are needed:
* C-compiler, C++ compiler for metakit based programs
* make with handling of VPATH variables (gmake)
* wget, cvs, svn, tar, gzip, unzip to get and extract sources
To build under Windows you need the [msys] system and put the kbs-sources
inside the msys tree (/home/..).
[msys]: http://sourceforge.net/project/showfiles.php?group_id=10894
License & support
-----------------
This work is under BSD license (see with './kbs.tcl license')
The [Tclkit]-specific sources are license free, they just have a copyright.
Hold the author(s) harmless and any lawful use is permitted.
This does *not* apply to any of the sources of the other major Open Source
Software used in Tclkit, which each have very liberal BSD/MIT-like licenses:
* Tcl/Tk, TclVFS, Thread, Vlerq, Zlib
Used extensions have own licenses. Please see in the sources.
Acknowledgements
----------------
This work is based on the [Kitgen] system (http://www.equi4.com/kitgen.html)
and ideas and code about a kitgen build system by Jean-Claude Wippler.
With thanks to John Ousterhout for creating Tcl/Tk, Matt Newman and Vince Darley
for developing the virtual file system, and the members of the Tcl Core Team for
diligently maintaining and taking forward the Tcl/Tk code base plus extensions.