Synchronize with trunk r58457.
[reactos.git] / INSTALL
1 1. Build environment
2
3 To build the system you need either mingw32 installed on Windows or a mingw32
4 cross compiler running on unix. You may obtain MinGW binaries that build
5 ReactOS from http://www.reactos.org/.
6
7
8 2. Building ReactOS
9
10 2.1 Building the binaries
11
12 To build ReactOS run 'make' (without the quotes) if you are building on Linux
13 or 'mingw32-make' if you are building on Windows (or ReactOS) from the top
14 directory. If you are using RosBE, follow on-screen instructions.
15
16
17 2.2 Building a bootable CD image
18
19 To build a bootable CD image run 'make bootcd' (without the quotes) if you are
20 building on Linux or 'mingw32-make bootcd' if you are building on Windows (or
21 ReactOS) from the top directory. This will create a CD image with a filename,
22 ReactOS.iso, in the top directory.
23
24
25 3. Installation
26
27 ReactOS can only be installed on a machine that has a FAT16 or FAT32 partition
28 as the active (bootable) partition. The partition on which ReactOS is to be
29 installed (which may or may not be the bootable partition) must also be
30 formatted as FAT16 or FAT32. ReactOS Setup can format the partitions if
31 needed.
32
33 ReactOS can be installed from the source distribution or from the bootable CD
34 distribution. The two ways to install ReactOS are explained below.
35
36
37 3.1 Installation from sources
38
39 If you don't have an existing ReactOS installation you want to upgrade, then
40 build a bootable CD as described above. Burn the CD image, boot from it, and
41 follow the instructions to install ReactOS.
42
43 If you have an existing ReactOS installation you want to upgrade, then to
44 install ReactOS after building it, type 'make install' or
45 'mingw32-make install'. This will create the directory 'reactos' in the top
46 directory. Copy the contents of this directory over the existing installation.
47
48 If you don't want to copy the files manually every time you run a
49 'make install' or 'mingw32-make install', then you can specify the directory
50 where the files are to be copied to during installation.
51
52 Set the ROS_INSTALL environment variable. If you are on Windows this could be
53 done by:
54
55 set ROS_INSTALL=c:\reactos
56
57 If you are on Linux this could be done by:
58
59 export ROS_INSTALL=/mnt/windows/reactos
60
61 Now run 'make install' or 'mingw32-make install' to install the files to the
62 new location.
63
64
65 3.2 Installation from bootable CD distribution
66
67 To install ReactOS from the bootable CD distribution, extract the archive
68 contents. Then burn the CD image, boot from it, and follow instructions.
69
70
71 5. Help
72
73 If you run into problems or have suggestions for making ReactOS better, please
74 visit the address below. Mailing lists are available for a variety of topics,
75 bugs should be submitted to bugzilla and general chat takes place in the forums,
76 or #reactos on freenode
77
78 http://www.reactos.org/
79
80 ReactOS Development Team