kitgen build system Files

kbs -- kitgen build system (version 0.4.1 for tcl/tk 8.5.9 and 8.6 20101028)
==========================

The system can generate [Tclkit]  and [Tclkit Lite] executables and
Tcl packages for different operating systems.
Tested are Linux, SunOS, Windows and Irix.
  [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:
    bwidget1.8.0 gridplus2.5 icons1.2 img1.4 itcl3.4 itk3.4 iwidgets4.0.2
    memchan2.2.1 mentry3.3 ral0.9.1 rbc0.1 sqlite3.7.2 tablelist5.2
    tcllib1.12 tclx8.4 thread2.6.5 tkcon tklib0.5 tktable2.10
    treectrl2.2.9 trofs0.4.4 udp1.0.8 wcb3.2 xotcl1.6.6

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)
   * 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.