37 <blockquote> |
37 <blockquote> |
38 <ul> |
38 <ul> |
39 <li><a href="#introduction">Introduction</a></li> |
39 <li><a href="#introduction">Introduction</a></li> |
40 <li><a href="#MBE">Minimum Build Environments</a></li> |
40 <li><a href="#MBE">Minimum Build Environments</a></li> |
41 <li><a href="#SDBE">Specific Developer Build Environments</a></li> |
41 <li><a href="#SDBE">Specific Developer Build Environments</a></li> |
|
42 <ul> |
|
43 <li><a href="#fedora">Fedora Linux</a> </li> |
|
44 <li><a href="#centos">CentOS Linux</a> </li> |
|
45 <li><a href="#ubuntu">Ubuntu Linux</a> </li> |
|
46 </ul> |
42 <li><a href="#directories">Source Directory Structure</a> </li> |
47 <li><a href="#directories">Source Directory Structure</a> </li> |
43 <li><a href="#building">Build Information</a> |
48 <li><a href="#building">Build Information</a> |
44 <ul> |
49 <ul> |
45 <li><a href="#gmake">GNU Make (<tt><i>gmake</i></tt>)</a> </li> |
50 <li><a href="#gmake">GNU Make (<tt><i>gmake</i></tt>)</a> </li> |
46 <li><a href="#linux">Basic Linux System Setup</a> </li> |
51 <li><a href="#linux">Basic Linux System Setup</a> </li> |
180 <blockquote> |
185 <blockquote> |
181 We won't be listing all the possible environments, but |
186 We won't be listing all the possible environments, but |
182 we will try to provide what information we have available to us. |
187 we will try to provide what information we have available to us. |
183 </blockquote> |
188 </blockquote> |
184 <!-- ------------------------------------------------------ --> |
189 <!-- ------------------------------------------------------ --> |
185 <h3><a name="fedora">Fedora</a></h3> |
190 <h3><a name="fedora">Fedora 9</a></h3> |
186 <blockquote> |
191 <blockquote> |
187 TBD |
192 After installing |
188 </blockquote> |
193 <a href="http://www.fedoraproject.org/">Fedora 9</a> |
189 <!-- ------------------------------------------------------ --> |
194 you need to make sure you have |
190 <h3><a name="debian">Debian</a></h3> |
195 the "Software Development" bundle installed, plus the |
191 <blockquote> |
196 following packages: |
192 TBD |
197 <blockquote> |
|
198 <ul> |
|
199 <li>cups devel: Cups Development Package</li> |
|
200 <li>freetype 2.3+ devel: Freetype 2.3 Development Package</li> |
|
201 <li>hg: Mercurial, if you need to clone or manage source repositories</li> |
|
202 <li>ksh: May be needed when using <tt>webrev</tt></li> |
|
203 </ul> |
|
204 </blockquote> |
|
205 <p> |
|
206 Always a good idea to do a complete Software Update/Refresh |
|
207 after you get all the packages installed. |
|
208 </blockquote> |
|
209 <!-- ------------------------------------------------------ --> |
|
210 <h3><a name="centos">CentOS 5.2</a></h3> |
|
211 <blockquote> |
|
212 After installing |
|
213 <a href="http://www.centos.org/">CentOS 5.2</a> |
|
214 you need to make sure you have |
|
215 the following Development bundles installed: |
|
216 <blockquote> |
|
217 <ul> |
|
218 <li>Development Libraries</li> |
|
219 <li>Development Tools</li> |
|
220 <li>Java Development</li> |
|
221 <li>X Software Development</li> |
|
222 </ul> |
|
223 </blockquote> |
|
224 <p> |
|
225 Plus the following packages: |
|
226 <blockquote> |
|
227 <ul> |
|
228 <li>cups devel: Cups Development Package</li> |
|
229 <li>alsa devel: Alsa Development Package</li> |
|
230 <li>ant: Ant Package</li> |
|
231 <li>Xi devel: libXi.so Development Package</li> |
|
232 </ul> |
|
233 </blockquote> |
|
234 <p> |
|
235 The freetype 2.3 packages don't seem to be available, |
|
236 but the freetype 2.3 sources can be downloaded, built, |
|
237 and installed easily enough from |
|
238 <a href="http://downloads.sourceforge.net/freetype"> |
|
239 the freetype site</a>. |
|
240 Build and install with something like: |
|
241 <blockquote> |
|
242 <tt>./configure && make && sudo -u root make install</tt> |
|
243 </blockquote> |
|
244 <p> |
|
245 Mercurial packages could not be found easily, but a Google |
|
246 search should find ones, and they usually include Python if |
|
247 it's needed. |
193 </blockquote> |
248 </blockquote> |
194 <!-- ------------------------------------------------------ --> |
249 <!-- ------------------------------------------------------ --> |
195 <h3><a name="ubuntu">Ubuntu</a></h3> |
250 <h3><a name="ubuntu">Ubuntu</a></h3> |
196 <blockquote> |
251 <blockquote> |
197 In addition to needing the Bootstrap JDK and the Binary Plugs, |
252 In addition to needing the Bootstrap JDK and the Binary Plugs, |
662 <a href="#importjdk">Optional Import JDK</a>, set |
717 <a href="#importjdk">Optional Import JDK</a>, set |
663 <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>. |
718 <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>. |
664 </li> |
719 </li> |
665 <li> |
720 <li> |
666 Install the |
721 Install the |
667 <a href="#msvc">Microsoft Visual Studio .NET 2003 Professional</a> or the |
722 <a href="#msvc">Microsoft Visual Studio .NET 2003 Professional</a> (32bit) or the |
668 <a href="#mssdk">Microsoft Platform SDK</a>. |
723 <a href="#mssdk">Microsoft Platform SDK</a> (64bit). |
669 </li> |
724 </li> |
670 <li> |
725 <li> |
671 Setup all environment variables for compilers |
726 Setup all environment variables for compilers |
672 (see <a href="#msvc">compilers</a>). |
727 (see <a href="#msvc">compilers</a>). |
673 </li> |
728 </li> |
869 The above environment variables <b>MUST</b> be set. |
924 The above environment variables <b>MUST</b> be set. |
870 <p> |
925 <p> |
871 The Microsoft Visual Studio .NET 2005 (VS2005) compiler |
926 The Microsoft Visual Studio .NET 2005 (VS2005) compiler |
872 will not work at this time due to the new runtime dll |
927 will not work at this time due to the new runtime dll |
873 and the manifest requirements. |
928 and the manifest requirements. |
|
929 <p> |
|
930 <b>WARNING:</b> Make sure you check out the |
|
931 <a href="#cygwin">CYGWIN link.exe WARNING</a>. |
|
932 The path <tt>/usr/bin</tt> must be after the path to the |
|
933 Visual Studio product. |
874 </blockquote> |
934 </blockquote> |
875 <strong><a name="mssdk">Windows X64: Microsoft Platform SDK April 2005</a></strong> |
935 <strong><a name="mssdk">Windows X64: Microsoft Platform SDK April 2005</a></strong> |
876 <blockquote> |
936 <blockquote> |
877 On <b>X64</b>, the Microsoft Platform Software |
937 On <b>X64</b>, the Microsoft Platform Software |
878 Development Kit (SDK), April 2005 Edition compiler, |
938 Development Kit (SDK), April 2005 Edition compiler, |
1077 <blockquote> |
1137 <blockquote> |
1078 <table border="1"> |
1138 <table border="1"> |
1079 <thead> |
1139 <thead> |
1080 <tr> |
1140 <tr> |
1081 <td>Binary Name</td> |
1141 <td>Binary Name</td> |
|
1142 <td>Category</td> |
1082 <td>Package</td> |
1143 <td>Package</td> |
1083 <td>Description</td> |
1144 <td>Description</td> |
1084 </tr> |
1145 </tr> |
1085 </thead> |
1146 </thead> |
1086 <tbody> |
1147 <tbody> |
1087 <tr> |
1148 <tr> |
1088 <td>ar.exe</td> |
1149 <td>ar.exe</td> |
1089 <td>Devel</td> |
1150 <td>Devel</td> |
1090 <td>binutils: The GNU assembler, linker and binary |
1151 <td>binutils</td> |
|
1152 <td>The GNU assembler, linker and binary |
1091 utilities</td> |
1153 utilities</td> |
1092 </tr> |
1154 </tr> |
1093 <tr> |
1155 <tr> |
1094 <td>make.exe</td> |
1156 <td>make.exe</td> |
1095 <td>Devel</td> |
1157 <td>Devel</td> |
1096 <td>make: The GNU version of the 'make' utility<br> |
1158 <td>make</td> |
|
1159 <td>The GNU version of the 'make' utility built for CYGWIN.<br> |
1097 <b>NOTE</b>: See <a href="#gmake">the GNU make section</a></td> |
1160 <b>NOTE</b>: See <a href="#gmake">the GNU make section</a></td> |
1098 </tr> |
1161 </tr> |
1099 <tr> |
1162 <tr> |
1100 <td>m4.exe</td> |
1163 <td>m4.exe</td> |
1101 <td>Interpreters</td> |
1164 <td>Interpreters</td> |
1102 <td>m4: GNU implementation of the traditional Unix macro |
1165 <td>m4</td> |
|
1166 <td>GNU implementation of the traditional Unix macro |
1103 processor</td> |
1167 processor</td> |
1104 </tr> |
1168 </tr> |
1105 <tr> |
1169 <tr> |
1106 <td>cpio.exe</td> |
1170 <td>cpio.exe</td> |
1107 <td>Utils</td> |
1171 <td>Utils</td> |
1108 <td>cpio: A program to manage archives of files</td> |
1172 <td>cpio</td> |
|
1173 <td>A program to manage archives of files</td> |
1109 </tr> |
1174 </tr> |
1110 <tr> |
1175 <tr> |
1111 <td>gawk.exe</td> |
1176 <td>gawk.exe</td> |
1112 <td>Utils</td> |
1177 <td>Utils</td> |
1113 <td>awk: Pattern-directed scanning and processing language</td> |
1178 <td>awk</td> |
|
1179 <td>Pattern-directed scanning and processing language</td> |
1114 </tr> |
1180 </tr> |
1115 <tr> |
1181 <tr> |
1116 <td>file.exe</td> |
1182 <td>file.exe</td> |
1117 <td>Utils</td> |
1183 <td>Utils</td> |
1118 <td>file: Determines file type using 'magic' numbers</td> |
1184 <td>file</td> |
|
1185 <td>Determines file type using 'magic' numbers</td> |
1119 </tr> |
1186 </tr> |
1120 <tr> |
1187 <tr> |
1121 <td>zip.exe</td> |
1188 <td>zip.exe</td> |
1122 <td>Archive</td> |
1189 <td>Archive</td> |
1123 <td>zip: Package and compress (archive) files</td> |
1190 <td>zip</td> |
|
1191 <td>Package and compress (archive) files</td> |
1124 </tr> |
1192 </tr> |
1125 <tr> |
1193 <tr> |
1126 <td>unzip.exe</td> |
1194 <td>unzip.exe</td> |
1127 <td>Archive</td> |
1195 <td>Archive</td> |
1128 <td>unzip: Extract compressed files in a ZIP archive</td> |
1196 <td>unzip</td> |
|
1197 <td>Extract compressed files in a ZIP archive</td> |
1129 </tr> |
1198 </tr> |
1130 <tr> |
1199 <tr> |
1131 <td>free.exe</td> |
1200 <td>free.exe</td> |
1132 <td>Procps</td> |
1201 <td>System</td> |
1133 <td>free: Display amount of free and used memory in the system</td> |
1202 <td>procps</td> |
|
1203 <td>Display amount of free and used memory in the system</td> |
1134 </tr> |
1204 </tr> |
1135 </tbody> |
1205 </tbody> |
1136 </table> |
1206 </table> |
1137 </blockquote> |
1207 </blockquote> |
1138 <p> |
1208 <p> |
1142 <a href="http://cygwin.com/faq/faq.using.html" target="_blank">FAQ</a> for |
1212 <a href="http://cygwin.com/faq/faq.using.html" target="_blank">FAQ</a> for |
1143 known issues and problems, of particular interest is the |
1213 known issues and problems, of particular interest is the |
1144 section on |
1214 section on |
1145 <a href="http://cygwin.com/faq/faq.using.html#faq.using.bloda" target="_blank"> |
1215 <a href="http://cygwin.com/faq/faq.using.html#faq.using.bloda" target="_blank"> |
1146 BLODA (applications that interfere with CYGWIN)</a>. |
1216 BLODA (applications that interfere with CYGWIN)</a>. |
|
1217 <p> |
|
1218 <b>WARNING:</b> |
|
1219 Be very careful with <b><tt>link.exe</tt></b>, it will conflict |
|
1220 with the Visual Studio version. You need the Visual Studio |
|
1221 version of <tt>link.exe</tt>, not the CYGWIN one. |
|
1222 So it's important that the Visual Studio paths in PATH preceed |
|
1223 the CYGWIN path <tt>/usr/bin</tt>. |
1147 </blockquote> |
1224 </blockquote> |
1148 <strong><a name="dxsdk">Microsoft DirectX 9.0 SDK header files and libraries</a></strong> |
1225 <strong><a name="dxsdk">Microsoft DirectX 9.0 SDK header files and libraries</a></strong> |
1149 <blockquote> |
1226 <blockquote> |
1150 Microsoft DirectX 9.0 SDK (Summer 2004) |
1227 Microsoft DirectX 9.0 SDK (Summer 2004) |
1151 headers are required for building |
1228 headers are required for building |