@input texinfo @c -*- Texinfo -*-
@c %**start of header
@setfilename Building.mingw.info
@include base/article.texi
@include building/command.texi
@paragraphindent none

@set BG.platform mingw
@c %**end of header

@majorheading Guide to Building @value{HB.title} on @value{OS.@value{BG.platform}}
@contents
@include building/chapter.introduction.texi

@c %**-------------------------------------------------------------------------
@anchor{prerequisites}
@chapter Prerequisites
The following are the recommended specifications for building on @value{OS.mingw}; but is not necessarily the only configuration that is possible:

@itemize @bullet
@item Intel 32-bit or 64-bit hardware
@item @value{OS.mingw} on Fedora 16, Ubuntu or Debian, gcc 4.5+
@item yasm 1.1.x.x (for i386 or x86_64 architectures)
@end itemize

@include building/prerequisites.bundled.texi

@quotation Note
You must set the --cross flag with configure to cross compile with windows.
See the Example below. Note that the cross compiler name varies between distributions.

As of this writing, @value{OS.mingw} has available to it several versions of gcc; only one of which may be found and used in the path as @code{gcc} and @code{g++}. Configure will thus find what is probably the older version of gcc in a typical @value{OS.mingw} environment. If you desire to build with the newer gcc, it is found in the path as @command{gcc-4} and @command{g++-4} respectively and you must indicate to configure the desired versions. The following syntax should do the trick:
@end quotation

@example
../configure --cross=i686-pc-mingw32 --gcc=gcc-4
@end example

@include building/prerequisites.common.texi

@c %**-------------------------------------------------------------------------
@include building/chapter.quickstart.texi

@anchor{overview}
@chapter Overview
@value{OS.mingw} builds are performed from a @b{terminal}. There is no support for building from any IDEs.

@c %**-------------------------------------------------------------------------
@include building/chapter.via.terminal.texi
@include building/chapter.troubleshooting.texi
@include building/appendix.repo.texi