updated COMPILING
[xonotic/netradiant.git] / COMPILING
1 developer documentation for GtkRadiant 1.5.0
2 ============================================
3
4 getting the source
5 ==================
6
7 The latest source is available from the Subversion repository.
8   https://zerowing.idsoftware.com/svn/radiant/GtkRadiant/trunk/
9
10 The subversion client can be obtained from the Subversion site.
11   http://subversion.tigris.org
12
13 To get a copy of the source using the commandline Subversion client:
14   Change the current directory to the desired location for the source.
15   svn checkout https://zerowing.idsoftware.com/svn/radiant/GtkRadiant/trunk/ ./GtkRadiant
16   svn checkout https://zerowing.idsoftware.com/svn/radiant.gamepacks/Q3Pack/trunk/ ./GtkRadiant/games/Q3Pack
17
18
19
20 Linux/OSX(using X-windows)
21 ==========================
22
23 environment:
24 - gcc3 (preferably)
25 - scons = 0.96 (radiant is built with scons rather than make)
26 - python >= 2.3.0 (scons requires python, some build steps use python)
27 - svn >= 1.1 (some build steps use svn)
28
29 dependencies:
30 - gtk+ >= 2.4.0 (requires glib, atk, pango, iconv, etc)
31 - gtkglext >= 1.0.0 (requires opengl)
32 - libxml2 >= 2.0.0
33 - zlib >= 1.2.0 (for archivezip module)
34 - libpng >= 1.2.0 (for imagepng module)
35 - libmhash = 0.9.0 (for q3map2)
36
37 build:
38 Execute 'scons SETUP=0' in the directory containing SConscript
39
40 install:
41 run 'python ./GtkRadiant/install.py'
42 note - this script should be run after each time you update from svn
43
44 run:
45 Execute './GtkRadiant/install/radiant.x86' (or './GtkRadiant/install/radiant.ppc' on osx)
46
47
48
49 Win32 (2000 or XP)
50 ==================
51
52 environment:
53 - visual studio .net 2003
54 - microsoft c++ compiler 7.1 (comes with vs.net 2003)
55 - python 2.3.0 or later (some build steps use python)
56 - subversion 1.1 or later (some build steps use svn)
57
58 dependencies are prepackaged archives, extract them to the directory above GtkRadiant.sln:
59 - http://zerowing.idsoftware.com/files/radiant/developer/1.5/gtk2-2.4.14.zip (gtk-wimp, gtkglext, gtk, glib, atk, pango, iconv etc)
60 - http://zerowing.idsoftware.com/files/radiant/developer/1.5/libxml2-2.6.2.zip
61 - http://zerowing.idsoftware.com/files/radiant/developer/1.5/STLport-4.6.2.zip
62 - http://zerowing.idsoftware.com/files/radiant/developer/1.5/zlib1-1.2.1.zip (for archivezip module)
63 - http://zerowing.idsoftware.com/files/radiant/developer/1.5/libpng-1.2.5.zip (for imagepng module)
64 - http://zerowing.idsoftware.com/files/radiant/developer/1.5/mhash-0.9.1.zip (for q3map2)
65 - http://zerowing.idsoftware.com/files/radiant/developer/1.5/msvc_redist.zip (msvc runtime libraries)
66
67 build:
68 Open GtkRadiant.sln.
69 In tools > options > projects > VC++ Directories > executables, add the paths to python.exe (e.g. c:\python23\) and svn.exe (e.g. c:\svn\) 
70 Hit 'Build > Build Solution' (F7)
71
72 install:
73 run 'python ./GtkRadiant/install.py'
74 note - this script should be run after each time you update from svn
75
76 run:
77 set Project > Properties > Debugging > Command to "$(SolutionDir)install/$(TargetFileName)"
78 hit 'Debug > Start' (F5)