You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

3195 lines
95KB

  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta http-equiv="content-type" content="text/html; charset=utf-8">
  5. <title>MXE (M cross environment)</title>
  6. <link rel="stylesheet" href="assets/common.css">
  7. </head>
  8. <body>
  9. <div id="navigation">
  10. <h1>MXE (M&nbsp;cross&nbsp;environment)</h1>
  11. <ul>
  12. <li><a href="#introduction" >Introduction</a></li>
  13. <li><a href="#screenshots" >Screenshots</a></li>
  14. <li><a href="#tutorial" >Tutorial</a></li>
  15. <li><a href="#download" >Download</a></li>
  16. <li><a href="https://lists.nongnu.org/mailman/listinfo/mingw-cross-env-list">Mailing List</a></li>
  17. <li><a href="https://github.com/mxe/mxe/issues">Issue Tracker</a></li>
  18. </ul>
  19. <ul>
  20. <li><a href="#requirements" >Requirements</a></li>
  21. <li><a href="#usage" >Usage</a></li>
  22. <li><a href="#packages" >List of Packages</a></li>
  23. <li><a href="#creating-packages">Creating Packages</a></li>
  24. <li><a href="#copyright" >Copyright</a></li>
  25. <li><a href="#legal" >Legal</a></li>
  26. <li><a href="#history" >History</a></li>
  27. </ul>
  28. <ul>
  29. <li><a href="#see-also" >See also</a></li>
  30. <li><a href="#used-by" >Used by</a></li>
  31. </ul>
  32. </div>
  33. <div class="section">
  34. <h2 id="introduction">Introduction</h2>
  35. <p>
  36. MXE (M cross environment) is a Makefile that
  37. compiles a cross compiler and cross compiles
  38. many free libraries such as SDL and Qt. Thus,
  39. it provides a nice cross compiling environment
  40. for various target platforms, which
  41. </p>
  42. <ul>
  43. <li>
  44. is designed to
  45. <a href="#requirements">run on any Unix system</a>
  46. </li>
  47. <li>
  48. is easy to adapt and to extend
  49. </li>
  50. <li>
  51. builds
  52. <a href="#packages">many free libraries</a>
  53. in addition to the cross compiler
  54. </li>
  55. <li>
  56. can also
  57. <a href="#usage">build just a subset</a>
  58. of the packages,
  59. and automatically builds their dependencies
  60. </li>
  61. <li>
  62. downloads all needed packages
  63. and verifies them by their checksums
  64. </li>
  65. <li>
  66. is able to update the version numbers of all packages automatically
  67. </li>
  68. <li>
  69. directly uses source packages,
  70. thus ensuring the whole build mechanism is transparent
  71. </li>
  72. <li>
  73. allows inter-package and intra-package
  74. <a href="#usage">parallel builds</a>
  75. whenever possible
  76. </li>
  77. <li>
  78. bundles <a href="https://ccache.samba.org">ccache</a> to speed
  79. up repeated builds
  80. </li>
  81. <li>
  82. integrates well with <a href="#tutorial-5a">autotools</a>,
  83. <a href="#tutorial-5b">cmake</a>, <a href="#tutorial-5c">qmake</a>,
  84. and <a href="#tutorial-5d">hand-written makefiles</a>
  85. </li>
  86. <li>
  87. has been in continuous development <a href="#history">since 2007</a>
  88. and is <a href="#used-by">used by several projects</a>
  89. </li>
  90. <li>
  91. has <a href="http://pkg.mxe.cc/">pre-compiled binaries</a>
  92. that <a href="https://github.com/zer0main/battleship">can be used
  93. in Continuous Integration systems</a>
  94. </li>
  95. </ul>
  96. <h3>Supported Toolchains</h3>
  97. <p>
  98. Compiler and runtime: MinGW-w64.
  99. </p>
  100. <table id="supported-toolchains">
  101. <tr>
  102. <th rowspan="2">Target OS</th>
  103. <th colspan="2">Packages</th>
  104. </tr>
  105. <tr>
  106. <th>Static</th>
  107. <th>Shared</th>
  108. </tr>
  109. <tr>
  110. <td>32 bit Windows</td>
  111. <td style='text-align:center'>99% (379/381)</td>
  112. <td style='text-align:center'>72% (273/381)</td>
  113. </tr>
  114. <tr>
  115. <td>64 bit Windows</td>
  116. <td style='text-align:center'>94% (360/381)</td>
  117. <td style='text-align:center'>71% (271/381)</td>
  118. </tr>
  119. </table>
  120. <p>
  121. These numbers were last updated on December 16, 2015.
  122. See the <a href="build-matrix.html">current status</a>
  123. for individual packages.
  124. </p>
  125. <p>
  126. Executables built for 32 bit Windows can be
  127. executed on 64 bit Windows as well.
  128. </p>
  129. <p>
  130. How to choose MXE target:
  131. </p>
  132. <ol>
  133. <li>If you want a 64 bit Windows executable,
  134. statically linked into one big executable:
  135. use MXE_TARGETS x86_64-w64-mingw32.static;</li>
  136. <li>If you want a 64 bit Windows executable,
  137. split into an executable and dependant dlls
  138. use MXE_TARGETS x86_64-w64-mingw32.shared;</li>
  139. <li>If you want a 32 bit Windows executable,
  140. statically linked into one big executable:
  141. use MXE_TARGETS i686-w64-mingw32.static;</li>
  142. <li>If you want a 32 bit Windows executable,
  143. split into an executable and dependant dlls
  144. use MXE_TARGETS i686-w64-mingw32.shared.</li>
  145. </ol>
  146. <p>
  147. Remark: The 'w64-mingw32' in those names are left-overs from
  148. historical evolutions in the open source cross-compilation world
  149. and refer in no way to the result being 64 or 32 bit Windows.
  150. </p>
  151. <p>
  152. OpenMP (<a href="https://gcc.gnu.org/projects/gomp/">libgomp</a>)
  153. and pthreads (<a href="https://mingw-w64.sourceforge.io/">winpthreads</a>)
  154. are always available.
  155. </p>
  156. <p>
  157. When building shared libraries, there are several approaches to
  158. recursively finding DLL dependencies (alphabetical list):
  159. </p>
  160. <ul>
  161. <li>
  162. <a href="https://github.com/desertbit/gml/blob/master/cmd/gml-copy-dlls/main.go">
  163. go script</a>
  164. </li>
  165. <li>
  166. <a href="https://github.com/gsauthof/pe-util">pe-util</a>
  167. packaged with
  168. <a href="https://github.com/mxe/mxe/blob/master/src/pe-util.mk">mxe</a>
  169. </li>
  170. <li>
  171. <a href="https://github.com/mxe/mxe/blob/master/tools/copydlldeps.py">python script</a>
  172. </li>
  173. <li>
  174. <a href="https://github.com/mxe/mxe/blob/master/tools/copydlldeps.md">shell script</a>
  175. </li>
  176. </ul>
  177. <p>
  178. Experimental support for GCC with posix threads was
  179. added in <a href="https://github.com/mxe/mxe/pull/958">November 2015</a>. Since <a href="https://github.com/mxe/mxe/pull/2263">January 2019</a> it is used by default.
  180. </p>
  181. <p>
  182. Experimental support for alternate GCC Exception Handling was
  183. added in <a href="https://github.com/mxe/mxe/pull/1664">February 2017</a>.
  184. </p>
  185. </div>
  186. <div class="section">
  187. <h2 id="screenshots">Screenshots</h2>
  188. <p>
  189. Cross compiling
  190. <a href="https://thebeez.home.xs4all.nl/4tH/">4tH</a>:
  191. </p>
  192. <a href="assets/screenshot-4th-compile.png">
  193. <img src="assets/screenshot-4th-compile-small.png" alt="4th-compile">
  194. </a>
  195. <p>
  196. and running it:
  197. </p>
  198. <a href="assets/screenshot-4th-run.png">
  199. <img src="assets/screenshot-4th-run-small.png" alt="4th-run">
  200. </a>
  201. </div>
  202. <div class="section">
  203. <h2 id="tutorial">Tutorial</h2>
  204. <h3 id="tutorial-1">Step 1: Requirements and Download</h3>
  205. <p>
  206. First, you should ensure that your system meets
  207. MXE's
  208. <a href="#requirements">requirements</a>.
  209. You will almost certainly have to install some stuff.
  210. </p>
  211. <p>
  212. When everything is fine, download the
  213. <a href="#download">current version</a>:
  214. </p>
  215. <pre>git clone https://github.com/mxe/mxe.git</pre>
  216. <p>
  217. If you don't mind installing it in your home directory,
  218. just skip the following step and go straight to step 3.
  219. </p>
  220. <p>
  221. MXE builds and installs everything under the same
  222. top-level directory and is not relocatable after
  223. the first packages are built.
  224. </p>
  225. <p>
  226. Due to limitations of GNU Make, the path of MXE is not allowed
  227. to contain any whitespace characters.
  228. </p>
  229. <h3 id="tutorial-2">Step 2: System-wide Installation (optional)</h3>
  230. <p>
  231. Now you should save any previous installation
  232. of the MXE.
  233. Assuming you've installed it under
  234. /opt/mxe (any other directory will do as well),
  235. you should execute the following commands:
  236. </p>
  237. <pre>su
  238. mv /opt/mxe /opt/mxe.old
  239. exit</pre>
  240. <p>
  241. Then you need to transfer the entire directory to its definitive location.
  242. We will assume again you use /opt/mxe,
  243. but feel free to use any other directory if you like.
  244. </p>
  245. <pre>su
  246. mv mxe /opt/mxe
  247. exit</pre>
  248. <p>
  249. We're almost done.
  250. Just change to your newly created directory and get going:
  251. </p>
  252. <pre>cd /opt/mxe</pre>
  253. <h3 id="tutorial-3">Step 3a: Build MXE</h3>
  254. <p>
  255. Enter the directory where you've downloaded MXE.
  256. Now it depends on what you actually want &ndash; or need.
  257. </p>
  258. <p>
  259. If you choose to enter:
  260. </p>
  261. <pre>make</pre>
  262. <p>
  263. you're in for a long wait,
  264. because it compiles
  265. <a href="#packages">a lot of packages</a>.
  266. On the other hand it doesn't require any intervention,
  267. so you're free to do whatever you like
  268. &ndash; like watch a movie or go for a night on the town.
  269. When it's done you'll find that you've installed
  270. a very capable Win32 cross compiler onto your system.
  271. </p>
  272. <p>
  273. If you only need the most basic tools you can also use:
  274. </p>
  275. <pre>make cc</pre>
  276. <p>
  277. and add any additional packages you need later on.
  278. You can also supply a host of packages on the
  279. <a href="#usage">command line</a>,
  280. e.g.:
  281. </p>
  282. <pre>make gtk lua libidn</pre>
  283. <p>
  284. Targets can also be specified on the command line.
  285. By default, only i686-w64-mingw32.static is built, but you can
  286. build your toolchain(s) of choice with:
  287. </p>
  288. <pre>make MXE_TARGETS='x86_64-w64-mingw32.static i686-w64-mingw32.static'</pre>
  289. <p>
  290. or by adjusting the <code>MXE_TARGETS</code> variable
  291. in <code>settings.mk</code>.
  292. </p>
  293. <p>
  294. You'll always end up with a consistent cross compiling environment.
  295. </p>
  296. <p>
  297. If you have trouble here, please feel free to
  298. contact the mxe team through the
  299. <a href="https://github.com/mxe/mxe/issues">issue tracker</a> or
  300. <a href="https://lists.nongnu.org/mailman/listinfo/mingw-cross-env-list">mailing list</a>.
  301. </p>
  302. <p>
  303. After you're done it just needs a little post-installation.
  304. </p>
  305. <h3 id="tutorial-3b">Step 3b: Install MXE from the binary distribution</h3>
  306. <p>
  307. Instead of building MXE packages from source, you can
  308. download precompiled packages. There are two options:
  309. tar archives and Debian packages.
  310. See <a href="http://pkg.mxe.cc/">pkg.mxe.cc</a>.
  311. </p>
  312. <h3 id="tutorial-4">Step 4: Environment Variables</h3>
  313. <p>
  314. Edit your .bashrc script in order to change $PATH:
  315. </p>
  316. <pre>export PATH=/<em>where MXE is installed</em>/usr/bin:$PATH</pre>
  317. <p>
  318. You may be tempted to also add <code>$(TARGET)/bin</code>
  319. to your path. You <strong>never</strong> want to do this,
  320. the executables and scripts in there will cause conflicts
  321. with your native toolchain.
  322. </p>
  323. <p>
  324. In case you are using custom $PKG_CONFIG_PATH entries,
  325. you can add separate entries for cross builds:
  326. </p>
  327. <pre>export PKG_CONFIG_PATH="<em>entries for native builds</em>"</pre>
  328. <pre>export PKG_CONFIG_PATH_i686_w64_mingw32_static="<em>entries for MXE builds</em>"</pre>
  329. <p>
  330. Remember to use i686-w64-mingw32.static-pkg-config
  331. instead of pkg-config for cross builds.
  332. The Autotools do that automatically for you.
  333. </p>
  334. <p>
  335. Note that any other compiler related environment variables
  336. (like $CC, $LDFLAGS, etc.)
  337. may spoil your compiling pleasure,
  338. so be sure to delete or disable those.
  339. </p>
  340. <p>
  341. For the most isolated and repeatable environment,
  342. use a white-list approach:
  343. </p>
  344. <pre>unset `env | \
  345. grep -vi '^EDITOR=\|^HOME=\|^LANG=\|MXE\|^PATH=' | \
  346. grep -vi 'PKG_CONFIG\|PROXY\|^PS1=\|^TERM=' | \
  347. cut -d '=' -f1 | tr '\n' ' '`</pre>
  348. <!-- update mxe-activate also -->
  349. <p>
  350. Congratulations!
  351. You're ready to cross compile anything you like.
  352. </p>
  353. <h3 id="tutorial-5a">Step 5a: Cross compile your Project (Autotools)</h3>
  354. <p>
  355. If you use the
  356. <a href="https://www.lrde.epita.fr/~adl/autotools.html">Autotools</a>,
  357. all you have to do is:
  358. </p>
  359. <pre>./configure --host=i686-w64-mingw32.static
  360. make</pre>
  361. <p>
  362. If you build a library, you might also want to enforce a static build:
  363. </p>
  364. <pre>./configure --host=i686-w64-mingw32.static --enable-static --disable-shared
  365. make</pre>
  366. <p>
  367. Don't worry about a warning like this:
  368. </p>
  369. <pre>configure: WARNING: If you wanted to set the --build type, don't use --host.
  370. If a cross compiler is detected then cross compile mode will be used.</pre>
  371. <p>
  372. Everything will be just fine.
  373. </p>
  374. <h3 id="tutorial-5b">Step 5b: Cross compile your Project (CMake)</h3>
  375. <p>
  376. If you have a
  377. <a href="https://www.cmake.org/">CMake</a> project,
  378. you can use the provided cmake wrapper:
  379. </p>
  380. <pre>i686-w64-mingw32.static-cmake ...</pre>
  381. <p>
  382. This will automatically use the MXE version of cmake
  383. and locate the toolchain file.
  384. </p>
  385. <h3 id="tutorial-5c">Step 5c: Cross compile your Project (Qt)</h3>
  386. <p>
  387. If you have a
  388. <a href="https://qt-project.org/">Qt</a> application,
  389. all you have to do is:
  390. </p>
  391. <pre>/where MXE is installed/usr/i686-w64-mingw32.static/qt/bin/qmake
  392. make</pre>
  393. <p>
  394. Note that Qt 4 is in the "qt" subdirectory. Qt 5 is in the "qt5" subdirectory
  395. and its qmake can be invoked similarly.
  396. </p>
  397. <p>
  398. If you are using Qt plugins
  399. such as the svg or ico image handlers,
  400. you should also have a look at the
  401. <a href="https://qt-project.org/doc/qt-4.8/plugins-howto.html#static-plugins">Qt documentation about static plugins</a>.
  402. </p>
  403. <p>
  404. Note the sql drivers (-qt-sql-*)
  405. and the image handlers for jpeg, tiff, gif and mng
  406. are built-in, <em>not</em> plugins.
  407. </p>
  408. <h3 id="tutorial-5d">Step 5d: Cross compile your Project (Makefile)</h3>
  409. <p>
  410. If you have a handwritten Makefile,
  411. you probably will have to make a few adjustments to it:
  412. </p>
  413. <pre>CC=$(CROSS)gcc
  414. LD=$(CROSS)ld
  415. AR=$(CROSS)ar
  416. PKG_CONFIG=$(CROSS)pkg-config</pre>
  417. <p>
  418. You may have to add a few others, depending on your project.
  419. </p>
  420. <p>
  421. Then, all you have to do is:
  422. </p>
  423. <pre>make CROSS=i686-w64-mingw32.static-</pre>
  424. <p>
  425. That's it!
  426. </p>
  427. <h3 id="tutorial-5e">Step 5e: Cross compile your Project (OSG)</h3>
  428. <p>
  429. Using static OpenSceneGraph libraries requires a few changes to your source.
  430. The graphics subsystem and all plugins required by your application must be
  431. referenced explicitly. Use a code block like the following:
  432. </p>
  433. <pre>#ifdef OSG_LIBRARY_STATIC
  434. USE_GRAPHICSWINDOW()
  435. USE_OSGPLUGIN(&lt;plugin1&gt;)
  436. USE_OSGPLUGIN(&lt;plugin2&gt;)
  437. ...
  438. #endif</pre>
  439. <p>
  440. Look at <code>examples/osgstaticviewer/osgstaticviewer.cpp</code> in the
  441. OpenSceneGraph source distribution for an example. This example can be
  442. compiled with the following command:
  443. </p>
  444. <pre>i686-w64-mingw32.static-g++ \
  445. -o osgstaticviewer.exe examples/osgstaticviewer/osgstaticviewer.cpp \
  446. `i686-w64-mingw32.static-pkg-config --cflags openscenegraph-osgViewer openscenegraph-osgPlugins` \
  447. `i686-w64-mingw32.static-pkg-config --libs openscenegraph-osgViewer openscenegraph-osgPlugins`</pre>
  448. <p>
  449. The <code>i686-w64-mingw32.static-pkg-config</code> command from MXE will
  450. automatically add <code>-DOSG_LIBRARY_STATIC</code> to your compiler flags.
  451. </p>
  452. <h3>Further Steps</h3>
  453. <p>
  454. If you need further assistance,
  455. feel free to join the
  456. <a href="https://lists.nongnu.org/mailman/listinfo/mingw-cross-env-list">mailing list</a>
  457. where you'll get in touch with
  458. the MXE developers
  459. and other users.
  460. </p>
  461. </div>
  462. <div class="section">
  463. <div id="latest-release"></div>
  464. <div id="latest-version"></div>
  465. <div id="development"></div>
  466. <h2 id="download">Download</h2>
  467. <p>
  468. To obtain the current version, run:
  469. </p>
  470. <pre>git clone https://github.com/mxe/mxe.git</pre>
  471. <p>
  472. To retrieve updates, run:
  473. </p>
  474. <pre>git pull</pre>
  475. <p>
  476. You can also browse the
  477. <a href="https://github.com/mxe/mxe">web repository</a>.
  478. </p>
  479. <p>
  480. In addition,
  481. feel free to join the
  482. <a href="https://lists.nongnu.org/mailman/listinfo/mingw-cross-env-list">mailing list</a>
  483. and to <a href="#creating-packages">propose new packages</a>.
  484. </p>
  485. </div>
  486. <div class="section">
  487. <h2 id="requirements">Requirements</h2>
  488. <p>
  489. MXE requires a recent Unix system where
  490. all components as stated in the table below
  491. are installed. It also needs roughly 2 GiB of
  492. RAM to link gcc and at least 700 MB of disk
  493. space per target (counted with only gcc
  494. built).
  495. </p>
  496. <p>
  497. Detailed instructions are available for:
  498. </p>
  499. <ul class="compact-list">
  500. <li><a href="#requirements-debian">Debian/Ubuntu</a></li>
  501. <li><a href="#requirements-fedora">Fedora/Red Hat/CentOS</a></li>
  502. <li><a href="#requirements-freebsd">FreeBSD</a></li>
  503. <li><a href="#requirements-frugalware">Frugalware</a></li>
  504. <li><a href="#requirements-gentoo">Gentoo</a></li>
  505. <li><a href="#requirements-macos">Mac OS X</a></li>
  506. <li><a href="#requirements-opensuse">openSUSE</a></li>
  507. <li><a href="#requirements-void">Void</a></li>
  508. <li><a href="#requirements-wsl">Windows Subsystem for Linux</a></li>
  509. </ul>
  510. <table class="requirements">
  511. <tr>
  512. <td><a href="https://www.gnu.org/software/autoconf/">Autoconf</a></td>
  513. <td>≥ 2.68</td>
  514. </tr>
  515. <tr>
  516. <td><a href="https://www.gnu.org/software/automake/">Automake</a></td>
  517. <td>≥ 1.11.3</td>
  518. </tr>
  519. <tr>
  520. <td><a href="https://www.gnu.org/software/bash/">Bash</a></td>
  521. <td></td>
  522. </tr>
  523. <tr>
  524. <td><a href="https://www.gnu.org/software/bison/">Bison</a></td>
  525. <td></td>
  526. </tr>
  527. <tr>
  528. <td><a href="https://en.wikipedia.org/wiki/Bzip2">Bzip2</a></td>
  529. <td></td>
  530. </tr>
  531. <tr>
  532. <td><a href="https://flex.sourceforge.io/">Flex</a></td>
  533. <td>≥ 2.5.31</td>
  534. </tr>
  535. <tr>
  536. <td><a href="https://www.gnu.org/software/gcc/">GCC</a> (gcc, g++)</td>
  537. <td></td>
  538. </tr>
  539. <tr>
  540. <td><a href="https://developer.gnome.org/gdk-pixbuf/">gdk-pixbuf</a></td>
  541. <td></td>
  542. </tr>
  543. <tr>
  544. <td><a href="https://git-scm.com/">Git</a></td>
  545. <td>≥ 1.7</td>
  546. </tr>
  547. <tr>
  548. <td><a href="https://www.gnu.org/software/coreutils/">GNU Coreutils</a></td>
  549. <td></td>
  550. </tr>
  551. <tr>
  552. <td><a href="https://www.gnu.org/software/gettext/">GNU Gettext</a></td>
  553. <td></td>
  554. </tr>
  555. <tr>
  556. <td><a href="https://www.gnu.org/software/gperf/">GNU gperf</a></td>
  557. <td></td>
  558. </tr>
  559. <tr>
  560. <td><a href="https://www.gnu.org/software/make/">GNU Make</a></td>
  561. <td>≥ 3.81</td>
  562. </tr>
  563. <tr>
  564. <td><a href="https://www.gnu.org/software/sed/">GNU Sed</a></td>
  565. <td></td>
  566. </tr>
  567. <tr>
  568. <td><a href="https://www.gnu.org/software/tar/">GNU Tar</a></td>
  569. <td></td>
  570. </tr>
  571. <tr>
  572. <td><a href="https://freedesktop.org/wiki/Software/intltool/">Intltool</a></td>
  573. <td>≥ 0.40</td>
  574. </tr>
  575. <tr>
  576. <td><a href="https://en.wikipedia.org/wiki/C_standard_library">LibC</a> for 32-bit</td>
  577. <td></td>
  578. </tr>
  579. <tr>
  580. <td><a href="https://www.gnu.org/software/libtool/">Libtool</a></td>
  581. <td>≥ 2.2</td>
  582. </tr>
  583. <tr>
  584. <td><a href="http://lzip.nongnu.org/">Lzip</a></td>
  585. <td></td>
  586. </tr>
  587. <tr>
  588. <td><a href="https://www.openssl.org/">OpenSSL</a>-dev</td>
  589. <td>≥ 1.01</td>
  590. </tr>
  591. <tr>
  592. <td><a href="https://p7zip.sourceforge.io/">p7zip (7-Zip)</a></td>
  593. <td></td>
  594. </tr>
  595. <tr>
  596. <td><a href="https://www.gnu.org/software/patch/">Patch</a></td>
  597. <td></td>
  598. </tr>
  599. <tr>
  600. <td><a href="https://www.perl.org/">Perl</a></td>
  601. <td></td>
  602. </tr>
  603. <tr>
  604. <td><a href="https://metacpan.org/pod/distribution/XML-Parser/Parser.pm">Perl XML::Parser</a></td>
  605. <td></td>
  606. </tr>
  607. <tr>
  608. <td><a href="https://www.freedesktop.org/wiki/Software/pkg-config/">Pkg-config</a></td>
  609. <td>≥ 0.16</td>
  610. </tr>
  611. <tr>
  612. <td><a href="https://www.python.org/">Python</a></td>
  613. <td></td>
  614. </tr>
  615. <tr>
  616. <td><a href="https://www.ruby-lang.org/">Ruby</a></td>
  617. <td></td>
  618. </tr>
  619. <tr>
  620. <td><a href="https://infozip.sourceforge.io/UnZip.html">UnZip</a></td>
  621. <td></td>
  622. </tr>
  623. <tr>
  624. <td><a href="https://www.gnu.org/software/wget/">Wget</a></td>
  625. <td></td>
  626. </tr>
  627. <tr>
  628. <td><a href="https://tukaani.org/xz/">XZ Utils</a></td>
  629. <td></td>
  630. </tr>
  631. <tr>
  632. <td><a href="https://zlib.net/">zlib</a></td>
  633. <td>≥ 1.20</td>
  634. </tr>
  635. </table>
  636. <h3 id="requirements-debian">Debian and derivatives</h3>
  637. <!-- https://www.debian.org/distrib/packages#search_packages -->
  638. <pre>apt-get install \
  639. autoconf \
  640. automake \
  641. autopoint \
  642. bash \
  643. bison \
  644. bzip2 \
  645. flex \
  646. g++ \
  647. g++-multilib \
  648. gettext \
  649. git \
  650. gperf \
  651. intltool \
  652. libc6-dev-i386 \
  653. libgdk-pixbuf2.0-dev \
  654. libltdl-dev \
  655. libssl-dev \
  656. libtool-bin \
  657. libxml-parser-perl \
  658. lzip \
  659. make \
  660. openssl \
  661. p7zip-full \
  662. patch \
  663. perl \
  664. pkg-config \
  665. python \
  666. ruby \
  667. sed \
  668. unzip \
  669. wget \
  670. xz-utils</pre>
  671. <p>
  672. On 32-bit installs,
  673. <pre>
  674. g++-multilib
  675. libc6-dev-i386
  676. </pre>
  677. are not required, however there are potential issues with
  678. <a href="#issue-32-bit-systems">32-bit systems</a>.
  679. </p>
  680. <p>
  681. Only the <a href="https://www.debian.org/releases/stable/">latest Debian stable series</a> is supported.
  682. </p>
  683. <p>
  684. You can install a precompiled MXE via Debian packages.
  685. See <a href="http://pkg.mxe.cc/">pkg.mxe.cc</a>.
  686. </p>
  687. <h3 id="requirements-fedora">Fedora/Red Hat/Centos</h3>
  688. <p>
  689. Ensure <a href="https://fedoraproject.org/wiki/EPEL">Extra Packages
  690. for Enterprise Linux (EPEL)</a> is installed/available. On some
  691. systems, it may be as simple as:
  692. </p>
  693. <pre>yum install epel-release</pre>
  694. <!-- https://apps.fedoraproject.org/packages/ -->
  695. <pre>yum install \
  696. autoconf \
  697. automake \
  698. bash \
  699. bison \
  700. bzip2 \
  701. flex \
  702. gcc-c++ \
  703. gdk-pixbuf2-devel \
  704. gettext \
  705. git \
  706. gperf \
  707. intltool \
  708. libtool \
  709. lzip \
  710. make \
  711. openssl-devel \
  712. p7zip \
  713. patch \
  714. perl \
  715. pkgconfig \
  716. python \
  717. ruby \
  718. sed \
  719. unzip \
  720. wget \
  721. xz</pre>
  722. <p>
  723. On 64-bit Fedora,
  724. there are <a href="#issue-non-multilib">issues without a 32-bit compiler</a>.
  725. </p>
  726. <h3 id="requirements-freebsd">FreeBSD</h3>
  727. <!-- https://www.freshports.org/ -->
  728. <pre>pkg install \
  729. autoconf \
  730. automake \
  731. bash \
  732. bison \
  733. coreutils \
  734. flex \
  735. gcc \
  736. gdk-pixbuf2 \
  737. gettext \
  738. git \
  739. glib \
  740. gmake \
  741. gperf \
  742. gsed \
  743. intltool \
  744. libtool \
  745. openssl \
  746. p5-XML-Parser \
  747. p7zip \
  748. patch \
  749. perl5 \
  750. pkgconf \
  751. python \
  752. ruby \
  753. unzip \
  754. wget</pre>
  755. <p>
  756. Use gmake instead of make.
  757. </p>
  758. <p>
  759. Install file(1) from ports, because file(1) from base
  760. <a href="https://forums.freebsd.org/threads/usr-bin-file-works-very-slow.52958/">works</a>
  761. very-very-very slow with long text files.
  762. </p>
  763. <p>
  764. Do not build as root. See
  765. <a href="https://github.com/mxe/mxe/issues/902">#902</a>.
  766. </p>
  767. <p>
  768. Ensure that /usr/local/bin precedes /usr/bin in your $PATH:
  769. </p>
  770. <p>
  771. For C style shells, edit .cshrc
  772. </p>
  773. <pre>setenv PATH /usr/local/bin:$PATH</pre>
  774. <p>
  775. For Bourne shells, edit .profile
  776. </p>
  777. <pre>export PATH=/usr/local/bin:$PATH</pre>
  778. <p>
  779. On 64-bit FreeBSD,
  780. there are <a href="#issue-non-multilib">issues without a 32-bit compiler</a>.
  781. </p>
  782. <p>
  783. <strong>N.B. FreeBSD is no longer fully supported</strong>
  784. </p>
  785. <p>
  786. to build the remainder of MXE, run:
  787. </p>
  788. <pre>gmake EXCLUDE_PKGS='gtksourceviewmm2 ocaml% openexr pcl qtbase'</pre>
  789. <p>
  790. to see a list of all dependent downstream packages that
  791. will be excluded, run:
  792. </p>
  793. <pre>gmake show-downstream-deps-'gtksourceviewmm2 ocaml% openexr \
  794. pcl qtbase'</pre>
  795. <h3 id="requirements-frugalware">Frugalware</h3>
  796. <!-- https://www.frugalware.org/packages -->
  797. <pre>pacman-g2 -S \
  798. autoconf \
  799. automake \
  800. bash \
  801. bison \
  802. bzip2 \
  803. flex \
  804. gcc \
  805. gdk-pixbuf2\
  806. gettext \
  807. git \
  808. gperf \
  809. intltool \
  810. libtool \
  811. lzip \
  812. make \
  813. openssl \
  814. patch \
  815. perl \
  816. perl-xml-parser \
  817. pkgconfig \
  818. python \
  819. ruby \
  820. sed \
  821. unzip \
  822. wget \
  823. xz \
  824. xz-lzma</pre>
  825. <p>
  826. On 64-bit Frugalware,
  827. there are <a href="#issue-non-multilib">issues without a 32-bit compiler</a>.
  828. </p>
  829. <h3 id="requirements-gentoo">Gentoo</h3>
  830. <!-- https://packages.gentoo.org/ -->
  831. <pre>emerge \
  832. app-arch/bzip2 \
  833. app-arch/lzip \
  834. app-arch/p7zip \
  835. app-arch/unzip \
  836. app-arch/xz-utils \
  837. app-shells/bash \
  838. dev-lang/perl \
  839. dev-lang/python \
  840. dev-lang/ruby \
  841. dev-libs/openssl \
  842. dev-perl/XML-Parser \
  843. dev-util/gperf \
  844. dev-util/intltool \
  845. dev-util/pkgconfig \
  846. dev-vcs/git \
  847. net-misc/wget \
  848. sys-apps/sed \
  849. sys-devel/autoconf \
  850. sys-devel/automake \
  851. sys-devel/bison \
  852. sys-devel/flex \
  853. sys-devel/gcc \
  854. sys-devel/gettext \
  855. sys-devel/libtool \
  856. sys-devel/make \
  857. sys-devel/patch \
  858. x11-libs/gdk-pixbuf</pre>
  859. <h3 id="requirements-macos">Mac OS X</h3>
  860. <p>
  861. Install
  862. <a href="https://developer.apple.com/xcode/">the latest Xcode</a>
  863. </p>
  864. <h5 id="requirements-macos-macports">MacPorts</h5>
  865. <p>
  866. Install <a href="https://www.macports.org/">MacPorts</a>,
  867. then run:
  868. </p>
  869. <!-- https://www.macports.org/ports.php -->
  870. <pre>sudo port install \
  871. autoconf \
  872. automake \
  873. coreutils \
  874. gdk-pixbuf2 \
  875. gnutar \
  876. gsed \
  877. intltool \
  878. libtool \
  879. lzip \
  880. p7zip \
  881. pkgconfig \
  882. wget \
  883. xz</pre>
  884. <h5 id="requirements-macos-rudix">Rudix</h5>
  885. <p>
  886. <a href="https://rudix.org/">Rudix</a> has
  887. <a href="https://twitter.com/__rudix__/status/1022273255942565893">shut down since August 2018</a>
  888. </p>
  889. <h5 id="requirements-macos-homebrew">Homebrew</h5>
  890. <p>
  891. Install <a href="https://brew.sh/">Homebrew</a>,
  892. then run:
  893. </p>
  894. <!-- https://formulae.brew.sh/ -->
  895. <!-- wget -q -O- https://formulae.brew.sh/api/formula.json | tr ',' '\n' | grep 'name\|desc' | grep -i {pkg} -->
  896. <pre>brew install \
  897. autoconf \
  898. automake \
  899. coreutils \
  900. gdk-pixbuf \
  901. gnu-sed \
  902. gnu-tar \
  903. intltool \
  904. libtool \
  905. lzip \
  906. p7zip \
  907. pkg-config \
  908. wget \
  909. xz</pre>
  910. <p>
  911. You will see messages about
  912. <a href="https://github.com/Homebrew/brew/blob/master/docs/FAQ.md#what-does-keg-only-mean"><code>keg-only</code></a>
  913. formulae and tools prefixed with 'g' - you can safely ignore these
  914. and no homebrew related <code>$PATH</code> modifications or
  915. <code>brew link</code>s are necessary.
  916. <h5 id="requirements-macos-general">Genral Notes</h5>
  917. <p>
  918. You may be prompted to install a java runtime
  919. - this is not required.
  920. </p>
  921. <p>
  922. Mac OS X versions ≤ 10.9 are no longer tested.
  923. </p>
  924. <h5>Certain packages have open issues on OS X</h5>
  925. <p>
  926. For Xcode &lt;7.3, run:
  927. </p>
  928. <pre>make EXCLUDE_PKGS='nsis'</pre>
  929. <h3 id="requirements-opensuse">openSUSE</h3>
  930. <!-- https://software.opensuse.org/explore -->
  931. <pre>zypper install -R \
  932. autoconf \
  933. automake \
  934. bash \
  935. bison \
  936. bzip2 \
  937. flex \
  938. gcc-32bit \
  939. gcc-c++ \
  940. gdk-pixbuf-devel \
  941. gettext-tools \
  942. git \
  943. glibc-devel-32bit \
  944. gperf \
  945. intltool \
  946. libgcc46-32bit \
  947. libgomp46-32bit \
  948. libopenssl-devel \
  949. libstdc++46-devel-32bit \
  950. libtool \
  951. lzip \
  952. make \
  953. openssl \
  954. p7zip \
  955. patch \
  956. perl \
  957. perl-XML-Parser \
  958. pkg-config \
  959. python \
  960. ruby \
  961. sed \
  962. unzip \
  963. wget \
  964. xz</pre>
  965. <p>
  966. On 32-bit installs,
  967. <pre>
  968. gcc-32bit
  969. glibc-devel-32bit
  970. libgcc46-32bit
  971. libgomp46-32bit
  972. libstdc++46-devel-32bit
  973. </pre>
  974. are not required, however there are potential issues with
  975. <a href="#issue-32-bit-systems">32-bit systems</a>.
  976. </p>
  977. <h3 id="requirements-void">Void</h3>
  978. <!-- https://voidlinux.org/packages/ -->
  979. <pre>xbps-install -S \
  980. autoconf \
  981. automake \
  982. flex \
  983. gcc \
  984. gdk-pixbuf-devel \
  985. gettext \
  986. gettext-devel \
  987. git \
  988. gperf \
  989. intltool \
  990. libcurl-devel \
  991. libtool \
  992. lzip \
  993. make \
  994. p7zip \
  995. patch \
  996. perl-XML-Parser \
  997. python \
  998. ruby \
  999. unzip \
  1000. wget \
  1001. xz</pre>
  1002. <h3 id="requirements-wsl">Windows Subsystem for Linux</h3>
  1003. <p>
  1004. Requirements should match the Debian, Fedora, openSUSE etc. sections
  1005. above, but care should be taken to ensure MXE is installed in the
  1006. Linux subsystem under <code>/</code> instead of the mounted Windows
  1007. folders in <code>/mnt</code>.
  1008. </p>
  1009. <p>
  1010. It can be <a href="https://github.com/mxe/mxe/issues/1892#issuecomment-344004704">
  1011. made to work using symlinks and specifying</a>:
  1012. </p>
  1013. <pre>make MXE_TMP=/tmp/mxe-tmp ...</pre>
  1014. <p>
  1015. See further reading in:
  1016. </p>
  1017. <ul>
  1018. <li><a href="https://msdn.microsoft.com/en-us/commandline/wsl/faq#how-do-i-use-a-windows-file-with-a-linux-app">
  1019. WSL FAQ file section</a></li>
  1020. <li><a href="https://blogs.msdn.microsoft.com/commandline/2016/11/17/do-not-change-linux-files-using-windows-apps-and-tools/">
  1021. MSDN Blog</a></li>
  1022. </ul>
  1023. <h3 id="issue-32-bit-systems">Issues with 32-bit systems</h3>
  1024. 32-bit systems
  1025. <a href="https://github.com/mxe/mxe/issues/1381#issuecomment-225459494">
  1026. may have insufficient virtual memory</a> to build all of MXE.
  1027. <h3 id="issue-non-multilib">Issues without a 32-bit compiler</h3>
  1028. <p>
  1029. Certain packages contain native tools that are
  1030. currently 32-bit only. In order to build these on a
  1031. 64-bit system, multi-lib support must be enabled in the
  1032. compiler toolchain. However, not all operating systems
  1033. support this.
  1034. </p>
  1035. <p>
  1036. To build the remainder of MXE, specify the affected
  1037. packages to exclude:
  1038. </p>
  1039. <pre>make EXCLUDE_PKGS='ocaml%'</pre>
  1040. </div>
  1041. <div class="section">
  1042. <h2 id="usage">Usage</h2>
  1043. <p>
  1044. All build commands also download the packages if necessary.
  1045. </p>
  1046. <p>
  1047. In a BSD userland, substitute "make" with "gmake"
  1048. as all commands are based on
  1049. <a href="https://www.gnu.org/software/make/manual/make.html">GNU Make</a>.
  1050. </p>
  1051. <dl class="usage">
  1052. <dt>make</dt>
  1053. <dd>
  1054. build all packages,
  1055. non-parallel
  1056. </dd>
  1057. <dt>make cc</dt>
  1058. <dd>
  1059. build a minimal useful set of packages,
  1060. i.e. the cross compilers
  1061. and the most basic packages,
  1062. non-parallel
  1063. </dd>
  1064. <dt>make foo bar</dt>
  1065. <dd>
  1066. build packages "foo", "bar" and their dependencies,
  1067. non-parallel
  1068. </dd>
  1069. <dd>
  1070. the package list can also be set in
  1071. <code>settings.mk</code>
  1072. <pre>LOCAL_PKG_LIST := foo bar
  1073. .DEFAULT_GOAL := local-pkg-list
  1074. local-pkg-list: $(LOCAL_PKG_LIST)</pre>
  1075. </dd>
  1076. <dd>
  1077. so a call to <code>make</code> will only build those packages (and their
  1078. dependencies, of course)
  1079. </dd>
  1080. <dt>make foo bar --touch</dt>
  1081. <dd>
  1082. mark packages "foo" and "bar" as up-to-date after
  1083. a trivial change in one of their dependencies
  1084. (short option "-t")
  1085. </dd>
  1086. <dt>make foo bar --jobs=4 JOBS=2</dt>
  1087. <dd>
  1088. build packages "foo", "bar" and their dependencies,
  1089. where up to 4 packages are built in parallel
  1090. (short option "-j 4"),
  1091. each with up to 2 compiler processes running in parallel
  1092. </dd>
  1093. <dd>
  1094. the JOBS variable can also be defined in
  1095. <code>settings.mk</code> and defaults to the number
  1096. of CPUs up to a max of 6 to prevent runaway system
  1097. load with diminishing returns - see the
  1098. <a href="https://www.gnu.org/software/make/manual/make.html#Parallel">GNU Make manual</a>
  1099. for more details on parallel execution
  1100. </dd>
  1101. <dt>make --jobs=4 --keep-going</dt>
  1102. <dd>
  1103. build all packages with 4 inter-package parallel
  1104. jobs and continue as much as possible after an error
  1105. (short option "-j 4 -k")
  1106. </dd>
  1107. <dt>make foo bar MXE_USE_CCACHE=</dt>
  1108. <dd>
  1109. disables use of <a href="https://ccache.samba.org">ccache</a>
  1110. to eliminate potential error sources when debugging
  1111. </dd>
  1112. <dt>make EXCLUDE_PKGS='foo bar'</dt>
  1113. <dd>
  1114. build all packages excluding foo, bar, and all downstream
  1115. packages that depend on them - mostly used when there are
  1116. <a href="#issue-non-multilib">known issues</a>
  1117. </dd>
  1118. <dt>make foo_SOURCE_TREE=/path/to/local/source</dt>
  1119. <dd>
  1120. build using local source tree for package "foo", bypassing
  1121. download, checksum and patching
  1122. </dd>
  1123. <dd>
  1124. <strong>N.B.</strong> ensure "foo" has an out-of-source
  1125. build configured to avoid generation of build artefacts
  1126. in local tree
  1127. </dd>
  1128. <dt>make check-requirements</dt>
  1129. <dd>
  1130. check most of the
  1131. <a href="#requirements">requirements</a>
  1132. if necessary
  1133. &ndash; executed automatically
  1134. before building packages
  1135. </dd>
  1136. <dt>make download</dt>
  1137. <dd>
  1138. download all packages,
  1139. non-parallel,
  1140. such that subsequent builds work without internet access
  1141. </dd>
  1142. <dt>make download-foo download-bar</dt>
  1143. <dd>
  1144. download packages "foo", "bar" and their dependencies,
  1145. non-parallel
  1146. </dd>
  1147. <dt>make download-foo download-bar -j 4</dt>
  1148. <dd>
  1149. download packages "foo", "bar" and their dependencies,
  1150. where up to 4 packages are downloaded in parallel
  1151. </dd>
  1152. <dt>make download-only-foo download-only-bar</dt>
  1153. <dd>
  1154. download packages "foo", "bar", without their dependencies,
  1155. non-parallel
  1156. </dd>
  1157. <dt>make clean</dt>
  1158. <dd>
  1159. remove all package builds
  1160. &ndash; use with caution!
  1161. </dd>
  1162. <dt>make clean-junk</dt>
  1163. <dd>
  1164. remove all unused files, including unused package
  1165. files, temporary folders, and logs
  1166. </dd>
  1167. <dt>make clean-pkg</dt>
  1168. <dd>
  1169. remove all unused package files,
  1170. handy after a successful update
  1171. </dd>
  1172. <dt>make show-deps-foo</dt>
  1173. <dd>
  1174. print a list of upstream dependencies
  1175. and all downstream dependents (direct and recursive)
  1176. </dd>
  1177. <dt>make show-downstream-deps-foo</dt>
  1178. <dd>
  1179. print a list of all recursive downstream dependents
  1180. - suitable for use in shell scripts
  1181. </dd>
  1182. <dt>make show-direct-downstream-deps-foo</dt>
  1183. <dd>
  1184. print a list of direct downstream dependents
  1185. - suitable for use in shell scripts
  1186. </dd>
  1187. <dt>make show-upstream-deps-foo</dt>
  1188. <dd>
  1189. print a list of upstream dependencies
  1190. - suitable for use in shell scripts
  1191. </dd>
  1192. <dt>make docs/build-matrix.html</dt>
  1193. <dd>
  1194. generate a report of what packages are
  1195. supported on what targets to
  1196. <a href="build-matrix.html">docs/build-matrix.html</a>
  1197. </dd>
  1198. <dt>make update</dt>
  1199. <dd>
  1200. update the version numbers of all packages,
  1201. download the new versions and note their checksums
  1202. </dd>
  1203. <dt>make update UPDATE_DRYRUN=true</dt>
  1204. <dd>
  1205. show list of update candidates without downloading
  1206. </dd>
  1207. <dt>make update-package-foo</dt>
  1208. <dd>
  1209. update the version numbers of package foo,
  1210. download the new version and note its checksum
  1211. </dd>
  1212. <dt>make check-update-package-foo</dt>
  1213. <dd>
  1214. check if package foo has an update available
  1215. without downloading
  1216. </dd>
  1217. <dt>make update-checksum-foo</dt>
  1218. <dd>
  1219. download package foo and update its checksum
  1220. </dd>
  1221. <dt>make cleanup-style</dt>
  1222. <dd>
  1223. cleanup coding style
  1224. </dd>
  1225. </dl>
  1226. </div>
  1227. <div class="section">
  1228. <h2 id="packages">List of Packages</h2>
  1229. <p>
  1230. See something missing? Feel free to <a href="#creating-packages">create a new package</a>.
  1231. </p>
  1232. <table id="package-list" class="old">
  1233. <tr>
  1234. <td>Loading package list...</td>
  1235. </tr>
  1236. </table>
  1237. <script>
  1238. function loadPackageCache(doneCallback) {
  1239. var request = new XMLHttpRequest();
  1240. request.open('GET', 'packages.json', false);
  1241. request.onreadystatechange = function reqCallback() {
  1242. if (request.readyState === 4) {
  1243. if (request.status === 200) {
  1244. var pkgs = JSON.parse(request.responseText);
  1245. doneCallback(pkgs);
  1246. }
  1247. }
  1248. }
  1249. request.send();
  1250. }
  1251. function showPackages(pkgs) {
  1252. var names = []
  1253. for (pkg in pkgs) {
  1254. names.push(pkg);
  1255. }
  1256. names.sort();
  1257. var trs = [];
  1258. for (var i = 0; i < names.length; i++) {
  1259. var pkg = names[i];
  1260. if (pkg == "" || pkg == "mxe-conf") {
  1261. // "" is last line of packages.json.
  1262. continue;
  1263. }
  1264. var version = pkgs[pkg].version;
  1265. var shorten = version.length > 12;
  1266. if (shorten) {
  1267. version = version.substring(0, 12);
  1268. }
  1269. var versionEscaped = version.replace('&', '&amp;').replace('<', '&lt;').replace('>', '&gt;');
  1270. if (shorten) {
  1271. versionEscaped += '&hellip;';
  1272. }
  1273. var website = pkgs[pkg].website;
  1274. var description = pkgs[pkg].description;
  1275. if (description == "") {
  1276. description = pkg;
  1277. }
  1278. var pkgHtml = '<tr>' +
  1279. '<td class="package">' + pkg + '</td>' +
  1280. '<td class="version">' + versionEscaped + '</td>' +
  1281. '<td class="website"><a href="' + website + '">' + description + '</a></td>' +
  1282. '</tr>';
  1283. trs.push(pkgHtml);
  1284. }
  1285. var packageList = document.getElementById('package-list');
  1286. packageList.innerHTML = trs.join('\n');
  1287. }
  1288. (function main() {
  1289. loadPackageCache(showPackages);
  1290. })();
  1291. </script>
  1292. </div>
  1293. <div class="section">
  1294. <h2 id="creating-packages">Guidelines for Creating Packages</h2>
  1295. <ol>
  1296. <li>
  1297. <p>
  1298. The package should be a
  1299. <a href="https://www.gnu.org/philosophy/free-sw.html">free</a>
  1300. <a href="https://www.debian.org/social_contract#guidelines">software</a>
  1301. <a href="https://www.opensource.org/osd.html">library</a>
  1302. that is really used by one of your applications. Please also review our
  1303. <a href="#legal">legal notes</a>.
  1304. </p>
  1305. <p>
  1306. BTW, we're always curious about the applications people are porting.
  1307. We maintain a
  1308. <a href="#used-by">list of projects</a>
  1309. which use MXE.
  1310. No matter whether your project is free or proprietary
  1311. &ndash; as long as it has its own website,
  1312. we'd be happy to link to it.
  1313. </p>
  1314. <p>
  1315. Also, feel free to link to us. :-)
  1316. </p>
  1317. </li>
  1318. <li>
  1319. <p>
  1320. Grep through the <code>src/*.mk</code> files
  1321. to find a project that is most similar to yours.
  1322. (Really, <code>grep</code> is your friend here.)
  1323. </p>
  1324. <p>
  1325. For instance,
  1326. when adding a GNU library,
  1327. you should take a package like
  1328. <a href="https://github.com/mxe/mxe/blob/master/src/gettext.mk">gettext.mk</a>
  1329. or
  1330. <a href="https://github.com/mxe/mxe/blob/master/src/libiconv.mk">libiconv.mk</a>
  1331. as the base of your work.
  1332. When using a SourceForge project,
  1333. you could start with a copy of
  1334. <a href="https://github.com/mxe/mxe/blob/master/src/xmlwrapp.mk">xmlwrapp.mk</a>.
  1335. And so on.
  1336. </p>
  1337. <p>
  1338. GitHub hosted projects can automatically configure updates,
  1339. urls, file names etc. by setting <code>$(PKG)_GH_CONF</code>
  1340. instead of <code>$(PKG)_FILE, $(PKG)_SUBDIR, $(PKG)_URL, and
  1341. $(PKG)_UPDATE</code> sections.
  1342. </p>
  1343. <p>
  1344. To track releases set:
  1345. </p>
  1346. <pre>$(PKG)_GH_CONF := owner/repo/releases[/latest][, tag prefix, tag suffix, tag filter-out, version separator]</pre>
  1347. <p>
  1348. Releases may require setting _FILE, _SUBDIR, _URL, depending on
  1349. the naming convention used by the project for tarballs.
  1350. </p>
  1351. <p>
  1352. To track tags set:
  1353. </p>
  1354. <pre>$(PKG)_GH_CONF := owner/repo/tags[, tag prefix, tag suffix, tag filter-out, version separator]</pre>
  1355. <p>
  1356. To track branches, set:
  1357. </p>
  1358. <pre>$(PKG)_GH_CONF := owner/repo/branches/&lt;branch name&gt;</pre>
  1359. <p>
  1360. See the following packages for examples:
  1361. </p>
  1362. <ul>
  1363. <li>
  1364. <a href="https://github.com/mxe/mxe/blob/master/src/gc.mk">gc.mk</a>
  1365. for release tracking with non-standard file name
  1366. </li>
  1367. <li>
  1368. <a href="https://github.com/mxe/mxe/blob/master/src/yaml-cpp.mk">yaml-cpp.mk</a>
  1369. for release tracking with standard file name
  1370. </li>
  1371. <li>
  1372. <a href="https://github.com/mxe/mxe/blob/master/src/vmime.mk">vmime.mk</a>
  1373. for branch tracking
  1374. </li>
  1375. <li>
  1376. <a href="https://github.com/mxe/mxe/blob/master/src/libevent.mk">libevent.mk</a>
  1377. for tag tracking
  1378. </li>
  1379. <li>
  1380. <a href="https://github.com/mxe/mxe/blob/master/src/libffi.mk">libffi.mk</a>
  1381. for externally hosted tarballs with generated sources not
  1382. present in source tree
  1383. </li>
  1384. </ul>
  1385. <p>
  1386. The <a href="gmsl.html">GNU Make Standard Library</a> is also
  1387. available (though it should be unnecessary for most packages).
  1388. </p>
  1389. <p>
  1390. Alternatively you can use tool <code>tools/skeleton.py</code> to
  1391. create a skeleton of new MXE package. It fills most of the fields
  1392. of <code>.mk</code> file automatically and supports typical
  1393. build scenarios through option <code>--builder</code>. It also
  1394. adds a package to the <a href="#packages">list of packages</a>
  1395. (see below).
  1396. </p>
  1397. </li>
  1398. <li>
  1399. <p>
  1400. Adjust the comments,
  1401. fill in the <code>$(PKG)_*</code> fields.
  1402. </p>
  1403. <p>
  1404. To fill the <code>$(PKG)_CHECKSUM</code> field, use a command such as (for file gettext.mk):
  1405. </p>
  1406. <pre>make update-checksum-gettext</pre>
  1407. <p>or:</p>
  1408. <pre>openssl sha256 pkg/gettext-x.y.z.tar.gz</pre>
  1409. <p>
  1410. if you have already downloaded the package.
  1411. </p>
  1412. <p>
  1413. Be especially careful with the <code>$(PKG)_DEPS</code> section.
  1414. The easiest way to get the dependencies right
  1415. is to start with a minimal setup.
  1416. That is,
  1417. initialize MXE with <code>make cc</code> only,
  1418. then check whether your package builds successfully.
  1419. </p>
  1420. <p>
  1421. Always list the dependency on <code>cc</code> explicitly:
  1422. </p>
  1423. <pre>$(PKG)_DEPS := cc ...</pre>
  1424. <p>
  1425. Specify official name and website of a package.
  1426. If the official name coincides with the package name,
  1427. you can omit <code>$(PKG)_DESCR</code>.
  1428. </p>
  1429. <pre>
  1430. PKG := libdvdetect
  1431. $(PKG)_WEBSITE := https://www.dvdetect.de/
  1432. $(PKG)_DESCR := Fast database lookup for DVDs</pre>
  1433. <p>
  1434. Always look for the SSL version of URLs, that is,
  1435. prefer <code>https://</code> URLs over <code>http://</code> URLs.
  1436. </p>
  1437. </li>
  1438. <li>
  1439. <p>
  1440. Write your <code>$(PKG)_BUILD</code>.
  1441. If your library has a <code>./configure</code> script,
  1442. enable/disable all dependency libraries explicitly
  1443. via "<code>--enable-*</code>" and "<code>--disable-*</code>" options.
  1444. </p>
  1445. <p>
  1446. Things not to do:
  1447. </p>
  1448. <ul>
  1449. <li>
  1450. <b>do not run target executables with Wine</b>, as Wine is
  1451. not guaranteed to be installed. Instead build the needed tool
  1452. natively or (if it is too huge to build one more time) add
  1453. to MXE's dependencies. This policy is forced by setting
  1454. WINEPREFIX to an empty directory, which breaks Wine;
  1455. </li>
  1456. <li>
  1457. <b>do not download anything while building</b>, as all files
  1458. downloaded should be verified by checksums. Instead create a
  1459. package which installs the needed file. This policy is forced
  1460. on Linux by <a href="https://github.com/starius/nonetwork/"
  1461. >LD_PRELOAD trick</a>, breaking network functions.
  1462. </li>
  1463. </ul>
  1464. <p>
  1465. Useful Makefile variables provided by MXE:
  1466. </p>
  1467. <ul>
  1468. <li>
  1469. <p>
  1470. <code>$(SOURCE_DIR)</code>
  1471. is a directory with package source and
  1472. <code>$(BUILD_DIR)</code>
  1473. is an empty directory intended for build files.
  1474. Both directories are temporary.
  1475. Prefer out-of-tree builds. Autotools
  1476. and CMake support them.
  1477. </p>
  1478. </li>
  1479. <li>
  1480. <p>
  1481. <code>$(PREFIX)</code>
  1482. is path to <code>usr/</code> directory.
  1483. <code>$(TOP_DIR)</code>
  1484. is path to MXE root directory.
  1485. <code>$(TARGET)</code> is target triplet
  1486. (e.g., <code>i686-w64-mingw32.static</code>).
  1487. <code>$(BUILD)</code> is build triplet
  1488. (e.g., <code>x86_64-unknown-linux-gnu</code>).
  1489. </p>
  1490. </li>
  1491. <li>
  1492. <p>
  1493. <code>$(MXE_CONFIGURE_OPTS)</code>
  1494. adds standard options to <code>./configure</code> script.
  1495. Typical usage:
  1496. </p>
  1497. <pre>
  1498. cd '$(BUILD_DIR)' &amp;&amp; '$(SOURCE_DIR)'/configure \
  1499. $(MXE_CONFIGURE_OPTS)
  1500. </pre>
  1501. </li>
  1502. <li>
  1503. <p>
  1504. <code>$(MXE_DISABLE_CRUFT)</code>
  1505. disables installation of documentation and programs.
  1506. </p>
  1507. <pre>
  1508. $(MAKE) -C '$(BUILD_DIR)' -j '$(JOBS)' $(MXE_DISABLE_CRUFT)
  1509. $(MAKE) -C '$(BUILD_DIR)' -j 1 install $(MXE_DISABLE_CRUFT)
  1510. </pre>
  1511. </li>
  1512. <li>
  1513. <p>
  1514. <code>$(BUILD_SHARED)</code>
  1515. is TRUE for shared targets. Useful to add flags applicable
  1516. only to shared targets.
  1517. </p>
  1518. <pre>
  1519. $(if $(BUILD_SHARED),LDFLAGS=-no-undefined)
  1520. </pre>
  1521. <p>
  1522. Similarly,
  1523. <code>$(BUILD_STATIC)</code>
  1524. is TRUE for static targets;
  1525. <code>$(BUILD_NATIVE)</code>
  1526. is TRUE for native targets;
  1527. <code>$(BUILD_CROSS)</code>
  1528. is TRUE for cross targets.
  1529. </p>
  1530. </li>
  1531. </ul>
  1532. </li>
  1533. <li>
  1534. <p>
  1535. You might also have to provide a patch for it.
  1536. In that case, have a look at other patches such as
  1537. <a href="https://github.com/mxe/mxe/blob/master/src/sdl2-2-libtool.patch">sdl2-2-libtool.patch</a>.
  1538. In particular, each patch file should be named as:
  1539. </p>
  1540. <pre>PACKAGE-PATCHNUMBER-DESCRIPTION.patch</pre>
  1541. <p>
  1542. and should start with:
  1543. </p>
  1544. <pre>This file is part of MXE. See LICENSE.md for licensing information.
  1545. This patch has been taken from:
  1546. https://...</pre>
  1547. <p>
  1548. where the URL points to the
  1549. bugtracker entry,
  1550. mailing list entry or
  1551. website
  1552. you took the patch from.
  1553. </p>
  1554. <p>
  1555. If you created the patch yourself,
  1556. please offer it to the upstream project first,
  1557. and point to <em>that</em> URL,
  1558. using the same wording:
  1559. "This patch has been taken from:".
  1560. </p>
  1561. <p>
  1562. Depending on the feedback you get from the upstream project,
  1563. you might want to improve your patch.
  1564. </p>
  1565. </li>
  1566. <li>
  1567. <p>
  1568. If you find some time,
  1569. please provide a minimal test program for it.
  1570. It should be
  1571. simple,
  1572. stand alone and
  1573. should work unmodified for many (all?) future versions of the library.
  1574. Test programs are named as:
  1575. </p>
  1576. <pre>PACKAGE-test.c</pre>
  1577. or
  1578. <pre>PACKAGE-test.cpp</pre>
  1579. <p>
  1580. depending on whether it is a C or C++ library.
  1581. To get a clue,
  1582. please have a look at existing test programs such as
  1583. <a href="https://github.com/mxe/mxe/blob/master/src/sdl-test.c">sdl-test.c</a>.
  1584. </p>
  1585. <p>
  1586. At the very end of your <code>*.mk</code> file
  1587. you should build the test program in a generic way,
  1588. using strict compiler flags.
  1589. The last few lines of
  1590. <a href="https://github.com/mxe/mxe/blob/master/src/sdl.mk">sdl.mk</a>
  1591. will give you a clue.
  1592. </p>
  1593. </li>
  1594. <li>
  1595. <p>
  1596. You could also try to provide a <code>$(PKG)_UPDATE</code> section.
  1597. However, that requires some experience and "feeling" for it.
  1598. So it is perfectly okay if you leave a placeholder:
  1599. </p>
  1600. <pre>define $(PKG)_UPDATE
  1601. echo 'TODO: write update script for $(PKG).' &gt;&amp;2;
  1602. echo $($(PKG)_VERSION)
  1603. endef</pre>
  1604. <p>
  1605. We'll fill that in for you.
  1606. It's a funny exercise.
  1607. </p>
  1608. </li>
  1609. <li>
  1610. <p>
  1611. Check that you don't have "dirty stuff" in your <code>*.mk</code> files,
  1612. such as TAB characters or trailing spaces at lines endings. Run:
  1613. </p>
  1614. <pre>make cleanup-style</pre>
  1615. <p>
  1616. to remove these.
  1617. Have a look at random <code>*.mk</code> files
  1618. to get a feeling for the coding style.
  1619. </p>
  1620. <p>
  1621. The same holds for your test program.
  1622. </p>
  1623. <p>
  1624. However, patch files should always appear
  1625. in the same coding style as the files they are patching.
  1626. </p>
  1627. <p>
  1628. When patching sources with crlf line endings, the patch
  1629. file itself should also have the same eol style. Use the
  1630. convention of naming the file as <code>*crlf.patch</code>
  1631. to instruct git not to normalise the line endings (defined
  1632. in <code>.gitattributes</code>).
  1633. </p>
  1634. <p>
  1635. Finally, in your <code>$(PKG)_BUILD</code> section,
  1636. please check that you use our portability variables:
  1637. </p>
  1638. <table class="translation old">
  1639. <tr><td><code>bash</code></td> <td>&rarr;</td><td><code>$(SHELL)</code></td></tr>
  1640. <tr><td><code>date</code></td> <td>&rarr;</td><td><code>$(DATE)</code></td></tr>
  1641. <tr><td><code>install</code></td> <td>&rarr;</td><td><code>$(INSTALL)</code></td></tr>
  1642. <tr><td><code>libtool</code></td> <td>&rarr;</td><td><code>$(LIBTOOL)</code></td></tr>
  1643. <tr><td><code>libtoolize</code></td><td>&rarr;</td><td><code>$(LIBTOOLIZE)</code></td></tr>
  1644. <tr><td><code>make</code></td> <td>&rarr;</td><td><code>$(MAKE)</code></td></tr>
  1645. <tr><td><code>patch</code></td> <td>&rarr;</td><td><code>$(PATCH)</code></td></tr>
  1646. <tr><td><code>sed</code></td> <td>&rarr;</td><td><code>$(SED)</code></td></tr>
  1647. <tr><td><code>sort</code></td> <td>&rarr;</td><td><code>$(SORT)</code></td></tr>
  1648. <tr><td><code>wget</code></td> <td>&rarr;</td><td><code>$(WGET)</code></td></tr>
  1649. </table>
  1650. </li>
  1651. <li>
  1652. <p>
  1653. Check whether everything runs fine.
  1654. If you have some trouble,
  1655. don't hesitate to ask on the
  1656. <a href="https://lists.nongnu.org/mailman/listinfo/mingw-cross-env-list">mailing list</a>,
  1657. providing your <code>*.mk</code> file so far.
  1658. </p>
  1659. </li>
  1660. <li>
  1661. <p>
  1662. Issue a
  1663. <a href="https://help.github.com/articles/creating-a-pull-request">pull request</a>
  1664. to propose your final <code>*.mk</code> file to us.
  1665. If you have trouble with pull requests,
  1666. send your file to the mailing list instead.
  1667. </p>
  1668. <p>
  1669. Either way,
  1670. don't forget to tell us
  1671. if there are some pieces in your <code>*.mk</code> file
  1672. you feel unsure about.
  1673. We'll then have a specific look at those parts,
  1674. which avoids trouble for you and us in the future.
  1675. </p>
  1676. </li>
  1677. </ol>
  1678. </div>
  1679. <div class="section">
  1680. <h2 id="copyright">Copyright © <span class="years">2007–2015</span></h2>
  1681. <ul id="authors-list" class="compact-list">
  1682. <li>Volker Diels-Grabsch</li>
  1683. <li>Mark Brand</li>
  1684. <li>Tony Theodore</li>
  1685. <li>Martin Gerhardy</li>
  1686. <li>Tiancheng "Timothy" Gu</li>
  1687. <li>Boris Nagaev</li>
  1688. <li><a href="https://github.com/mxe/mxe/graphs/contributors">... and many other contributors</a></li>
  1689. </ul>
  1690. <p>(contact via the
  1691. <a href="https://lists.nongnu.org/mailman/listinfo/mingw-cross-env-list">project mailing list</a>)</p>
  1692. <p>
  1693. Permission is hereby granted, free of charge, to any person obtaining
  1694. a copy of this software and associated documentation files (the
  1695. "Software"), to deal in the Software without restriction, including
  1696. without limitation the rights to use, copy, modify, merge, publish,
  1697. distribute, sublicense, and/or sell copies of the Software, and to
  1698. permit persons to whom the Software is furnished to do so, subject
  1699. to the following conditions:
  1700. </p>
  1701. <p>
  1702. The above copyright notice and this permission notice shall be
  1703. included in all copies or substantial portions of the Software.
  1704. </p>
  1705. <p>
  1706. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  1707. EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  1708. MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
  1709. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
  1710. CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
  1711. TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
  1712. SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  1713. </p>
  1714. </div>
  1715. <div class="section">
  1716. <h2 id="legal">Legal</h2>
  1717. <h3>Disclaimer - it's all code...</h3>
  1718. <p>
  1719. Modern legal systems are like any other large, complex, and evolving body
  1720. of code you're likely to encounter.
  1721. </p>
  1722. <p>
  1723. They have their own language with quirky parsers, compilers, and
  1724. interpreters (though these tend to be human). Their issue trackers are
  1725. a backlog of court cases. They have bugs. They have traps for the
  1726. uninitiated that may potentially do more than waste your time.
  1727. </p>
  1728. <p>
  1729. We currently limit ourselves to:
  1730. </p>
  1731. <pre>--enable-languages='c,c++,objc,fortran'</pre>
  1732. <p>
  1733. so nothing mentioned here or on the mailing list should be taken as
  1734. legal advice. :-)
  1735. </p>
  1736. <h3>Choosing the right compiler</h3>
  1737. <p>
  1738. The best starting point for any legal questions would be the
  1739. </p>
  1740. <p>
  1741. <a href="https://fsfe.org/projects/ftf/">FTF (Freedom Task Force of the FSFE (Free Software Foundation Europe)).</a>
  1742. </p>
  1743. <p>
  1744. They have been very helpful in the past, and maintain an
  1745. <a href="https://fsfe.org/projects/ftf/network.en.html">extensive network</a>
  1746. of legal contacts, both within and outside Europe.
  1747. </p>
  1748. <p>Your local jurisdiction may be a signatory to various
  1749. <a href="https://en.wikipedia.org/wiki/List_of_parties_to_international_copyright_agreements">international agreements,</a>
  1750. so be sure to mention where you are in any correspondence (much like any
  1751. detailed bug report really).
  1752. </p>
  1753. <p>Additionally, you should also do some background reading from the
  1754. <a href="https://www.gnu.org/licenses/gpl-faq.html#GPLIncompatibleLibs">FSF (Free Software Foundation)</a>
  1755. and
  1756. <a href="https://en.wikipedia.org/wiki/GNU_Lesser_General_Public_License">Wikipedia</a>
  1757. to familiarise yourself with some of the potential issues (and experience
  1758. some context-switching overhead).
  1759. </p>
  1760. <h3 id="contributions">Contributions</h3>
  1761. <p>
  1762. Contributions are always welcome!
  1763. </p>
  1764. <p>
  1765. Ownership of all contributions (bug fixes, new packages, doc updates, etc.)
  1766. remain with the author. All we require is a real name (no l33t handles,
  1767. please), and that you release your work under
  1768. <a href="#copyright">our licence</a>.
  1769. </p>
  1770. <p>If you prefer not to be credited with a contribution, please notify
  1771. the committer.
  1772. </p>
  1773. <h3 id="package-licenses">Package Licences</h3>
  1774. <p>
  1775. Each package is individually licensed under terms specified by the
  1776. authors of that package. Please see the respective source tarball
  1777. and/or project website for details.
  1778. </p>
  1779. <p>
  1780. Packages that are
  1781. <a href="https://www.audiocoding.com/faac.html">non-free</a>
  1782. or
  1783. <a href="http://glaros.dtc.umn.edu/gkhome/metis/metis/faq#distribute">ambiguous</a>
  1784. will be
  1785. <a href="https://lists.nongnu.org/archive/html/mingw-cross-env-list/2010-12/msg00049.html">removed</a>
  1786. or
  1787. <a href="https://lists.nongnu.org/archive/html/mingw-cross-env-list/2010-09/msg00063.html">rejected</a>.
  1788. </p>
  1789. <p>
  1790. The definition of free must be one of:
  1791. </p>
  1792. <ul>
  1793. <li><a href="https://www.gnu.org/philosophy/free-sw.html">The Free Software Definition</a></li>
  1794. <li><a href="https://www.debian.org/social_contract#guidelines">The Debian Free Software Guidelines (DFSG)</a></li>
  1795. <li><a href="https://www.opensource.org/osd.html">The Open Source Definition</a></li>
  1796. </ul>
  1797. <p>
  1798. Please contact the
  1799. <a href="https://lists.nongnu.org/mailman/listinfo/mingw-cross-env-list">mailing list</a>
  1800. if you notice a package that doesn't meet these guidlines.
  1801. </p>
  1802. <h3 id="other-legal-considerations">Other Considerations</h3>
  1803. <p>
  1804. In addition to the usual considerations (copyrights, patents,
  1805. trademarks, export regulations etc.), building
  1806. <a href="https://lists.nongnu.org/archive/html/mingw-cross-env-list/2010-12/msg00025.html">statically linked</a>
  1807. libraries
  1808. <a href="https://lists.nongnu.org/archive/html/mingw-cross-env-list/2011-02/msg00018.html">for Windows</a>
  1809. exposes some edge cases that you may not have encountered before.
  1810. </p>
  1811. <p>
  1812. According to
  1813. <a href="https://www.gnu.org/philosophy/free-sw.html">freedom 0</a> and our
  1814. <a href="#copyright">own licence</a>,
  1815. you can use mxe in countless different
  1816. environments, each with it's own special legal considerations. The
  1817. configuration options of certain packages (e.g ffmpeg) allow the use of
  1818. non-free software and/or combinations that cause license violations.
  1819. </p>
  1820. <p>
  1821. For these packages, we will provide sensible defaults aimed
  1822. at achieving the following goals:
  1823. </p>
  1824. <ol>
  1825. <li>avoid causing inherent licensing issues with conflicting options</li>
  1826. <li>make the package as feature complete as possible</li>
  1827. </ol>
  1828. <p>
  1829. Note that this does not prevent downstream violations, or affect any
  1830. further obligations a licence may impose on you.
  1831. </p>
  1832. <h3 id="potential-legal-issues">Potential Issues - Non Exhaustive List</h3>
  1833. <h4>GNU Licenses</h4>
  1834. <p>
  1835. Review the
  1836. <a href="https://www.gnu.org/licenses/gpl-faq.html#content">FAQ</a>
  1837. </p>
  1838. <h4>LGPL and Static Linking</h4>
  1839. <p>
  1840. Review the
  1841. <a href="https://en.wikipedia.org/wiki/GNU_Lesser_General_Public_License#Differences_from_the_GPL">Differences from the GPL</a>
  1842. section of the Wikipedia article mentioned above.
  1843. </p>
  1844. <h4>GPL and OpenSSL</h4>
  1845. <p>
  1846. See conflicting accounts from the
  1847. <a href="https://www.gnu.org/licenses/license-list.html#OpenSSL">FSF</a>
  1848. and the
  1849. <a href="https://www.openssl.org/docs/faq.html#LEGAL2">OpenSSL project</a>.
  1850. </p>
  1851. <p>
  1852. Since August 2015, there is an
  1853. <a href="https://www.openssl.org/blog/blog/categories/license/">
  1854. ongoing effort to re-license to Apache v2</a>.
  1855. </p>
  1856. <h4>FDK AAC and GPL</h4>
  1857. <p>
  1858. The <a href="https://github.com/mstorsjo/fdk-aac/blob/master/NOTICE">FDK license</a>
  1859. has a "no charging fees" clause that likely violates the GPL.
  1860. </p>
  1861. </div>
  1862. <div class="section">
  1863. <h2 id="history">History</h2>
  1864. <dl>
  1865. <dt>2015-05-04 &ndash; Retired the stable branch</dt>
  1866. <dd>
  1867. <p>
  1868. The stable branch
  1869. <a href="https://lists.nongnu.org/archive/html/mingw-cross-env-list/2015-05/msg00004.html">was retired</a>
  1870. as it
  1871. <a href="https://lists.nongnu.org/archive/html/mingw-cross-env-list/2015-03/msg00002.html">did more harm than good</a>.
  1872. Everybody is using the master branch,
  1873. because it is always recent and well enough tested.
  1874. For historical reference, the last commit to the stable branch was
  1875. <a href="https://github.com/mxe/mxe/commits/0c6cc9c91cf94e445ec471a5beebb7199483cb9d" title="0c6cc9c91cf94e445ec471a5beebb7199483cb9d">0c6cc9c</a>,
  1876. which was
  1877. <a href="https://github.com/mxe/mxe/commits/eaac1a873f37bdc4f91e1b649e28b118acedc436" title="eaac1a873f37bdc4f91e1b649e28b118acedc436">fully merged into master</a>
  1878. as usual.
  1879. </p>
  1880. <p>
  1881. Added support for <a href="#supported-toolchains">shared toolchains</a> for over 50% of all the packages.
  1882. </p>
  1883. <p>
  1884. Unfortunately, a number of factors have forced us to drop support
  1885. for MinGW 3 (i.e. "<a href="http://mingw.org/">MinGW.org</a>"),
  1886. in favor of the MinGW-w64 toolchain. This decision was made in a
  1887. large part because of the dropping of support for MinGW by <a
  1888. href="https://github.com/mxe/mxe/pull/453#issuecomment-51703048">
  1889. GLib</a> and <a
  1890. href="https://github.com/mxe/mxe/issues/492#issue-41366666">Qt5</a>,
  1891. which arguably are two of the most important packages in MXE.
  1892. Other considerations have also been taken, like the <a
  1893. href="https://github.com/mxe/mxe/pull/323#issuecomment-39463810">lack
  1894. of maintainership in MinGW</a> and <a
  1895. href="https://github.com/mxe/mxe/issues/400">potential legal
  1896. challenges</a> that comes with using supplemental DirectX
  1897. headers in MinGW in order to support Qt4. Worse yet, having to
  1898. support the unsupported MinGW toolchain impedes adding or
  1899. updating packages, as shown in the <a
  1900. href="https://github.com/mxe/mxe/pull/453#issuecomment-51703048">pull
  1901. request of updating GLib</a>.
  1902. </p>
  1903. <p>
  1904. Please note that dropping support for MinGW <strong>DOES NOT
  1905. MEAN</strong> dropping support for the 32-bit architecture. MinGW-w64
  1906. also supports 32-bit target through i686-w64-mingw32.
  1907. </p>
  1908. <p>
  1909. To ease migration to the supported MinGW-w64 target, we have
  1910. finished porting all packages that were MinGW-only to at least
  1911. i686-w64-mingw32 (32-bit target of MinGW-w64). Hence your existing
  1912. commands should work out-of-the-box assuming the
  1913. <code>MXE_TARGETS</code> environment variable is set correctly.
  1914. </p>
  1915. </dd>
  1916. <dt>2013-07-27 &ndash; Release 2.23</dt>
  1917. <dd>
  1918. <p>
  1919. The stable branch was updated
  1920. to the current development version after a thorough
  1921. <a href="https://lists.nongnu.org/archive/html/mingw-cross-env-list/2013-07/msg00021.html">testing phase</a>.
  1922. </p>
  1923. <p>
  1924. Current users are <strong>strongly</strong> encouraged to
  1925. start with a clean tree as the toolchain has been
  1926. updated and requires a full rebuild:
  1927. </p>
  1928. <pre>git pull && make clean && make</pre>
  1929. <p>
  1930. Most packages were updated to their latest version.
  1931. </p>
  1932. <p>
  1933. Many new packages are supported:
  1934. alure, apr-util, apr, armadillo, cegui, cfitsio, cminpack,
  1935. flann, gtkglarea, gtkimageview, harfbuzz, hdf4, hdf5, hunspell,
  1936. icu4c, itk, lensfun, levmar, libf2c, libftdi, libgda, libgdamm,
  1937. libglade, liblqr-1, libmodplug, librtmp, libzip, log4cxx, mdbtools,
  1938. ncurses, netcdf, netpbm, ocaml-cairo, ocaml-camlimages, ocaml-core,
  1939. ocaml-findlib, ocaml-flexdll, ocaml-lablgl, ocaml-lablgtk2,
  1940. ocaml-native, ocaml-xml-light, opencv, opus, opusfile, pcl,
  1941. picomodel, plib, plibc, poppler, portablexdr, portmidi, protobuf,
  1942. qdbm, qt5, qtactiveqt, qtbase, qtdeclarative, qtgraphicaleffects,
  1943. qtimageformats, qtjsbackend, qtmultimedia, qtquick1, qtquickcontrols,
  1944. qtscript, qtsensors, qtserialport, qtsvg, qttools, qttranslations,
  1945. qtxmlpatterns, qwt, sdl_gfx, sfml, sox, teem, twolame, vtk6, wavpack,
  1946. wget, winpthreads, xapian-core, yasm
  1947. </p>
  1948. <p>
  1949. Added support for <a href="#supported-toolchains">mingw-w64 based toolchains</a>
  1950. targeting 32 &amp; 64-bit architectures.
  1951. </p>
  1952. <p>
  1953. With the addition of Qt5, there is no longer a prefixed version of
  1954. qmake, see the <a href="#tutorial-5c">Qt section of the tutorial</a>
  1955. for the new way to invoke qmake.
  1956. </p>
  1957. <p>
  1958. <a href="#requirements-freebsd">FreeBSD</a> is no longer fully supported.
  1959. Qt5, ocaml*, and 8 other packages are excluded from the build.
  1960. </p>
  1961. </dd>
  1962. <dt id="branches">2012-04-12 &ndash; Release 2.22</dt>
  1963. <dd>
  1964. <p>
  1965. The release tarballs have been replaced with a stable branch
  1966. that conforms to the new branch concept:
  1967. </p>
  1968. <ul class="compact-list">
  1969. <li>
  1970. Any change of a build script goes into "master".
  1971. </li>
  1972. <li>
  1973. Any package upgrade goes into "master".
  1974. </li>
  1975. <li>
  1976. Any documentation upgrade that refers to a feature
  1977. not present in stable goes into "master".
  1978. </li>
  1979. <li>
  1980. Anything else that doesn't affect the build goes
  1981. into "stable".
  1982. </li>
  1983. <li>
  1984. Any non-critical improvement to the main Makefile
  1985. goes into "stable".
  1986. </li>
  1987. <li>
  1988. Any improvement in the package download URLs or
  1989. package version recognition goes into "stable".
  1990. </li>
  1991. <li>
  1992. When in doubt, "master" is used rather than "stable".
  1993. </li>
  1994. <li>
  1995. Every change to the "stable" branch
  1996. will be merged into "master".
  1997. </li>
  1998. <li>
  1999. After a successful testing phase,
  2000. the "stable" branch
  2001. will be fast-forwarded to "master".
  2002. </li>
  2003. </ul>
  2004. <p>
  2005. The project has been
  2006. <a href="https://lists.nongnu.org/archive/html/mingw-cross-env-list/2012-03/msg00101.html">renamed</a>
  2007. from
  2008. mingw-cross-env (MinGW cross compiling environment)
  2009. to
  2010. MXE (M&nbsp;cross&nbsp;environment).
  2011. </p>
  2012. <p>
  2013. Most packages were updated to their latest version.
  2014. </p>
  2015. <p>
  2016. New packages are supported:
  2017. agg, cgal, eigen, file, gta, json-c, libgnurx, libharu,
  2018. libircclient, libssh2, libxml++, llvm, lzo, mpfr, nettle,
  2019. opencsg, qjson, qwtplot3d, vtk, and wt.
  2020. </p>
  2021. </dd>
  2022. <dt>2011-06-07 &ndash; Release 2.21</dt>
  2023. <dd>
  2024. <p>
  2025. <a href="https://bitbucket.org/vog/mingw-cross-env/downloads/mingw-cross-env-2.21.tar.gz">Download</a> |
  2026. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.21">Changelog</a>
  2027. </p>
  2028. <p>
  2029. Minor bugfixes in several packages.
  2030. </p>
  2031. <p>
  2032. Almost all packages are updated to their latest version.
  2033. </p>
  2034. <p>
  2035. Packages gtkmm and gtksourceviewmm have been renamed to gtkmm2 and gtksourceviewmm2.
  2036. </p>
  2037. <p>
  2038. New packages are supported:
  2039. libass, poco, and t4k_common.
  2040. </p>
  2041. </dd>
  2042. <dt>2011-04-05 &ndash; Release 2.20</dt>
  2043. <dd>
  2044. <p>
  2045. <a href="https://bitbucket.org/vog/mingw-cross-env/downloads/mingw-cross-env-2.20.tar.gz">Download</a> |
  2046. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.20">Changelog</a>
  2047. </p>
  2048. <p>
  2049. This release fixes a download error caused by the pixman project
  2050. (a sudden change of their URL scheme without proper redirects).
  2051. <a href="https://www.w3.org/Provider/Style/URI">That sort of thing should never happen!</a>
  2052. </p>
  2053. </dd>
  2054. <dt>2011-03-19 &ndash; Release 2.19</dt>
  2055. <dd>
  2056. <p>
  2057. <a href="https://bitbucket.org/vog/mingw-cross-env/downloads/mingw-cross-env-2.19.tar.gz">Download</a> |
  2058. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.19">Changelog</a>
  2059. </p>
  2060. <p>
  2061. The download mechanisms are improved.
  2062. </p>
  2063. <p>
  2064. A CMake toolchain file is provided
  2065. to simplify cross-compiling projects which use CMake.
  2066. </p>
  2067. <p>
  2068. Support for Debian/Lenny is dropped.
  2069. </p>
  2070. <p>
  2071. Package gtk is renamed to gtk2.
  2072. </p>
  2073. <p>
  2074. Almost all packages are updated to their latest version.
  2075. </p>
  2076. <p>
  2077. New packages are supported:
  2078. dbus, graphicsmagick, libical, liboauth, physfs, and vigra.
  2079. </p>
  2080. <p>
  2081. Note for <code>boost::filesystem</code> users:
  2082. <a href="https://beta.boost.org/doc/libs/1_46_1/libs/filesystem/v3/doc/index.htm">Version 3 is a major revision</a>
  2083. and now the default in 1.46.
  2084. </p>
  2085. </dd>
  2086. <dt>2010-12-15 &ndash; Release 2.18</dt>
  2087. <dd>
  2088. <p>
  2089. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.18.tar.gz">Download</a> |
  2090. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.18">Changelog</a>
  2091. </p>
  2092. <p>
  2093. This release fixes a checksum error caused by the atkmm project
  2094. (a sudden change of their current source tarball).
  2095. <a href="https://www.w3.org/Provider/Style/URI">That sort of thing should never happen!</a>
  2096. </p>
  2097. </dd>
  2098. <dt>2010-12-11 &ndash; Release 2.17</dt>
  2099. <dd>
  2100. <p>
  2101. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.17.tar.gz">Download</a> |
  2102. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.17">Changelog</a>
  2103. </p>
  2104. <p>
  2105. This release provides some improvements of the build system
  2106. such as an automatic check for most of the requirements.
  2107. </p>
  2108. <p>
  2109. All packages are updated to their latest version.
  2110. </p>
  2111. <p>
  2112. New packages are supported:
  2113. bfd, blas, cblas, dcmtk, ftgl, lapack, lcms1,
  2114. mingw-utils, mxml, suitesparse and tinyxml.
  2115. </p>
  2116. </dd>
  2117. <dt>2010-10-27 &ndash; Release 2.16</dt>
  2118. <dd>
  2119. <p>
  2120. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.16.tar.gz">Download</a> |
  2121. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.16">Changelog</a>
  2122. </p>
  2123. <p>
  2124. This release provides lots of improvements to
  2125. the build system as well as the documentation.
  2126. </p>
  2127. <p>
  2128. Support for OpenSolaris is dropped.
  2129. </p>
  2130. <p>
  2131. Almost all packages are updated to their latest version.
  2132. </p>
  2133. <p>
  2134. Many new packages are supported:
  2135. atkmm, cairomm, cunit, faac, faad2, ffmpeg, gdk-pixbuf, glibmm,
  2136. gtkglextmm, gtkmm, gtksourceview, gtksourceviewmm, imagemagick,
  2137. lame, libiberty, libsigc++, libvpx, matio, openal, opencore-amr,
  2138. pangomm, pfstools, plotmm, sdl_sound and x264.
  2139. </p>
  2140. </dd>
  2141. <dt>2010-06-16 &ndash; Release 2.15</dt>
  2142. <dd>
  2143. <p>
  2144. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.15.tar.gz">Download</a> |
  2145. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.15">Changelog</a>
  2146. </p>
  2147. <p>
  2148. This release fixes download errors caused by the Qt project
  2149. (a sudden change of their current source tarball).
  2150. </p>
  2151. <p>
  2152. Almost all packages are updated to their latest version.
  2153. </p>
  2154. </dd>
  2155. <dt>2010-06-08 &ndash; Release 2.14</dt>
  2156. <dd>
  2157. <p>
  2158. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.14.tar.gz">Download</a> |
  2159. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.14">Changelog</a>
  2160. </p>
  2161. <p>
  2162. This release fixes download errors caused by the MinGW project
  2163. (a sudden change of their URL scheme without proper redirects).
  2164. <a href="https://www.w3.org/Provider/Style/URI">That sort of thing should never happen!</a>
  2165. </p>
  2166. <p>
  2167. Almost all packages are updated to their latest version.
  2168. </p>
  2169. <p>
  2170. New packages are supported:
  2171. libarchive, libgee and xvidcore.
  2172. </p>
  2173. </dd>
  2174. <dt>2010-05-31 &ndash; Release 2.13</dt>
  2175. <dd>
  2176. <p>
  2177. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.13.tar.gz">Download</a> |
  2178. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.13">Changelog</a>
  2179. </p>
  2180. <p>
  2181. This release switches back from TDM to the official GCC,
  2182. thus supporting the current GCC&nbsp;4.5.
  2183. </p>
  2184. <p>
  2185. The set of DirectX headers is improved and more complete.
  2186. </p>
  2187. <p>
  2188. The deadlock issues with Pthreads-w32 are fixed.
  2189. </p>
  2190. <p>
  2191. A static build of GDB is provided,
  2192. i.e. a standalone "gdb.exe"
  2193. that doesn't require any extra DLLs.
  2194. </p>
  2195. <p>
  2196. More packages are backed by test programs.
  2197. </p>
  2198. <p>
  2199. Many "sed hacks" are replaced by proper portability patches.
  2200. </p>
  2201. <p>
  2202. Almost all packages are updated to their latest version.
  2203. </p>
  2204. <p>
  2205. Many new packages are supported:
  2206. fribidi, gc, gdb, gmp, gsl, gst-plugins-base, gst-plugins-good,
  2207. gstreamer, gtkglext, guile, libcroco, libffi, liboil, libpaper,
  2208. libshout, libunistring and xine-lib.
  2209. </p>
  2210. </dd>
  2211. <dt>2010-02-21 &ndash; Release 2.12</dt>
  2212. <dd>
  2213. <p>
  2214. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.12.tar.gz">Download</a> |
  2215. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.12">Changelog</a>
  2216. </p>
  2217. <p>
  2218. This release fixes some minor build issues,
  2219. and contains a first small set of test programs
  2220. to check the package builds.
  2221. </p>
  2222. <p>
  2223. The build rules are simplified
  2224. by calling generators like Autotools and Flex,
  2225. instead of patching the generated files.
  2226. </p>
  2227. <p>
  2228. Almost all packages are updated to their latest version.
  2229. </p>
  2230. <p>
  2231. Many new packages are supported:
  2232. aubio, devil, directx, exiv2, fftw, freeimage, gsoap,
  2233. id3lib, liblo, libpano13, librsvg, libsamplerate,
  2234. muparser, openscenegraph, portaudio and sdl_pango.
  2235. </p>
  2236. </dd>
  2237. <dt>2010-02-20 &ndash; Release 2.11</dt>
  2238. <dd>
  2239. <p>
  2240. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.11.tar.gz">Download</a> |
  2241. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.11">Changelog</a>
  2242. </p>
  2243. <p>
  2244. This release contains a packaging bug.
  2245. Please use release 2.12 instead.
  2246. </p>
  2247. </dd>
  2248. <dt>2009-12-23 &ndash; Release 2.10</dt>
  2249. <dd>
  2250. <p>
  2251. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.10.tar.gz">Download</a> |
  2252. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.10">Changelog</a>
  2253. </p>
  2254. <p>
  2255. This release adds support for many new packages:
  2256. flac, libmad, libsndfile, sdl_net, speex, postgresql,
  2257. freetds, openssl, plotutils, taglib, lcms, freeglut,
  2258. xerces and zziplib.
  2259. </p>
  2260. <p>
  2261. Almost all packages are updated to their latest version.
  2262. </p>
  2263. <p>
  2264. In addition to the libraries
  2265. some command line tools such as psql.exe are built, too.
  2266. </p>
  2267. <p>
  2268. The placements of logfiles, as well as many other build details, have been improved.
  2269. </p>
  2270. </dd>
  2271. <dt>2009-10-24 &ndash; Release 2.9</dt>
  2272. <dd>
  2273. <p>
  2274. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.9.tar.gz">Download</a> |
  2275. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.9">Changelog</a>
  2276. </p>
  2277. <p>
  2278. This release adds support for Qt, VMime and libmng.
  2279. </p>
  2280. <p>
  2281. The target triplet is updated to i686-pc-mingw32.
  2282. </p>
  2283. <p>
  2284. OpenMP support is enabled in GCC.
  2285. </p>
  2286. <p>
  2287. Almost all packages are updated to their latest version.
  2288. </p>
  2289. </dd>
  2290. <dt>2009-09-11 &ndash; Release 2.8</dt>
  2291. <dd>
  2292. <p>
  2293. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.8.tar.gz">Download</a> |
  2294. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.8">Changelog</a>
  2295. </p>
  2296. <p>
  2297. This release comes with a better look &amp; feel
  2298. by providing a highlevel overview of the build process.
  2299. </p>
  2300. <p>
  2301. The detailed build messages are stored into
  2302. separate log files for each package,
  2303. so parallel builds don't intermix them anymore.
  2304. </p>
  2305. <p>
  2306. The download URLs of SourceForge packages
  2307. are adjusted to ensure that
  2308. the selected SourceForge mirror is really used
  2309. and not circumvalented via HTTP redirects to other mirrors.
  2310. </p>
  2311. <p>
  2312. Almost all packages are updated to their latest version.
  2313. </p>
  2314. <p>
  2315. The whole mingw-cross-env project has moved to
  2316. <a href="https://savannah.nongnu.org/">Savannah</a>.
  2317. So all URIs have changed,
  2318. but the old URIs
  2319. redirect to the new locations seamlessly.
  2320. </p>
  2321. <p>
  2322. Everyone is invited to join the freshly created
  2323. <a href="https://lists.nongnu.org/mailman/listinfo/mingw-cross-env-list">project mailing list</a>.
  2324. </p>
  2325. </dd>
  2326. <dt>2009-08-11 &ndash; Release 2.7</dt>
  2327. <dd>
  2328. <p>
  2329. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.7.tar.gz">Download</a> |
  2330. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.7">Changelog</a>
  2331. </p>
  2332. <p>
  2333. This release
  2334. provides an improved version recognition
  2335. for SourceForge packages.
  2336. SourceForge changed their page layout
  2337. in a way that makes it much harder
  2338. to identify the current version of a package.
  2339. </p>
  2340. <p>
  2341. Additionally,
  2342. almost all packages are updated to their latest version.
  2343. </p>
  2344. </dd>
  2345. <dt>2009-06-19 &ndash; Release 2.6</dt>
  2346. <dd>
  2347. <p>
  2348. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.6.tar.gz">Download</a> |
  2349. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.6">Changelog</a>
  2350. </p>
  2351. <p>
  2352. This release contains some portability fixes
  2353. which allow it to run on a wider range of systems
  2354. such as Frugalware.
  2355. </p>
  2356. <p>
  2357. The documentation and website are completely revised.
  2358. </p>
  2359. <p>
  2360. New packages such as
  2361. CppUnit, libUsb, NSIS, Popt, SQLite and Theora
  2362. are supported.
  2363. </p>
  2364. <p>
  2365. Almost all packages are updated to their latest version.
  2366. </p>
  2367. <p>
  2368. A new command "make download" is implemented.
  2369. </p>
  2370. </dd>
  2371. <dt>2009-04-06 &ndash; Release 2.5</dt>
  2372. <dd>
  2373. <p>
  2374. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.5.tar.gz">Download</a> |
  2375. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.5">Changelog</a>
  2376. </p>
  2377. <p>
  2378. This release fixes a download error caused by the MinGW project.
  2379. They suddenly changed the names of their source tarballs.
  2380. <a href="https://www.w3.org/Provider/Style/URI">That sort of thing should never happen!</a>
  2381. </p>
  2382. <p>
  2383. This release also contains some bugfixes
  2384. which allow it to run on a wider range of systems.
  2385. </p>
  2386. <p>
  2387. All downloaded files are now
  2388. verified by their SHA-1 checksums.
  2389. </p>
  2390. <p>
  2391. New versions of various packages are supported.
  2392. </p>
  2393. </dd>
  2394. <dt>2009-03-08 &ndash; Release 2.4</dt>
  2395. <dd>
  2396. <p>
  2397. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.4.tar.gz">Download</a> |
  2398. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.4">Changelog</a>
  2399. </p>
  2400. <p>
  2401. This release provides many new libraries such as
  2402. wxWidgets, GTK+ and OpenEXR.
  2403. </p>
  2404. <p>
  2405. In addition, new versions of various packages
  2406. are supported.
  2407. </p>
  2408. </dd>
  2409. <dt>2009-02-09 &ndash; Release 2.3</dt>
  2410. <dd>
  2411. <p>
  2412. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.3.tar.gz">Download</a> |
  2413. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.3">Changelog</a>
  2414. </p>
  2415. <p>
  2416. This release fixes some serious build problems on FreeBSD and MacOS-X.
  2417. </p>
  2418. <p>
  2419. The Makefile has a new target "clean-pkg"
  2420. and allows to be called from a separate build directory
  2421. via "make -f .../Makefile".
  2422. </p>
  2423. <p>
  2424. Some new versions of the packages are supported,
  2425. especially GCC-4.3 by switching from MinGW GCC to
  2426. <a href="http://www.tdragon.net/recentgcc/">TDM-GCC</a>.
  2427. </p>
  2428. </dd>
  2429. <dt>2009-01-31 &ndash; Release 2.2</dt>
  2430. <dd>
  2431. <p>
  2432. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.2.tar.gz">Download</a> |
  2433. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.2">Changelog</a>
  2434. </p>
  2435. <p>
  2436. This release fixes some minor build problems.
  2437. </p>
  2438. <p>
  2439. It also supports some new packages and
  2440. some newer versions of the already supported packages.
  2441. </p>
  2442. <p>
  2443. Parallelization is now disabled by default.
  2444. </p>
  2445. </dd>
  2446. <dt>2008-12-13 &ndash; Release 2.1</dt>
  2447. <dd>
  2448. <p>
  2449. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.1.tar.gz">Download</a> |
  2450. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.1">Changelog</a>
  2451. </p>
  2452. <p>
  2453. This release fixes a download error caused by the GDAL project.
  2454. They suddenly changed their download URLs.
  2455. <a href="https://www.w3.org/Provider/Style/URI">That sort of thing should never happen!</a>
  2456. </p>
  2457. <p>
  2458. In addition, some newer versions of various packages are supported.
  2459. </p>
  2460. <p>
  2461. There is also a small compatibility fix for OS X.
  2462. </p>
  2463. </dd>
  2464. <dt>2008-11-10 &ndash; Release 2.0</dt>
  2465. <dd>
  2466. <p>
  2467. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-2.0.tar.gz">Download</a> |
  2468. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/2.0">Changelog</a>
  2469. </p>
  2470. <p>
  2471. The shell script has been rewritten as Makefile
  2472. and supports partial builds and parallel builds.
  2473. </p>
  2474. <p>
  2475. As usual,
  2476. this release also supports some new packages and
  2477. some newer versions of the already supported packages.
  2478. </p>
  2479. </dd>
  2480. <dt>2008-01-11 &ndash; Release 1.4</dt>
  2481. <dd>
  2482. <p>
  2483. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-1.4.tar.gz">Download</a> |
  2484. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/1.4">Changelog</a>
  2485. </p>
  2486. <p>
  2487. This release now includes a tutorial by Hans Bezemer
  2488. and has improved compile options of FLTK.
  2489. As usual, it supports some newer versions of the libraries.
  2490. </p>
  2491. <p>
  2492. At the <a href="https://www.fefe.de/nowindows/">request of its author</a>,
  2493. libowfat is no longer supported from this release on.
  2494. </p>
  2495. <p>
  2496. The script now uses a specific SourceForge mirror
  2497. instead of randomly chosen ones,
  2498. because the download phase
  2499. often stumbled on some very slow mirrors.
  2500. </p>
  2501. </dd>
  2502. <dt>2007-12-23 &ndash; Release 1.3</dt>
  2503. <dd>
  2504. <p>
  2505. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-1.3.tar.gz">Download</a> |
  2506. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/1.3">Changelog</a>
  2507. </p>
  2508. <p>
  2509. A sudden change in the download URLs of GEOS
  2510. made the automatic download fail.
  2511. <a href="https://www.w3.org/Provider/Style/URI">Such changes should never happen!</a>
  2512. But it happened,
  2513. and this quick release is an attempt to limit the damage.
  2514. </p>
  2515. <p>
  2516. This release also supports some newer versions of the libraries
  2517. including support for fontconfig-2.5.0.
  2518. </p>
  2519. </dd>
  2520. <dt>2007-12-13 &ndash; Release 1.2</dt>
  2521. <dd>
  2522. <p>
  2523. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-1.2.tar.gz">Download</a> |
  2524. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/1.2">Changelog</a>
  2525. </p>
  2526. <p>
  2527. This release is a switch from gcc-3 to gcc-4.
  2528. It also supports a new library and
  2529. some newer versions of the already supported libraries.
  2530. </p>
  2531. </dd>
  2532. <dt>2007-07-24 &ndash; Release 1.1</dt>
  2533. <dd>
  2534. <p>
  2535. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-1.1.tar.gz">Download</a> |
  2536. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/1.1">Changelog</a>
  2537. </p>
  2538. <p>
  2539. This release is the result of the public attention the release 1.0 got.
  2540. It contains many improvements suggested by its first users,
  2541. and adds support for many new libraries.
  2542. </p>
  2543. <p>
  2544. Thanks to Rocco Rutte who contributed many code snippets.
  2545. </p>
  2546. </dd>
  2547. <dt>2007-06-19 &ndash; Release 1.0</dt>
  2548. <dd>
  2549. <p>
  2550. <a href="https://download.savannah.nongnu.org/releases/mingw-cross-env/mingw-cross-env-1.0.tar.gz">Download</a> |
  2551. <a href="https://hg.savannah.nongnu.org/hgweb/mingw-cross-env/log/1.0">Changelog</a>
  2552. </p>
  2553. <p>
  2554. This first release has been created in a 7-day-sprint.
  2555. </p>
  2556. </dd>
  2557. <dt>2007-06-12 &ndash; Project start</dt>
  2558. <dd>
  2559. </dd>
  2560. </dl>
  2561. </div>
  2562. <div class="section">
  2563. <h2 id="see-also">See also</h2>
  2564. <h3>This project</h3>
  2565. <ul class="compact-list">
  2566. <li>
  2567. <a href="https://mxe.cc/">Website</a>
  2568. </li>
  2569. <li>
  2570. <a href="https://github.com/mxe/mxe">Project on GitHub</a>
  2571. </li>
  2572. <li>
  2573. <a href="http://pkg.mxe.cc/">Binary distribution of packages</a>
  2574. </li>
  2575. <li>
  2576. <a href="https://www.openhub.net/p/mxe">Entry on Open Hub</a>
  2577. </li>
  2578. <li>
  2579. <a href="https://savannah.nongnu.org/projects/mingw-cross-env">Entry on Savannah</a>
  2580. </li>
  2581. <li>
  2582. <a href="https://lists.debian.org/debian-embedded/2007/06/msg00007.html">First release announcement</a>
  2583. and the discussion around it
  2584. </li>
  2585. </ul>
  2586. <h3>Related articles</h3>
  2587. <ul>
  2588. <li>
  2589. <a href="https://valdyas.org/fading/hacking/cross-compiling-krita-using-mxe/">Cross-compiling Krita using MXE</a>
  2590. <br>
  2591. Experience report of the
  2592. <a href="https://krita.org/">Krita project</a>
  2593. </li>
  2594. <li>
  2595. <a href="https://thebeezspeaks.blogspot.com/2009/04/cross-compilers-new-wave.html">Cross compilers, the new wave</a>
  2596. <br>
  2597. Appeared on
  2598. <a href="http://lxer.com/module/newswire/view/118868">LXer</a>
  2599. and
  2600. <a href="https://www.linuxtoday.com/developer/2009041501335RVSWDV">Linux Today</a>
  2601. </li>
  2602. <li>
  2603. <a href="http://www.mingw.org/wiki/LinuxCrossMinGW">MinGW cross compiler for Linux build environment</a>
  2604. <br>
  2605. Official tutorial of the
  2606. <a href="http://www.mingw.org/">MinGW project</a>
  2607. </li>
  2608. <li>
  2609. <a href="https://wiki.wxwidgets.org/Cross-Compiling_Under_Linux#Cross-compiling_under_Linux_for_MS_Windows">Cross-compiling under Linux for MS Windows</a>
  2610. <br>
  2611. Old tutorial provided by the
  2612. <a href="https://www.wxwidgets.org/">wxWidgets project</a>
  2613. </li>
  2614. </ul>
  2615. <h3>Related projects</h3>
  2616. <ul>
  2617. <li>
  2618. <a href="https://www.archlinux.org/groups/x86_64/mingw-w64/">Arch Linux mingw-w64 packages</a>
  2619. <br>
  2620. Win32 cross compiling packages by Arch Linux
  2621. </li>
  2622. <li>
  2623. <a href="https://packages.debian.org/stable/devel/mingw32">Debian mingw32 package</a>
  2624. <br>
  2625. Bare win32 cross compiler
  2626. </li>
  2627. <li>
  2628. <a href="https://admin.fedoraproject.org/pkgdb/packages/mingw*/">Fedora MinGW packages</a>
  2629. <br>
  2630. Win32 cross compiling packages by Fedora
  2631. </li>
  2632. <li>
  2633. <a href="https://msys2.github.io/">MSYS2</a>
  2634. <br>
  2635. Win32/64 ports of many free software packages
  2636. </li>
  2637. <li>
  2638. <a href="https://gnuwin32.sourceforge.io/">GnuWin32</a>
  2639. <br>
  2640. Win32 ports of many free software packages
  2641. </li>
  2642. <li>
  2643. <a href="http://www.sandroid.org/imcross/">IMCROSS</a>
  2644. <br>
  2645. Another project with similar goal
  2646. </li>
  2647. <li>
  2648. <a href="https://www.libsdl.org/extras/win32/cross/README.txt">MinGW cross-compiler build script</a>
  2649. <br>
  2650. Old script provided by the
  2651. <a href="https://www.libsdl.org/">SDL project</a>
  2652. </li>
  2653. <li>
  2654. <a href="https://comments.gmane.org/gmane.comp.gnu.octave.maintainers/30358">mxe-octave</a>
  2655. <br>
  2656. Fork of MXE specialized on building
  2657. <a href="https://www.gnu.org/software/octave/">GNU Octave</a>
  2658. </li>
  2659. <li>
  2660. <a href="https://software.opensuse.org/search?q=mingw&baseproject=openSUSE%3A13.2&search_devel=false&search_unsupported=false">openSUSE MinGW packages</a>
  2661. <br>
  2662. Win32 cross compiling packages by openSUSE
  2663. </li>
  2664. <li>
  2665. <a href="http://win-builds.org/">Win-builds</a>
  2666. <br>
  2667. Creates binary packages, runs on both Linux and Windows
  2668. </li>
  2669. </ul>
  2670. </div>
  2671. <div class="section">
  2672. <h2 id="used-by">Projects which use MXE (alphabetical order)</h2>
  2673. <ul class="compact-list">
  2674. <li>
  2675. <a href="https://sourceforge.net/projects/aorta/">Aorta</a>
  2676. </li>
  2677. <li>
  2678. <a href="https://github.com/zer0main/battleship">Battleship game</a>
  2679. </li>
  2680. <li>
  2681. <a href="https://bino3d.org/">Bino</a>
  2682. </li>
  2683. <li>
  2684. <a href="https://biosig.sourceforge.io/">BioSig</a>
  2685. </li>
  2686. <li>
  2687. <a href="http://en.cataclysmdda.com/">Cataclysm: Dark Days Ahead</a>
  2688. </li>
  2689. <li>
  2690. <a href="https://cvtool.sourceforge.io/">cvtool</a>
  2691. </li>
  2692. <li>
  2693. <a href="https://www.qtrac.eu/diffpdf.html">DiffPDF</a>
  2694. </li>
  2695. <li>
  2696. <a href="https://www.digikam.org/">digiKam</a>
  2697. </li>
  2698. <li>
  2699. <a href="https://github.com/eiskaltdcpp/eiskaltdcpp">EiskaltDC++</a>
  2700. </li>
  2701. <li>
  2702. <a href="https://github.com/ThKattanek/emu64">Emu64</a>
  2703. </li>
  2704. <li>
  2705. <a href="https://www.ros.org/wiki/eros">Eros</a>
  2706. </li>
  2707. <li>
  2708. <a href="https://www.nongnu.org/galois/">Galois</a>
  2709. </li>
  2710. <li>
  2711. <a href="https://www.gcompris.net/">GCompris</a>
  2712. </li>
  2713. <li>
  2714. <a href="https://www.nongnu.org/gta/">Generic Tagged Arrays</a>
  2715. </li>
  2716. <li>
  2717. <a href="https://www.gnu.org/software/freedink/">GNU FreeDink</a>
  2718. </li>
  2719. <li>
  2720. <a href="http://ifwiki.org/index.php/Hugor">Hugor</a>
  2721. </li>
  2722. <li>
  2723. <a href="https://krita.org/">Krita</a>
  2724. </li>
  2725. <li>
  2726. <a href="https://lightspark.github.io/">Lightspark</a>
  2727. </li>
  2728. <li>
  2729. <a href="https://alephone.lhowon.org/">Marathon Aleph One</a>
  2730. </li>
  2731. <li>
  2732. <a href="https://www.maxr.org/">Mechanized Assault and eXploration Reloaded</a>
  2733. </li>
  2734. <li>
  2735. <a href="https://www.bunkus.org/videotools/mkvtoolnix/">MKVToolNix</a>
  2736. </li>
  2737. <li>
  2738. <a href="https://mpop.sourceforge.io/">mpop</a>
  2739. </li>
  2740. <li>
  2741. <a href="https://msmtp.sourceforge.io/">msmtp</a>
  2742. </li>
  2743. <li>
  2744. <a href="https://www.openscad.org/">OpenSCAD</a>
  2745. </li>
  2746. <li>
  2747. <a href="https://pdfgrep.org/">Pdfgrep</a>
  2748. </li>
  2749. <li>
  2750. <a href="https://www.pokerth.net/">PokerTH</a>
  2751. </li>
  2752. <li>
  2753. <a href="https://psi-plus.com/">Psi+</a>
  2754. </li>
  2755. <li>
  2756. <a href="https://pushover.sourceforge.io/">Pushover</a>
  2757. </li>
  2758. <li>
  2759. <a href="https://qelectrotech.org/">QElectroTech</a>
  2760. </li>
  2761. <li>
  2762. <a href="https://qtads.sourceforge.io/">QTads</a>
  2763. </li>
  2764. <li>
  2765. <a href="https://github.com/sibuserv/sibuserv">Sibuserv</a>
  2766. </li>
  2767. <li>
  2768. <a href="https://sigrok.org/">sigrok</a>
  2769. </li>
  2770. <li>
  2771. <a href="http://spek-project.org/">Spek</a>
  2772. </li>
  2773. <li>
  2774. <a href="https://springrts.com/">Spring RTS</a>
  2775. </li>
  2776. <li>
  2777. <a href="https://subsurface-divelog.org/">Subsurface</a>
  2778. </li>
  2779. <li>
  2780. <a href="https://taisei-project.org/">Taisei Project</a>
  2781. </li>
  2782. <li>
  2783. <a href="https://thebeez.home.xs4all.nl/4tH/">The 4tH Compiler</a>
  2784. </li>
  2785. <li>
  2786. <a href="https://www.tug.org/texworks/">TeXworks</a>
  2787. </li>
  2788. <li>
  2789. <a href="https://toppler.sourceforge.io/">Tower Toppler</a>
  2790. </li>
  2791. <li>
  2792. <a href="https://tux4kids.alioth.debian.org/tuxtype/">Tux Typing</a>
  2793. </li>
  2794. <li>
  2795. <a href="https://tux4kids.alioth.debian.org/tuxmath/">Tux Math</a>
  2796. </li>
  2797. <li>
  2798. <a href="http://ph.on.things.free.fr/projects/ube/">Ube</a>
  2799. </li>
  2800. <li>
  2801. <a href="https://ufoai.org/">UFO: Alien Invasion</a>
  2802. </li>
  2803. <li>
  2804. <a href="https://violetland.github.io/">Violetland</a>
  2805. </li>
  2806. <li>
  2807. <a href="https://wz2100.net/">Warzone 2100</a>
  2808. </li>
  2809. <li>
  2810. <a href="https://wkhtmltopdf.org/">wkhtmltopdf</a>
  2811. </li>
  2812. <li>
  2813. <a href="https://sourceforge.net/projects/xfemm/">xfemm</a>
  2814. </li>
  2815. </ul>
  2816. </div>
  2817. </body>
  2818. </html>