U:RDoc::TopLevel[	iI"win32/README.win32:ETcRDoc::Parser::Simpleo:RDoc::Markup::Document:@parts[S:RDoc::Markup::Heading:
leveli:	textI"'How to build ruby using Visual C++;To:RDoc::Markup::BlankLineS;	;
i;I"Requirement;T@
o:RDoc::Markup::List:
@type:NUMBER:@items[
o:RDoc::Markup::ListItem:@label0;[o:RDoc::Markup::Paragraph;[I"Windows 7 or later.;T@
o;;0;[o;;[I"%Visual C++ 12.0 (2013) or later.;T@
o;
;:
LABEL;[o;;[I"	Note;T;[o;;[I"?if you want to build x64 version, use native compiler for ;TI"	x64.;T@
o;;0;[	o;;[I">Please set environment variable +INCLUDE+, +LIB+, +PATH+ ;TI"=to run required commands properly from the command line.;T@
o;
;;;[o;;[I"	Note;T;[o;;[I"/building ruby requires following commands.;To;
;:BULLET;[
o;;0;[o;;[I"
nmake;To;;0;[o;;[I"cl;To;;0;[o;;[I"ml;To;;0;[o;;[I"lib;To;;0;[o;;[I"dumpbin;T@
o;;0;[o;;[I"KIf you want to build from GIT source, following commands are required.;To;
;;;[	o;;0;[o;;[I"
bison;To;;0;[o;;[I"
patch;To;;0;[o;;[I"sed;To;;0;[o;;[I"ruby 2.0 or later;T@
o;;0;[o;;[I"OEnable Command Extension of your command line.  It's the default behavior ;TI"Lof +cmd.exe+.  If you want to enable it explicitly, run +cmd.exe+ with ;TI"<tt>/E:ON</tt> option.;T@
S;	;
i;I"How to compile and install;T@
o;
;;;[o;;0;[o;;[I"CExecute <tt>win32\configure.bat</tt> on your build directory. ;TI"9You can specify the target platform as an argument. ;TI"AFor example, run `<tt>configure --target=i686-mswin32</tt>' ;TI"1You can also specify the install directory. ;TI"HFor example, run `<tt>configure --prefix=<install_directory></tt>' ;TI"9Default of the install directory is <tt>/usr</tt> . ;TI"HThe default _PLATFORM_ is `+i386-mswin32_+_MSRTVERSION_' on 32-bit ;TI"Cplatforms, or `+x64-mswin64_+_MSRTVERSION_' on x64 platforms. ;TI"B_MSRTVERSION_ is the 2- or 3-digits version of the Microsoft ;TI"Runtime Library.;T@
o;;0;[o;;[	I"AChange _RUBY_INSTALL_NAME_ and _RUBY_SO_NAME_ in +Makefile+ ;TI"=if you want to change the name of the executable files. ;TI"<And add _RUBYW_INSTALL_NAME_ to change the name of the ;TI"8executable without console window if also you want.;T@
o;;0;[o;;[I"ARun `<tt>nmake up</tt>' if you are building from GIT source.;T@
o;;0;[o;;[I"Run `<tt>nmake</tt>';T@
o;;0;[o;;[I"Run `<tt>nmake check</tt>';T@
o;;0;[o;;[I"!Run `<tt>nmake install</tt>';T@
S;	;
i;I"
Icons;T@
o;;[	I"NAny icon files(*.ico) in the build directory, directories specified with ;TI"C_icondirs_ make variable and +win32+ directory under the ruby ;TI"Msource directory will be included in DLL or executable files, according ;TI"to their base names.;To:RDoc::Markup::Verbatim;[I"I$(RUBY_INSTALL_NAME).ico or ruby.ico   --> $(RUBY_INSTALL_NAME).exe
;TI"J$(RUBYW_INSTALL_NAME).ico or rubyw.ico --> $(RUBYW_INSTALL_NAME).exe
;TI"Dthe others                             --> $(RUBY_SO_NAME).dll
;T:@format0o;;[	I"IAlthough no icons are distributed with the ruby source, you can use ;TI"Panything you like. You will be able to find many images by search engines. ;TI"6For example, followings are made from {Ruby logo ;TI"Gkit}[https://cache.ruby-lang.org/pub/misc/logo/ruby-logo-kit.zip]:;T@
o;
;;;[o;;0;[o;;[I"LSmall {favicon}[https://www.ruby-lang.org/favicon.ico] in the official ;TI"	site;T@
o;;0;[o;;[I"7http://ruby.morphball.net/vit-ruby-ico_en.html or ;TI"?{icon itself}[http://ruby.morphball.net/icon/vit-ruby.ico];T@
S;	;
i;I"Build examples;T@
o;
;;;[	o;;0;[	o;;[I"(Build on the ruby source directory.;T@
o;;[I"	ex.);To;;[I"%ruby source directory:  C:\ruby
;TI"%build directory:        C:\ruby
;TI"*install directory:      C:\usr\local
;TI"
;TI"C:
;TI"cd \ruby
;TI")win32\configure --prefix=/usr/local
;TI"nmake
;TI"nmake check
;TI"nmake install
;T;0o;;0;[	o;;[I"DBuild on the relative directory from the ruby source directory.;T@
o;;[I"	ex.);To;;[I"%ruby source directory:  C:\ruby
;TI"-build directory:        C:\ruby\mswin32
;TI"*install directory:      C:\usr\local
;TI"
;TI"C:
;TI"cd \ruby
;TI"mkdir mswin32
;TI"cd mswin32
;TI",..\win32\configure --prefix=/usr/local
;TI"nmake
;TI"nmake check
;TI"nmake install
;T;0o;;0;[	o;;[I""Build on the different drive.;T@
o;;[I"	ex.);To;;[I")ruby source directory:  C:\src\ruby
;TI"+build directory:        D:\build\ruby
;TI"*install directory:      C:\usr\local
;TI"
;TI"D:
;TI"cd D:\build\ruby
;TI"5C:\src\ruby\win32\configure --prefix=/usr/local
;TI"nmake
;TI"nmake check
;TI"nmake install DESTDIR=C:
;T;0o;;0;[	o;;[I":Build x64 version (requires native x64 VC++ compiler);T@
o;;[I"	ex.);To;;[I"%ruby source directory:  C:\ruby
;TI"%build directory:        C:\ruby
;TI"*install directory:      C:\usr\local
;TI"
;TI"C:
;TI"cd \ruby
;TI">win32\configure --prefix=/usr/local --target=x64-mswin64
;TI"nmake
;TI"nmake check
;TI"nmake install
;T;0S;	;
i;I"	Bugs;T@
o;;[I"OYou can *NOT* use a path name that contains any white space characters as ;TI"Lthe ruby source directory, this restriction comes from the behavior of ;TI"1<code>!INCLUDE</code> directives of +NMAKE+.;T@
o;;[I"IYou can build ruby in any directory including the source directory, ;TI"7except +win32+ directory in the source directory. ;TI"JThis is restriction originating in the path search method of +NMAKE+.;T:
@file@:0@omit_headings_from_table_of_contents_below0