README
1
2 Memory Channels in Tcl
3 (Version 2.2.1 / DEC-03-2004)
4
5 Andreas Kupries (andreas_kupries@users.sourceforge.net)
6
7This directory contains a freely distributable extension to Tcl
8implementing memory channels, i.e. channels storing the data
9placed into them in memory, not on disk.
10
11
12BACKGROUND
13
14Tcl stands for the Tool Command Language, a freely distributable,
15embeddable scripting language package. Tk is an freely distributable X
16windows interface toolkit and widget library implemented as a collection of
17new commands added to Tcl.
18
19Memchan 2.2.1 is developed for Tcl 8.0 or higher. It is a Tcl
20extension, Tk is not required.
21
22This distribution contains the source code for Memchan + (very simple)
23documentation describing the new command.
24Memchan should be available by anonymous ftp from ftp.neosoft.com soon.
25
26
27COMPILING/USING Memchan
28
29To compile Memchan follow the instructions in the file README.install
30
31To report bugs, bug fixes, descriptions of interesting Memchan
32applications, and suggested improvements:
33
34+) Send email to andreas_kupries@users.sourceforge.net
35
36or
37
38+) Post an article to the newsgroup comp.lang.tcl
39
40
41REPORTING PROBLEMS
42
43This extension has been tested extensively on a number of platforms and with
44various versions of Tcl. If you find a problem and can reproduce it simply
45then please submit a bug report on the memchan sourceforge project at
46http://sourceforge.net/projects/memchan/
47
README.install
1
2This document describes to compile and install memchan on various
3systems.
4
5UNIX
6====
7
8There are 2 sets of files for building memchan on Unix-like system.
9
101) The most recent set is called the 'TEA' buildsystem and all
11 relevant files (configure, Makefile.in, ...) reside in the
12 toplevel directory of the memchan source distribution.
13
14 Use this set when compiling memchan against a Tcl core of
15 version 8.2 or higher.
16
172) The older set has no specific name and resides in the 'unix'
18 subdirectory of the memchan source distribution.
19
20 Use this set when compiling memchan against a Tcl core less
21 than 8.2, but greater or equal to 8.0.
22
23 Versions of tthe tcl core below version 8.0 of the core are not
24 supported.
25
26
27The standard usage of both sets is identical:
28
291) Switch into the directory containing the set.
302) Execute the 'configure' script to configure the distribution
313) Call the 'make' command with either no target or the target
32 'all' to compile memchan.
334) Execute 'make install' to install the generated binaries.
34
35WIN*
36====
37
38People having a cygwin environment and a VC++ compile can use the TEA
39build system in the toplevel directory to compile memchan (provided
40that a tcl core of version 8.2 or higher is used). It will be
41necessary to set CC=cl to enforce the usage of the MS VC++ compiler.
42
43For all other situations there are three makefiles for windows, all
44residing in the subdirectory "win" of the memchan distribution.
45
461) makefile.vc Use this with MS VC++ 6 IDE.
472) makefile.vc5 Use this with MS VC++ 5 IDE.
483) Makefile.gnu Use this with the cygwin gcc compiler.
49
50Adapting memchan to the configuration of the system it is built on is
51done by manually editing the relevant makefile and then executing
52'nmake' (or 'gmake' in case of (3)) for that makefile.
53
54The makefiles contain instructions on how to adapt them.
55
56
57MAC
58===
59
60It is currently not known how to compile memchan on a Mac. People who
61do so are asked to provide feedback and possibly project files, etc.,
62whatever they used to perform the compilation.
63
README.tea
1
2 Memory Channels in Tcl
3 (Version @mFullVersion@ / @mDate@)
4
5 Andreas Kupries (a.kupries@westend.com)
6
7This is the README file for the TEA compliant building of the Memchan
8extension.
9
10Please follow the instructions in the HTML file
11
12 doc/html/memchan_cunix.html
13
14for compilation and installation of this package, independent of wether
15you are on a Unix or Windows machine. Beware that in case of Windows TEA
16uses the Cygwin tools from Cygnus (www.cygnus.com) for compilation and
17linking.
18
19After that, enjoy it.
20