kettle_introduction - Kettle - Introduction to Kettle
Welcome to Kettle, a set of packages providing support for writing build code for Tcl packages. Kettle is a system to make building Tcl packages quick and easy. More importantly, possibly, to make writing the build system for Tcl packages easy.
As such kettle is several things:
A DSL helping you to write build systems for your packages.
A package implementing this DSL.
An application which can serve as the interpreter for a build file containing commands in the above DSL.
All of these will be explained in the documentation, although not everything is for everybody. I.e. a user of the DSL requires a different set of knowledge than a developer working on extending kettle's DSL, etc.
The image below provides a basic overview of the system's architecture, with a package's custom build file at the top, using DSL commands from core layer, under the mediation of the kettle application.
The manpages relevant to a user of kettle, i.e. to a package developer wishing to use it as the build system for her code are:
For the developers and maintainers of kettle, and power users wishing to extend the system to handle their custom circumstances, we additionally have:
This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such at the Kettle Tracker. Please also report any ideas for enhancements you may have for either package and/or documentation.