Latest commit 1014cb9 Jan 8, 2008 @nobu nobu * win{32,ce}/Makefile.sub: merged.
git-svn-id: http://svn.ruby-lang.org/repos/ruby/branches/ruby_1_8@14955 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Permalink
..
Failed to load latest commit information.
sys * configure.in: Check for the availability of pid_t, gid_t and uid_t and May 14, 2005
Makefile.sub * win{32,ce}/Makefile.sub: merged. Jan 8, 2008
README.wince * wince/ : files removed. Apr 26, 2003
assert.c * wince/ : files removed. Apr 26, 2003
assert.h * wince/ : files removed. Apr 26, 2003
configure.bat * {bcc32,djgpp,win32,wince}/*.bat: add svn properties to DOSISH batch… Dec 21, 2006
direct.c * wince/ : files removed. Apr 26, 2003
direct.h * file.c (utimbuf): use utimbuf instead of _utimbuf if defined _WIN32. Jan 4, 2003
errno.c WinCE patch merged Dec 2, 2002
errno.h WinCE patch merged Dec 2, 2002
fcntl.h WinCE patch merged Dec 2, 2002
io.h * wince/ : files removed. Apr 26, 2003
io_wce.c * wince/ : files removed. Apr 26, 2003
process.h * wince/ : files removed. Apr 26, 2003
process_wce.c * wince/ : files removed. Apr 26, 2003
setup.mak * {win32,wince,bcc32}/setup.mak (-version-): no RUBY_EXTERN magic. Jul 21, 2007
signal.h WinCE patch merged Dec 2, 2002
signal_wce.c * wince/ : files removed. Apr 26, 2003
stddef.h WinCE patch merged Dec 2, 2002
stdio.c * wince/ : files removed. Apr 26, 2003
stdlib.c * wince/stdlib.c: add bsearch(). Jul 19, 2003
string_wce.c * wince/string_wce.c (strrchr): should decrement pointer. Oct 31, 2003
time.h * wince/ : files removed. Apr 26, 2003
time_wce.c *wince/time_wce.c (time): add zero check. Sep 30, 2003
varargs.h WinCE patch merged Dec 2, 2002
wince.c * wince/ : files removed. Apr 26, 2003
wince.h * wince/ : files removed. Apr 26, 2003
wincemain.c * wince/ : files removed. Apr 26, 2003
wincon.h WinCE patch merged Dec 2, 2002
winsock2.c WinCE patch merged Dec 2, 2002

README.wince

=begin

= How to build ruby using eMbedded Visual C++

== Requirement

(1) eMbedded Visual C++ 3.0 or later.

(2) If you want to run `((%nmake clean%))' or `((%nmake distclean%))'
    properly, you must install UNIX compatible `((%rm%))' command on
    your ((|PATH|)) if you want to clean after compile.

(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%))'

(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
    nmake
    nmake DESTDIR=/usr/local 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
    nmake
    nmake DESTDIR=/usr/local 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
    nmake
    nmake DESTDIR=C:/usr/local 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