"SfR Fresh" - the SfR Freeware/Shareware Archive

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

    1 =begin
    2 
    3 = How to build ruby using Borland C++
    4 
    5 == Requirement
    6 
    7 (1) Borland C++ 5.0 or later.
    8 
    9 (2) Please set environment variable (({PATH}))
   10     to run required commands properly from the command line.
   11 
   12     Note: building ruby requires following commands.
   13      * make
   14      * bcc32
   15      * tlib
   16      * ilink32
   17 
   18 (3) If you want to build from CVS source, following commands are required.
   19      * byacc ((<URL:http://gnuwin32.sourceforge.net/packages/byacc.htm>))
   20      * sed   ((<URL:http://gnuwin32.sourceforge.net/packages/sed.htm>))
   21 
   22 (4) We strongly recommend to build ruby on C++Builder, to link following files.
   23      * usebormm.lib
   24      * memmgr.lib
   25 
   26     RTL's internal memory manager cannot handle large memory block properly,
   27     so we should use borlndmm.dll instead.
   28      10000.times { "" << "." * 529671; GC.start } # crash
   29 
   30 == How to compile and install
   31 
   32 (1) Execute bcc32\configure.bat on your build directory.
   33      ex. c:\ruby-1.6.7>bcc32\configure.bat
   34      
   35 (2) Change ((|RUBY_INSTALL_NAME|)) and ((|RUBY_SO_NAME|)) in (({Makefile}))
   36     if you want to change the name of the executable files. 
   37     And add ((|RUBYW_INSTALL_NAME|)) to change the name of the
   38     executable without console window if also you want.
   39 
   40 (3) Run `((%make%))'
   41 
   42 (4) Run `((%make test%))'
   43 
   44 (5) Run `((%make DESTDIR=<install_directory> install%))'
   45 
   46     This command will create following directories and install files onto them.
   47       * <install_directory>\bin
   48       * <install_directory>\lib
   49       * <install_directory>\lib\ruby
   50       * <install_directory>\lib\ruby\<MAJOR>.<MINOR>
   51       * <install_directory>\lib\ruby\<MAJOR>.<MINOR>\<PLATFORM>
   52       * <install_directory>\lib\ruby\site_ruby
   53       * <install_directory>\lib\ruby\site_ruby\<MAJOR>.<MINOR>
   54       * <install_directory>\lib\ruby\site_ruby\<MAJOR>.<MINOR>\<PLATFORM>
   55       * <install_directory>\man\man1
   56     If Ruby's version is `x.y.z', the ((|<MAJOR>|)) is `x' and the ((|<MINOR>|)) is `y'.
   57     The ((|<PLATFORM>|)) is usually `(({i586-bccwin32}))'.
   58 
   59 (6) Requires dynamic RTL (cc3250.dll on C++Builder5) and borlndmm.dll (If built with
   60     usebormm.lib) to use installed binary. These files are ordinary in bcc32's bin
   61     directory.
   62 
   63 == Icons
   64 
   65 Any icon files(*.ico) in the build directory, directories specified with
   66 ((|icondirs|)) make variable and (({win32})) directory under the ruby
   67 source directory will be included in DLL or executable files, according
   68 to their base names.
   69     $(RUBY_INSTALL_NAME).ico or ruby.ico   --> $(RUBY_INSTALL_NAME).exe
   70     $(RUBYW_INSTALL_NAME).ico or rubyw.ico --> $(RUBYW_INSTALL_NAME).exe
   71     the others                             --> $(RUBY_SO_NAME).dll
   72 
   73 Although no icons are distributed with the ruby source or in the official 
   74 site, you can use anything you like. For example, followings are written 
   75 in Japanese, but you can download at least.
   76 
   77 * ((<URL:http://member.nifty.ne.jp/ueivu/rubyico.html>)) or
   78   ((<zipped icons|URL:http://member.nifty.ne.jp/ueivu/Ruby_ico.zip>))
   79 * ((<URL:http://homepage1.nifty.com/a_nakata/ruby/>)) or
   80   ((<icon itself|URL:http://homepage1.nifty.com/a_nakata/ruby/RubyIcon.ico>))
   81 
   82 == Build examples
   83 
   84 * Build on the ruby source directory.
   85 
   86   ex.)
   87     ruby source directory:  C:\ruby
   88     build directory:        C:\ruby
   89     install directory:      C:\usr\local
   90 
   91     C:
   92     cd \ruby
   93     bcc32\configure
   94     make
   95     make test
   96     make DESTDIR=/usr/local install
   97 
   98 * Build on the relative directory from the ruby source directory and CPU type 
   99   i386.
  100 
  101   ex.)
  102     ruby source directory:  C:\ruby
  103     build directory:        C:\ruby\bccwin32
  104     install directory:      C:\usr\local
  105     CPU                     i386
  106     
  107     C:
  108     cd \ruby
  109     mkdir bccwin32
  110     cd bccwin32
  111     ..\bcc32\configure target i386-bccwin32
  112     make
  113     make test
  114     make DESTDIR=/usr/local install
  115 
  116 * Build on the different drive.
  117 
  118   ex.)
  119     ruby source directory:  C:\src\ruby
  120     build directory:        D:\build\ruby
  121     install directory:      C:\usr\local
  122 
  123     D:
  124     cd D:\build\ruby
  125     C:\src\ruby\bcc32\configure
  126     make
  127     make test
  128     make DESTDIR=C:/usr/local install
  129 
  130 == Bugs
  131 
  132 You can ((*NOT*)) use a path name contains any white space characters as
  133 the ruby source directory, this restriction comes from the behavior of
  134 (({!INCLUDE})) directives of (({MAKE})).
  135 ((- you may call it a bug. -))
  136 
  137 =end