README.win32

   1 Tennix can now be built on win32! :)
   2
   3 Guide on installing SDL + MSYS + MinGW on Win32:
   4 http://www.netadelica.com/coding/sdl/install.html
   5
   6 Cross-compiling on a Debian System (untested!)
   7 http://wiki.njh.eu/MinGW-Cross-Compiling_mit_SDL
   8
   9 You also need the win32 development packages of
  10 SDL_mixer, SDL_image and SDL_ttf, these can be found here:
  11
  12 http://www.libsdl.org/projects/SDL_mixer/
  13 http://www.libsdl.org/projects/SDL_image/
  14 http://www.libsdl.org/projects/SDL_ttf/
  15
  16 For these libraries, copy the *.h files
  17 to c:\mingw\include\SDL\ and the *.lib files to
  18 c:\mingw\lib\. The .dll files have to be copied
  19 to the tennix source folder, so they can be
  20 found and copied to the binary release archive.
  21
  22
  23 You should also consider installing UPX and ZIP
  24 into your $PATH, so the .exe file can be compressed
  25 and the "zip" utility (from InfoZIP) is needed for
  26 the "release-win32" makefile target, which will create
  27 a zipfile with the binary release, ready to be distributed :)
  28
  29 =====================
  30 Additional notes on Git + Win32 resources + InnoSetup
  31 =====================
  32 ** GIT **
  33 You can download and bootstrap Git ported to Windows from
  34 http://code.google.com/p/msysgit/. Simply download the
  35 "GitMe-0.4.2.exe" (or newer) and run it to install Git and
  36 a local version of msys to c:\msysgit\.
  37
  38 You will be able to use Git on tennix's public repository,
  39 see the Tennix website for more information.
  40
  41 ** Win32 resources **
  42 We are now using Win32 resource files to have an icon in the
  43 Windows executable an to store the layout of the startup
  44 dialog (that is only displayed in Windows atm).
  45
  46 I've edited the "tennix.res" file (which contains the icon and
  47 the dialog layout) with "XN Resource Editor", which is a freeware
  48 resource editor for Windows, but you might want to use another
  49 resource editor of you choice.
  50
  51 URL: http://www.wilsonc.demon.co.uk/d10resourceeditor.htm
  52
  53 ** InnoSetup **
  54 Make sure you have installed InnoSetup 5 if you
  55 want to generate a setup installer. You also have to set
  56 the $PATH variable to point to the Inno Setup install dir
  57 on your hard drive (eg c:\program files\inno setup 5\).
  58 To check if you have set it up correctly, open your msys
  59 shell and type "iscc". It should respond with "Inno Setup
  60 5 Command-Line Compiler" and some generic information.
  61
  62 When you have set up iscc correctly, simply do a "make
  63 release-win32-setup" to compile a single setup executable
  64 with innosetup and tennix.
  65
  66 Thomas Perl <thp@perli.net>, 2007-11-21
  67 =====================
  68
  69
  70 #######======------ --- -- -  -
  71 Additional notes on libraries on Win32
  72 #######======------ --- -- -  -
  73
  74 You might have to add some libraries for Tennix 1.0 (and later) to compile
  75 correctly under mingw32:
  76
  77   -lws2_32 -lkernel32
  78
  79 This can be set as LDFLAGS and/or LIBS variable in the makefile. For some
  80 specific makefile targets (e.g. the "archive" utility), you might have to
  81 specify "-lws2_32" directly in the target to get the build going.
  82
  83 #######======------ --- -- -  -
  84