        chiark-tcl - some useful Tcl bindings
        -------------------------------------

This package contains, basically, shared libraries
  chiark_tcl_<something>-1.so
in /usr/lib.

Each of these is a Tcl extension which can be loaded into a Tcl
interpreter with
  load chiark_tcl_<something>-1.so
and then the new commands will immediately be available.

The documentation for each extension is regrettably rather sketchy but
the following information should be enough to get you started:

  <something>.tct

      This is the input file to the automatic Tcl<->C glue generator
      used by all of the extensions provided in this package.  This
      lists the commands and subcommands available.

  <something>.[ch].txt

      Some of the extensions have additional usage documentation in a
      source code comment.  This comment has been mechanically
      extracted from the source file for your comfort and convenience.

To gain an understanding of the way the *.tct files work, take a
look at adns.c.txt which describes the `adns' command provided by
the adns binding.

Note that the file /usr/lib/libchiark_tcl-1.so is NOT an amalgam of
all of the extensions.  It is a set of common routines which will be
loaded automatically when required.  Each extension must be loaded
explicitly with the Tcl `load' command to bring the additional
commands into the Tcl command namespace.

To use the adns and nettle bindings you need to have the appropriate
libraries installed too, although these are not listed as
dependencies.  Programs which use these extensions should list
dependencies on (currently) libadns1 and libnettle2.  Regrettably,
there is no clear way to get the dependencies completely correct in
the case where chiark-tcl is rebuilt against some other versions of
adns and/or nettle.
