summary refs log tree commit diff stats
path: root/plugins/tcl/README
blob: e46635ef088d72483692cc5959f43a9d755837e8 (plain) (blame)
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
45
46
47
48
49
50
51
52
53
54
55
Please read this document before asking questions.

(1) WHAT IS THE TCL PLUGIN?

    The XChat Tcl Plugin adds the complete Tcl scripting language to the
    XChat 1.9.x and 2.x IRC client.  The design philosophy behind the tcl
    plugin was to give all the power of the C API. yet completely shield
    the user from all the complexities of it.  It is lightly modeled after
    after Xircon; an old windows TCL enabled client with a little bit of
    eggdrop functionality to it.

    Features:
     * Uses the popular TCL scripting language.
     * Familiar to eggdrop bot owners.
     * Adds many new XChat specific commands to the Tcl language for 
       handling of events, user commands, timers, etc. 
     * It's actually documented! (Hey, what a concept!) 
     * Works with XChat 1.9.x and 2.x. 
     * Open source (GPL) 

    The supplied documentation for Tcl Plugin commands can be 
    found in doc/tclplugin.html
    
    For a comprehensive list of IRC server tokens, see
    doc/tokens.txt


(2) HOW TO GET TCL PLUGIN

    You can always find the latest version of the Tcl Plugin at:

       http://www.scriptkitties.com/tclplugin

   You must also have Tcl 8.3 or higher installed on your system.

     Tcl can be obtained from:

       http://sourceforge.net/projects/tcl
       http://tcl.activestate.com (pre-compiled binaries)

     Tcl Man Pages

       http://tcl.activestate.com/man/

     Tcl Tutorials:

       http://hegel.ittc.ukans.edu/topics/tcltk/tutorial-noplugin/
       http://jan.netcomp.monash.edu.au/ProgrammingUnix/tcl/tcl_tut.html
       http://users.belgacom.net/bruno.champagne/tcl.html


(3) QUICK STARTUP

    SEE 'INSTALL'
span>/dev/null > /dev/null 2>&1 ; then automake_version=`automake --version | grep 'automake (GNU automake)' | sed 's/^[^0-9]*\(.*\)/\1/'` case $automake_version in 1.2*|1.3*|1.4|1.4*|1.5*|1.6*|1.7*|1.8*) ;; *) have_automake=true ;; esac fi if $have_automake ; then AUTOMAKE="automake" ACLOCAL="aclocal" else if automake-1.9 --version < /dev/null > /dev/null 2>&1 ; then AUTOMAKE="automake-1.9" ACLOCAL="aclocal-1.9" else echo "automake missing or too old. This requires at least automake 1.9" exit 1 fi fi # ------ START GETTEXT ------ echo searching for GNU gettext intl directory... dirs="/usr/share /usr/local/share /opt/share /usr /usr/local /opt /usr/gnu/share /opt/local /opt/local/share" found=0 for try in $dirs; do echo -n " -> $try/gettext/intl... " if test -d $try/gettext/intl; then echo found it found=1 break fi echo no done if test "$found" != 1; then echo ERROR: Cannot find gettext/intl directory. echo ERROR: Install GNU gettext in /usr or /usr/local prefix. exit 7 fi; echo copying gettext intl files... if test -f $try/gettext/mkinstalldirs; then ln -s $try/gettext/mkinstalldirs mkinstalldirs fi intldir="$try/gettext/intl" if test ! -d intl; then mkdir intl fi olddir=`pwd` cd $intldir for file in *; do if test $file != COPYING.LIB-2.0 && test $file != COPYING.LIB-2.1; then rm -f $olddir/intl/$file cp $intldir/$file $olddir/intl/ fi done cp -f $try/gettext/po/Makefile.in.in $olddir/po/ cd $olddir if test -f intl/plural.c; then sleep 2 touch intl/plural.c fi # ------ END GETTEXT ------ echo running $ACLOCAL... $ACLOCAL $ACLOCAL_FLAGS if test "$?" != "0"; then echo aclocal failed, stopping. exit 2 fi echo running libtoolize... libtoolize --force if test "$?" != "0"; then echo libtoolize failed, stopping. exit 3 fi echo running autoheader... autoheader if test "$?" != "0"; then echo autoheader failed, stopping. exit 4 fi echo running $AUTOMAKE... $AUTOMAKE -a if test "$?" != "0"; then echo automake failed, stopping. exit 5 fi echo running autoconf... autoconf if test "$?" != "0"; then echo autoconf failed, stopping. exit 6 fi echo if no errors occured, run ./configure exit 0 #autogen.sh generates: # aclocal.m4 Makefile.in config.guess config.sub ltmain.sh # configure install-sh missing mkinstalldirs depcomp # #configure generates: # config.status libtool Makefile.in