- <a name="mingw"></a>
- <h2>Section 1: Installing MinGW</h2>
- <p>The following URL can be used as a coarse guide for installing MinGW:
- <a href="http://www.mingw.org/wiki/Getting_Started">http://www.mingw.org/wiki/Getting_Started</a>.
- The needed steps are reproduced below.
- </p>
- <h3>Step A: Download</h3>
- <p>Download the <tt>mingw-get</tt> program. We're going to use <tt>mingw-get</tt>
- as opposed to the graphical installer <tt>mingw-get-inst</tt> . You can download the most
- recent version of <tt>mingw-get</tt> from
- <a href="http://sourceforge.net/projects/mingw/files/Installer/mingw-get/">this SourceForge page</a>.
- (That page also contains a <tt>readme.txt</tt> file that has very useful information on how to use
- <tt>mingw-get</tt> , for your reading pleasure.) Download the binary zip file version;
- the downloaded file should have a name along the lines of <tt>mingw-get-0.1-mingw32-alpha-5-bin.zip</tt> .
- </p>
- <h3>Step B: Extract</h3>
- <p>
- Extract the zip file you just downloaded to <tt>C:\MinGW</tt> . I would use that exact location; I will be referring to
- that location in the rest of the instructions. <font color="#ff0000">If you choose a different location, make sure that there is no space in
- the path.</font> After extraction, double check that there exists a file
- <tt>C:\MinGW\bin\mingw-get.exe</tt> . If such a file does not exist, you extracted at an incorrect level or you downloaded
- the wrong zip archive.
- </p>
- <h3>Step C: Set <tt>PATH</tt></h3>
- <p>
- You need to add <tt>C:\MinGW\bin</tt> to your <tt>PATH</tt> system environment variable. Don't forget that the semicolon
- character is the separator for the elements in <tt>PATH</tt> . The steps to find where <tt>PATH</tt> can be edited are roughly
- as follows on Windows XP:
- </p>
- <ol>
- <li>Go to Control Panel (usually in Start menu).</li>
- <li>In Control Panel, go to System.</li>
- <li>Hit "Advanced" tab.</li>
- <li>Hit "Environment Variables" button.</li>
- <li>Near the bottom, under "System variables", highlight "Path" and click "Edit".</li>
- <li>Tack on the string "C:\MinGW\bin" to the end, making sure to use a semicolon to separate the existing <tt>PATH</tt> from
- your new entry.</li>
- <li>Reboot? (I don't know if it's necessary.)</li>
- </ol>
- <h3>Step D: Update/Upgrade</h3>
- <p>
- We're going to update the <tt>mingw-get</tt> program with the latest version and pull in the latest distribution manifest.
- Open up Command Prompt. Execute the following commands:
- </p>
- <blockquote>
- <pre width="80" style="background: #CCCCCC; padding: 2mm; border-style: ridge">C:\MinGW> <b>mingw-get update</b>
-C:\MinGW> <b>mingw-get upgrade mingw-get</b>
-</pre>
- </blockquote>
- <p>
- The above commands can be executed from any directory; <tt>C:\MinGW</tt> happened to be the currect directory in my case.
- </p>
- <p>
- Note: If you execute <tt>mingw-get</tt> without any arguments, you might get an unpleasant-looking error.
- This is normal.
- </p>
- <p>
- We're all done installing the base of the MinGW system. You don't need to install any additional <tt>mingw-*</tt> packages
- to get GtkRadiant to compile (because we're using different software to actually compile GtkRadiant).
- </p>
- <hr />
- <br />
- <a name="msys"></a>
- <h2>Section 2: Installing MSYS</h2>
- <p>We're now going to install MSYS, which sits on top of MinGW.</p>
- <h3>Step A: Install <tt>msys-base</tt></h3>
- <p>
- Open up Command Prompt. Execute the following command:
- </p>
- <blockquote>
- <pre width="80" style="background: #CCCCCC; padding: 2mm; border-style: ridge">C:\MinGW> <b>mingw-get install msys-base</b>
-</pre>
- </blockquote>
- <p>You can now close the Command Prompt. You won't have to use it again!</p>
- <h3>Step B: Fire Up MSYS</h3>
- <p>
- In your native file exploring application in Windows, navigate to <tt>C:\MinGW\msys\1.0</tt> . Here you will find
- a file <tt>msys.bat</tt> . This script is what launches MSYS. You can make a shortcut to this file and place the shortcut
- in a convenient location such as your Desktop. You can also use the provided icon <tt>msys.ico</tt> (in the same
- directory) for your shortcut icon.
- </p>
- <p>
- Now start MSYS by double-clicking <tt>msys.bat</tt> (or your shortcut). We will use MSYS to install some remaining packages that are needed.
- In case you are completely new to MSYS, I'd like to point out that it's much like a UNIX shell.
- In fact you can access the <tt>C:</tt> Windows drive in MSYS via the <tt>/c</tt> path.
- </p>
- <h3>Step C: Install MSYS Additions</h3>
- <p>
- There are many MinGW/MSYS packages you can install; you may even choose to install all of them.
- However, for the purposes of compiling GtkRadiant, you will need only the following. Execute this
- from your MSYS shell:
- </p>
- <blockquote>
- <pre width="80" style="background: #CCCCCC; padding: 2mm; border-style: ridge">$ <b>mingw-get install msys-wget</b>
-$ <b>mingw-get install msys-unzip</b>
-</pre>
- </blockquote>
- <p>You should now have the two commands <tt>wget</tt> and <tt>unzip</tt> at your disposal in the MSYS shell.
- We will be needing these commands to successfully execute the SCons build target later on.</p>
- <p>You can leave your MSYS shell open because we will use it again in a little while.</p>
- <p>Side Note: The <tt>msys-openssh</tt> package comes with traditional <tt>scp</tt> and <tt>ssh</tt> commands that work
- orders of magnitude faster than WinSCP or PuTTY.</p>
- <hr />
- <br />