From 61e00f28a6df92138dc3049da760d5245d63ed69 Mon Sep 17 00:00:00 2001
From: uema2 <uema2@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>
Date: Sat, 26 Apr 2003 05:25:30 +0000
Subject: * wince/ : files removed.            (config, dll.mak, exe.mak,
 mswince-ruby17.def,             io.c, process.c, signal.c, string.c, time.c)

* wince/ : files added.
         (assert.c, Makefile.sub, mkexports.rb, io_wce.c,
            process_wce.c, signal_wce.c, string_wce.c,
            time_wce.c)

* wince/configure.bat : like mswin32 style.

* wince/direct.c : remove "static" at _currentdir.

* wince/io.h : change definition.

* wince/stdio.c : _fdopen -> fdopen.

* wince/process.h : add_P_OVERLAY.

* wince/time.h : change definition.

* wince/wincemain.c : add wce_SetCurrentDir.

* wince/wince.c : add wce_SetCurrentDir and wce_fopen.
	                  fix GetModuleFileNameA to return correct "lpFileName".

* wince/wince.h : remove #ifdef.

* wince/sys/utime.h, utime.c : rename _utime to utime.

* wince/sys/stat.c : expand relative directory in stat.


git-svn-id: http://svn.ruby-lang.org/repos/ruby/trunk@3734 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
---
 wince/README.wince | 101 ++++++++++++++++++++++++++++++++++++++++++-----------
 1 file changed, 80 insertions(+), 21 deletions(-)

(limited to 'wince/README.wince')

diff --git a/wince/README.wince b/wince/README.wince
index c4c67df37..795dc710e 100644
--- a/wince/README.wince
+++ b/wince/README.wince
@@ -6,27 +6,48 @@
 
 (1) eMbedded Visual C++ 3.0 or later.
 
-== How to compile and install
+(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.
 
-(1) Move to ruby\wince directory.
+    Note: building ruby requires following commands.
+     * nmake
+     * clarm or clmips or shcl
+     * lib
+     * dumpbin
 
-(2) if you changed install directories of eMVC and SDK from default
-    settings, please modify .\configure.bat in order to set 
-    environment valuables such as "PATH", "INCLUDE", and "LIB".
+== How to compile and install
 
-(2) Execute .\configure.bat on "ruby\wince" directory.
+(1) Execute wince\configure.bat on your build directory.
     You can specify the target platform as an argument.
-    For example, run:
-      [CPU]      [OS ver.]
-      StrongARM  HPC2000    : `configure ARM HPC2K'
-      MIPS       PocketPC   : `configure MIPS PPC'
-      SH3        PocketPC   : `configure SH3 PPC'
-      SH4        HPCPro     : `configure SH4 HPCPRO'
-      (caution: "HPCPro" is not supported yet.)
+    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) Execute `.\make.bat'.
+(3) Run `((%nmake%))'
 
-(4) Copy mswince-ruby17.dll, ruby.exe, and irb.exe to your WinCE machine.
+(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
 
@@ -49,14 +70,52 @@ in Japanese, but you can download at least.
 
 == Build examples
 
+* Build on the ruby source directory.
+
   ex.)
-    current directory:      C:\
     ruby source directory:  C:\ruby
-    target CPU:             StrongARM
-    target OS version:      PocketPC
+    build directory:        C:\ruby
+    install directory:      C:\usr\local
+
+    C:
+    cd \ruby
+    win32\configure
+    nmake
+    nmake DESTDIR=/usr/local install
 
-    cd \ruby\wince
-    .\configure ARM PPC
-    .\make.bat
+* 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
-- 
cgit