X-Git-Url: https://git.sven.stormbind.net/?a=blobdiff_plain;f=ReadMeW32.txt;fp=ReadMeW32.txt;h=fc2f36b2479dd3e9adebd51c08a291af0e915551;hb=b0e6fb6e4379fb87fa2854b84a56c5ad49c644da;hp=0000000000000000000000000000000000000000;hpb=c9a5bcd9d76f699909b24e71a2a216d36062ab0b;p=sven%2Ftclcurl.git

diff --git a/ReadMeW32.txt b/ReadMeW32.txt
new file mode 100755
index 0000000..fc2f36b
--- /dev/null
+++ b/ReadMeW32.txt
@@ -0,0 +1,151 @@
+To install TclCurl in Windows you simply have to double-click on the 'SetUp.tcl'
+file, provided you already have Tcl/Tk installed, the script will take care of
+everything.
+
+By the way, Tcl's console doesn't seem to like the output sent by TclCurl,
+for example, if you type:
+
+curl::transfer -url www.scriptics.com
+
+you will only get an error, you will have to dump it to a file with the
+'file' option, read it in to a variable with 'bodyvar', use Cygwin's console
+or use tkCon from msys-mingw.
+
+
+Compiling TclCurl in Windows
+
+
+First of all a little disclaimer:
+
+I know nothing about Windows programming, no kidding, not a thing,
+zip, zilch, nada. I can barely manage using tools, like Tcl/Tk and
+gcc, whose origin is in the Unix world, but that is just about it, so
+if you think that the following is just plain stupid, that is because
+it probably is, but in that case, don't forget to tell me all about it.
+
+To compile TclCurl in Windows you are going to need several things:
+
+    - A msys-mingw enviroment, you can get it at SourceForge:
+
+          http://sourceforge.net/projects/tcl/
+
+      or you can get MinGW and Msys from their project page:
+
+          http://sourceforge.net/projects/mingw/
+
+    - Since you are already at Tcl's page at SF, you can download the
+      lastest Tcl version, 8.4.13 at this writing. (These instructions won't
+      work with 8.3.x versions)
+
+    - Download zlib from http://www.gzip.org/zlib/
+
+    - Download bc from http://gnuwin32.sourceforge.net/packages/bc.htm and
+      install it.
+
+    - Extract Tcl, cURL, zlib and TclCurl in the same directory.
+
+    - Copy the 'tclcurl.mk' file in TclCurl/packages/windows to this directory.
+
+    - Start msys, go to the directory and type:
+
+            $ make -f tclcurl.mk tclcurl-plain
+
+      This command will compile and install Tcl, zlib, cURL and TclCurl, if
+      you want to have Tk though, you will have to install it yourself.
+
+      After compiling and installing all the elements, the make file will
+      try to create the self-extracting archive using 'rar', if you don't
+      have it installed it will fail, but don't worry, everything is already
+      installed. If you have rar and you want to create the archives, don't
+      forget to change the path at the end of the make file.
+
+    - If you want to use TclCurl with the Tcl/Tk you have installed in 
+      c:\Program Files or anywhere else, copy the directory
+      '/usr/local/lib/tclcurl0.110' to 'c:\Program Files\Tcl\lib'
+
+    - And now you should have a working TclCurl, run Tcl/Tk and type:
+
+            $ package require TclCurl.
+
+      Tcl should return TclCurl's version, if it doesn't something went wrong,
+      could you please tell me?
+
+    - Wish console doesn't really like TclCurl, so if you do:
+
+            $ curl::transfer -url slashdot.org
+
+      It will return a '0' to tell you that the transfer was successful, but it will
+      show you nothing, you will have to dump the page into a file to be able to read
+      it or use Cygwin's console.
+
+
+
+Compiling TclCurl with threads support
+
+You have to do basically the same thing, except that the command to compile is:
+
+    $ make -f tclcurl.mk tclcurl-threaded
+
+
+Compiling TclCurl with SSL support
+
+To prevent patent trouble, the SSL enabled binaries don't support the idea, rc5 and mdc2
+algorithms, if you need them, and you are allowed to do so, you can compile them yourself.
+
+
+      - First of all you have to compile Openssl, you can get the lastest version
+        at http://www.openssl.org, these instructions should work with version 0.9.8e
+
+      - To compile it you are going to need Perl in your system, for whatever the reason
+        I couldn't get it to work with the Perl that comes with Cygwin, so I had to
+        download ActivePerl: http://www.activestate.com.
+
+      - You will also need to download the MinGW compiler, the compiling scripts don't
+        like the msys enviroment though.
+
+      - The open a MS-DOS console in the openssl directory and make sure that both
+        perl and mingw are in you path:
+
+            c:\openssl-0.9.8e\> echo %PATH%
+
+        if they aren't add them:
+
+            c:\openssl-0.9.8e\> PATH=%PATH%;C:\Perl\bin;c:\MinGW\bin
+
+        change the paths if you need to.
+
+      - Only thing left is to type in the MS-DOS console:
+
+             c:\openssl-0.9.8e\> ms\mingw32.bat
+ 
+        and hope for the best.
+
+      - After it compiles you have to copy some files around:
+
+        - libcryto.a, libeay32.a, libssl.a and libssl32.a from 
+          openssl-0.9.8e\out to c:\msys\local\lib.
+
+        - libeay32.dll and libssl32.dll from openssl-0.9.8e to
+          c:\msys\local\lib and c:\msys\local\bin.
+
+        - The contents of openssl-0.9.8e\outinc to c:\msys\local\include.
+
+      - Now copy the 'tclcurl.mk' file from TclCurl/packages/windows to
+        the directory in which you have TclCurl, Tcl, cURL, TclCurl and OpenSSL.
+
+        - $ make -f tclcurl.mk tclcurl-ssl
+
+      - If you want to have threads support:
+
+        - $ make -f tclcurl.mk tclcurl-threaded-ssl        
+
+Sounds like a lot of work to run a little extension, but then again, you could
+have downloaded the self-extracting archive file.
+
+
+Share the wonders,
+Andres
+fandom@telefonica.net
+
+
+