Documentation

Not logged in
Bounty program for improvements to Tcl and certain Tcl packages.


[ Home | Main Table Of Contents | Table Of Contents | Keyword Index ]

NAME

kettle_changes - Kettle Changes

Table Of Contents

SYNOPSIS

package require Tcl 8.5 9

DESCRIPTION

Welcome to Kettle, an application and set of packages providing support for the easy building and installation of pure Tcl packages, and Critcl based Tcl packages.

Please read the document Kettle - Introduction to Kettle, if you have not done so already, to get an overview of the whole system.

This document provides an overview of the changes kettle underwent from version to version.

Changes

Changes for version 1

This is the first release of kettle, package and application. The changes therefore describe the initial features of the system.

In detail:

  1. Kettle requires Tcl 8.5 or higher. Tcl 8.4 or less is not supported.

  2. The application kettle provides standard setup to run a file "build.tcl", specified either explicitly via option -f, or implicitly (current working directory).

    This application can be used as the interpreter of a build declaration file as well. In that case option -f must be part of the #!-line.

  3. The core package kettle manages a database of recipes, and provides standard code invoked automatically after the processing of the build declarations to show help or run a recipe specified on the command line.

    Standard recipes provide introspection into the list of known recipes, and display of general and recipe-specific help.

  4. Various utility and support packages providing the commands for the build declarations, and implementation helpers.

    Currently supported are

    1. (Un)installation of pure Tcl packages.
    2. (Un)installation of Tcl script applications.
    3. (Un)installation of critcl-based Tcl+C packages.
    4. (Re)generation and (un)installation of (tcllib) doctools based manpages.
    5. (Re)generation and display of (tklib) diagram based figures.
    6. Execution of tcltest-based testsuites.
    7. Execution of tclbench-based benchmarks.

Changes for version 1.1

The first official release of Kettle in just shy of 11 years. Note: Version 1 was tagged 2013-02-07.

I am unable to list all the changes in detail. Lots of (small(ish)) bug fixes, and some features.

Notable: export documentation to markdown, valgrind support.

I decided to tag and release version 1.1 because of the changes to make kettle work with Tcl 9.

Bugs, Ideas, Feedback

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.

KEYWORDS

build tea

CATEGORY

Build support