[or-cvs] r8361: First attempt to document the process to build Win32 executa (tor/trunk/doc)

[phobos@xxxxxxxx]

Author: phobos
Date: 2006-09-10 23:46:00 -0400 (Sun, 10 Sep 2006)
New Revision: 8361

Added:
   tor/trunk/doc/tor-win32-mingw-creation.txt
Log:
First attempt to document the process to build Win32 executables with
mingw.  Relies upon magic to actually work right now.


Added: tor/trunk/doc/tor-win32-mingw-creation.txt
===================================================================
--- tor/trunk/doc/tor-win32-mingw-creation.txt	2006-09-10 22:30:00 UTC (rev 8360)
+++ tor/trunk/doc/tor-win32-mingw-creation.txt	2006-09-11 03:46:00 UTC (rev 8361)
@@ -0,0 +1,88 @@
+Instructions for building Tor with MinGW (http://www.mingw.org/)
+
+Stage One:  Download and Install MinGW.
+---------------------------------------
+
+Download mingw:
+http://prdownloads.sf.net/mingw/MSYS-1.0.10.exe?download
+
+Download the mingw developer tool kit:
+http://prdownloads.sf.net/mingw/msysDTK-1.0.1.exe?download
+
+Install mingw and mingw-dtk.
+
+Stage Two: Download, extract, and patch libevent-1.1b.
+------------------------------------------------------
+
+Download libevent-1.1b:
+http://www.monkey.org/~provos/libevent/
+
+Start up MSYS:
+Start -> Programs -> MinGW -> MSYS -> msys
+
+Create a directory to work within, for example, /c/tor-mingw.
+
+Copy libevent and tor tarballs into this working dir:
+cp /path/to/libevent-1.1b.tar.gz /c/tor-mingw/
+cp /patch/to/tor-alpha.tar.gz /c/tor-mingw/
+cd /c/tor-mingw/
+
+Extract libevent: tar zxf libevent-1.1b.tar.gz
+Extract tor: tar zxf tor-alpha.tar.gz
+
+Copy the libevent-1.1b diff into libevent-1.1b:
+cp /c/tor-mingw/tor/Win32Build/mingw/libevent-1.1b-mingw-custom.diff /c/tor-mingw/libevent-1.1b/
+patch -i libevent-1.1b-mingw-custom.diff
+
+Your output of the "patch" command should be similar to:
+"patch -i libevent-1.1b-mingw-custom.diff 
+patching file `Makefile.am'
+can't find file to patch at input line 49
+Perhaps you should have used the -p or --strip option?
+The text leading up to this was:
+--------------------------
+|Only in libevent-1.1b: Makefile.in
+|diff -uwr libevent-1.1b-old/WIN32-Code/misc.c libevent-1.1b/WIN32-Code/misc.c
+|--- libevent-1.1b-old/WIN32-Code/misc.c        Wed Aug  9 21:01:14 2006
+|+++ libevent-1.1b/WIN32-Code/misc.c    Fri Sep  1 22:21:31 2006
+--------------------------
+File to patch: WIN32-Code/misc.c
+patching file `WIN32-Code/misc.c'
+can't find file to patch at input line 65
+Perhaps you should have used the -p or --strip option?
+The text leading up to this was:
+--------------------------
+|diff -uwr libevent-1.1b-old/WIN32-Code/misc.h libevent-1.1b/WIN32-Code/misc.h
+|--- libevent-1.1b-old/WIN32-Code/misc.h        Wed Aug  9 21:01:14 2006
+|+++ libevent-1.1b/WIN32-Code/misc.h    Fri Sep  1 18:47:09 2006
+--------------------------
+File to patch: WIN32-Code/misc.h
+patching file `WIN32-Code/misc.h'
+can't find file to patch at input line 78
+Perhaps you should have used the -p or --strip option?
+The text leading up to this was:
+--------------------------
+|diff -uwr libevent-1.1b-old/WIN32-Code/win32.c
+libevent-1.1b/WIN32-Code/win32.c
+|--- libevent-1.1b-old/WIN32-Code/win32.c       Wed Aug  9 21:25:48 2006
+|+++ libevent-1.1b/WIN32-Code/win32.c   Sat Sep  2 00:45:55 2006
+--------------------------
+File to patch: WIN32-Code/win32.c
+patching file `WIN32-Code/win32.c'
+patching file `buffer.c'
+patching file `config.h.in'
+patching file `configure.in'
+patching file `evbuffer.c'
+patching file `event.c'
+patching file `log.c' "
+
+Stage 3:  Build libevent-1.1b DLL
+---------------------------------
+
+Run "aclocal && autoheader && automake && autoconf".
+There may be WARNING messages.  There will be no output if all runs successfuly.
+
+Run "./configure"
+Run "make"
+
+(magic happens here and a complete tor-alpha.exe is created)