mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
52a67fe60d
separate files under directories due to directory separator. * */Makefile.sub (MKFILES): common.mk and */Makefile.sub should not be removed. * win32/Makefile.sub, wince/Makefile.sub: $* cannot appear in explicit rules. * cygwin/GNUmakefile.in: some mingw stuffs were missed. * lib/mkmf.rb (create_makefile): Borland make wrongly removes braces from command lines. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@6001 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
122 lines
3.7 KiB
Text
122 lines
3.7 KiB
Text
=begin
|
|
|
|
= How to build ruby using eMbedded Visual C++
|
|
|
|
== Requirement
|
|
|
|
(1) eMbedded Visual C++ 3.0 or later.
|
|
|
|
(2) ruby executable on the compiling host environment.
|
|
|
|
(3) Please set environment variable (({INCLUDE})), (({LIB})), (({PATH})),
|
|
(({CE_TOOLS_DIR})), (({EMBEDDED_TOOLS_DIR})) to run required commands
|
|
properly from the command line.
|
|
|
|
Note: building ruby requires following commands.
|
|
* nmake
|
|
* clarm or clmips or shcl
|
|
* lib
|
|
* dumpbin
|
|
|
|
== How to compile and install
|
|
|
|
(1) Execute wince\configure.bat on your build directory.
|
|
You can specify the target platform as an argument.
|
|
For example, run `((%configure arm-hpc2k-wince%))'
|
|
You can also specify the install directory.
|
|
For example, run `((%configure --prefix=<install_directory>%))'
|
|
Default of the install directory is /usr .
|
|
|
|
(2) Change ((|RUBY_INSTALL_NAME|)) and ((|RUBY_SO_NAME|)) in (({Makefile}))
|
|
if you want to change the name of the executable files.
|
|
|
|
(3) Run `((%nmake%))'
|
|
|
|
(4) Run `((%nmake DESTDIR=<install_directory> install%))'
|
|
|
|
This command will create following directories and copy (not install :-P)
|
|
files onto them.
|
|
* <install_directory>\bin
|
|
* <install_directory>\lib
|
|
* <install_directory>\lib\ruby
|
|
* <install_directory>\lib\ruby\<MAJOR>.<MINOR>
|
|
* <install_directory>\lib\ruby\<MAJOR>.<MINOR>\<PLATFORM>
|
|
* <install_directory>\lib\ruby\site_ruby
|
|
* <install_directory>\lib\ruby\site_ruby\<MAJOR>.<MINOR>
|
|
* <install_directory>\lib\ruby\site_ruby\<MAJOR>.<MINOR>\<PLATFORM>
|
|
* <install_directory>\man\man1
|
|
If Ruby's version is `x.y.z', the ((|<MAJOR>|)) is `x' and the ((|<MINOR>|)) is `y'.
|
|
In case of `mips-hpc2k-wince', The ((|<PLATFORM>|)) is `(({mips-mswince}))'.
|
|
|
|
(5) Copy <install_directory> to your WindowsCE machine.
|
|
|
|
== Icons
|
|
|
|
Any icon files(*.ico) in the build directory, directories specified with
|
|
((|icondirs|)) make variable and (({win32})) directory under the ruby
|
|
source directory will be included in DLL or executable files, according
|
|
to their base names.
|
|
$(RUBY_INSTALL_NAME).ico or ruby.ico --> $(RUBY_INSTALL_NAME).exe
|
|
$(RUBYW_INSTALL_NAME).ico or rubyw.ico --> $(RUBYW_INSTALL_NAME).exe
|
|
the others --> $(RUBY_SO_NAME).dll
|
|
|
|
Although no icons are distributed with the ruby source or in the official
|
|
site, you can use anything you like. For example, followings are written
|
|
in Japanese, but you can download at least.
|
|
|
|
* ((<URL:http://member.nifty.ne.jp/ueivu/rubyico.html>)) or
|
|
((<zipped icons|URL:http://member.nifty.ne.jp/ueivu/Ruby_ico.zip>))
|
|
* ((<URL:http://homepage1.nifty.com/a_nakata/ruby/>)) or
|
|
((<icon itself|URL:http://homepage1.nifty.com/a_nakata/ruby/RubyIcon.ico>))
|
|
|
|
== Build examples
|
|
|
|
* Build on the ruby source directory.
|
|
|
|
ex.)
|
|
ruby source directory: C:\ruby
|
|
build directory: C:\ruby
|
|
install directory: C:\usr\local
|
|
|
|
C:
|
|
cd \ruby
|
|
win32\configure --prefix=/usr/local
|
|
nmake
|
|
nmake install
|
|
|
|
* Build on the relative directory from the ruby source directory.
|
|
|
|
ex.)
|
|
ruby source directory: C:\ruby
|
|
build directory: C:\ruby\mswin32
|
|
install directory: C:\usr\local
|
|
|
|
C:
|
|
cd \ruby
|
|
mkdir mswin32
|
|
cd mswin32
|
|
..\win32\configure --prefix=/usr/local
|
|
nmake
|
|
nmake install
|
|
|
|
* Build on the different drive.
|
|
|
|
ex.)
|
|
ruby source directory: C:\src\ruby
|
|
build directory: D:\build\ruby
|
|
install directory: C:\usr\local
|
|
|
|
D:
|
|
cd D:\build\ruby
|
|
C:\src\ruby\win32\configure --prefix=C:/usr/local
|
|
nmake
|
|
nmake install
|
|
|
|
== Bugs
|
|
|
|
You can ((*NOT*)) use a path name contains any white space characters as
|
|
the ruby source directory, this restriction comes from the behavior of
|
|
(({!INCLUDE})) directives of (({NMAKE})).
|
|
((- you may call it a bug. -))
|
|
|
|
=end
|