"SfR Fresh" - the SfR Freeware/Shareware Archive

Member "ruby-1.8.7-p72/win32/README.win32" of archive ruby-1.8.7-p72.tar.gz:

    1 =begin
    2 
    3 = How to build ruby using Visual C++
    4 
    5 == Requirement
    6 
    7 (1) Visual C++ 5.0 or later.
    8 
    9 (2) If you want to run `((%nmake clean%))' or `((%nmake distclean%))'
   10     properly, you must install UNIX compatible `((%rm%))' command on
   11     your ((|PATH|)) if you want to clean after compile.
   12 
   13 (3) Please set environment variable (({INCLUDE})), (({LIB})), (({PATH}))
   14     to run required commands properly from the command line.
   15 
   16     Note: building ruby requires following commands.
   17      * nmake
   18      * cl
   19      * lib
   20      * dumpbin
   21 
   22 == How to compile and install
   23 
   24 (1) Execute win32\configure.bat on your build directory.
   25     You can specify the target platform as an argument.
   26     For example, run `((%configure i686-mswin32%))'
   27 
   28 (2) Change ((|RUBY_INSTALL_NAME|)) and ((|RUBY_SO_NAME|)) in (({Makefile}))
   29     if you want to change the name of the executable files. 
   30     And add ((|RUBYW_INSTALL_NAME|)) to change the name of the
   31     executable without console window if also you want.
   32 
   33 (3) Run `((%nmake%))'
   34 
   35 (4) If you want to make rubyw.exe, run `((%nmake rubyw.exe%))'
   36 
   37 (5) Run `((%nmake test%))'
   38 
   39 (6) Run `((%nmake DESTDIR=<install_directory> install%))'
   40 
   41     This command will create following directories and install files onto them.
   42       * <install_directory>\bin
   43       * <install_directory>\lib
   44       * <install_directory>\lib\ruby
   45       * <install_directory>\lib\ruby\<MAJOR>.<MINOR>
   46       * <install_directory>\lib\ruby\<MAJOR>.<MINOR>\<PLATFORM>
   47       * <install_directory>\lib\ruby\site_ruby
   48       * <install_directory>\lib\ruby\site_ruby\<MAJOR>.<MINOR>
   49       * <install_directory>\lib\ruby\site_ruby\<MAJOR>.<MINOR>\<PLATFORM>
   50       * <install_directory>\man\man1
   51     If Ruby's version is `x.y.z', the ((|<MAJOR>|)) is `x' and the ((|<MINOR>|)) is `y'.
   52     The default ((|<PLATFORM>|)) is `(({i386-mswin32}))'.
   53 
   54 == Icons
   55 
   56 Any icon files(*.ico) in the build directory, directories specified with
   57 ((|icondirs|)) make variable and (({win32})) directory under the ruby
   58 source directory will be included in DLL or executable files, according
   59 to their base names.
   60     $(RUBY_INSTALL_NAME).ico or ruby.ico   --> $(RUBY_INSTALL_NAME).exe
   61     $(RUBYW_INSTALL_NAME).ico or rubyw.ico --> $(RUBYW_INSTALL_NAME).exe
   62     the others                             --> $(RUBY_SO_NAME).dll
   63 
   64 Although no icons are distributed with the ruby source or in the official 
   65 site, you can use anything you like. For example, followings are written 
   66 in Japanese, but you can download at least.
   67 
   68 * ((<URL:http://member.nifty.ne.jp/ueivu/rubyico.html>)) or
   69   ((<zipped icons|URL:http://member.nifty.ne.jp/ueivu/Ruby_ico.zip>))
   70 * ((<URL:http://homepage1.nifty.com/a_nakata/ruby/>)) or
   71   ((<icon itself|URL:http://homepage1.nifty.com/a_nakata/ruby/RubyIcon.ico>))
   72 
   73 == Build examples
   74 
   75 * Build on the ruby source directory.
   76 
   77   ex.)
   78     ruby source directory:  C:\ruby
   79     build directory:        C:\ruby
   80     install directory:      C:\usr\local
   81 
   82     C:
   83     cd \ruby
   84     win32\configure
   85     nmake
   86     nmake test
   87     nmake DESTDIR=/usr/local install
   88 
   89 * Build on the relative directory from the ruby source directory.
   90 
   91   ex.)
   92     ruby source directory:  C:\ruby
   93     build directory:        C:\ruby\mswin32
   94     install directory:      C:\usr\local
   95 
   96     C:
   97     cd \ruby
   98     mkdir mswin32
   99     cd mswin32
  100     ..\win32\configure
  101     nmake
  102     nmake test
  103     nmake DESTDIR=/usr/local install
  104 
  105 * Build on the different drive.
  106 
  107   ex.)
  108     ruby source directory:  C:\src\ruby
  109     build directory:        D:\build\ruby
  110     install directory:      C:\usr\local
  111 
  112     D:
  113     cd D:\build\ruby
  114     C:\src\ruby\win32\configure
  115     nmake
  116     nmake test
  117     nmake DESTDIR=C:/usr/local install
  118 
  119 == Bugs
  120 
  121 You can ((*NOT*)) use a path name contains any white space characters as
  122 the ruby source directory, this restriction comes from the behavior of
  123 (({!INCLUDE})) directives of (({NMAKE})).
  124 ((- you may call it a bug. -))
  125 
  126 =end