ReadMeW32.txt

   1 To install TclCurl in Windows you simply have to double-click on the 'SetUp.tcl'
   2 file, provided you already have Tcl/Tk installed, the script will take care of
   3 everything.
   4
   5 By the way, Tcl's console doesn't seem to like the output sent by TclCurl,
   6 for example, if you type:
   7
   8 curl::transfer -url www.scriptics.com
   9
  10 you will only get an error, you will have to dump it to a file with the
  11 'file' option, read it in to a variable with 'bodyvar', use Cygwin's console
  12 or use tkCon from msys-mingw.
  13
  14
  15 Compiling TclCurl in Windows
  16
  17
  18 First of all a little disclaimer:
  19
  20 I know nothing about Windows programming, no kidding, not a thing,
  21 zip, zilch, nada. I can barely manage using tools, like Tcl/Tk and
  22 gcc, whose origin is in the Unix world, but that is just about it, so
  23 if you think that the following is just plain stupid, that is because
  24 it probably is, but in that case, don't forget to tell me all about it.
  25
  26 To compile TclCurl in Windows you are going to need several things:
  27
  28     - A msys-mingw enviroment, you can get it at SourceForge:
  29
  30           http://sourceforge.net/projects/tcl/
  31
  32       or you can get MinGW and Msys from their project page:
  33
  34           http://sourceforge.net/projects/mingw/
  35
  36     - Since you are already at Tcl's page at SF, you can download the
  37       lastest Tcl version, 8.4.13 at this writing. (These instructions won't
  38       work with 8.3.x versions)
  39
  40     - Download zlib from http://www.gzip.org/zlib/
  41
  42     - Download bc from http://gnuwin32.sourceforge.net/packages/bc.htm and
  43       install it.
  44
  45     - Extract Tcl, cURL, zlib and TclCurl in the same directory.
  46
  47     - Copy the 'tclcurl.mk' file in TclCurl/packages/windows to this directory.
  48
  49     - Start msys, go to the directory and type:
  50
  51             $ make -f tclcurl.mk tclcurl-plain
  52
  53       This command will compile and install Tcl, zlib, cURL and TclCurl, if
  54       you want to have Tk though, you will have to install it yourself.
  55
  56       After compiling and installing all the elements, the make file will
  57       try to create the self-extracting archive using 'rar', if you don't
  58       have it installed it will fail, but don't worry, everything is already
  59       installed. If you have rar and you want to create the archives, don't
  60       forget to change the path at the end of the make file.
  61
  62     - If you want to use TclCurl with the Tcl/Tk you have installed in
  63       c:\Program Files or anywhere else, copy the directory
  64       '/usr/local/lib/tclcurl0.110' to 'c:\Program Files\Tcl\lib'
  65
  66     - And now you should have a working TclCurl, run Tcl/Tk and type:
  67
  68             $ package require TclCurl.
  69
  70       Tcl should return TclCurl's version, if it doesn't something went wrong,
  71       could you please tell me?
  72
  73     - Wish console doesn't really like TclCurl, so if you do:
  74
  75             $ curl::transfer -url slashdot.org
  76
  77       It will return a '0' to tell you that the transfer was successful, but it will
  78       show you nothing, you will have to dump the page into a file to be able to read
  79       it or use Cygwin's console.
  80
  81
  82
  83 Compiling TclCurl with threads support
  84
  85 You have to do basically the same thing, except that the command to compile is:
  86
  87     $ make -f tclcurl.mk tclcurl-threaded
  88
  89
  90 Compiling TclCurl with SSL support
  91
  92 Since 1.0.0 openssl is easier to compile, you can find the instructions to it in
  93 the INSTALL.W32 file in the openssl tarball.
  94
  95 You can get the cacert.pem at http://curl.haxx.se/ca/, you need to put in the
  96 directory from which you are going to compile
  97
  98         - $ make -f tclcurl.mk tclcurl-ssl
  99
 100       - If you want to have threads support:
 101
 102         - $ make -f tclcurl.mk tclcurl-threaded-ssl
 103
 104 Sounds like a lot of work to run a little extension, but then again, you could
 105 have downloaded the self-extracting archive file.
 106
 107
 108 Share the wonders,
 109 Andres
 110 fandom@telefonica.net
 111
 112
 113