/usr/share/doc/libtcl-chiark-1/README is in libtcl-chiark-1 1.1.3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 | 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.
|