home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / ruby164.zip / rbemx164.zip / ruby / share / doc / ruby-1.6.4 / README < prev    next >
Text File  |  2001-06-18  |  5KB  |  156 lines
  1. * What's Ruby
  2.  
  3. Ruby is the interpreted scripting language for quick and
  4. easy object-oriented programming.  It has many features to
  5. process text files and to do system management tasks (as in
  6. Perl).  It is simple, straight-forward, and extensible.
  7.  
  8. * Features of Ruby
  9.  
  10.   + Simple Syntax
  11.   + *Normal* Object-Oriented features(ex. class, method calls)
  12.   + *Advanced* Object-Oriented features(ex. Mix-in, Singleton-method)
  13.   + Operator Overloading
  14.   + Exception Handling
  15.   + Iterators and Closures
  16.   + Garbage Collection
  17.   + Dynamic Loading of Object files(on some architecture)
  18.   + Highly Portable(works on many UNIX machines, and on DOS,
  19.     Windows, Mac, BeOS etc.)
  20.  
  21. * How to get Ruby
  22.  
  23. The Ruby distribution can be found on:
  24.  
  25.   ftp://ftp.netlab.co.jp/pub/lang/ruby/
  26.  
  27. You can get it by anonymous CVS.  How to check out is:
  28.  
  29.   $ cvs -d :pserver:anonymous@cvs.ruby-lang.org:/src login
  30.   (Logging in to anonymous@cvs.ruby-lang.org)
  31.   CVS password: anonymous
  32.   $ cvs -z4 -d :pserver:anonymous@cvs.ruby-lang.org:/src checkout ruby
  33.  
  34. * Mailing list
  35.  
  36. There is a mailing list to talk about Ruby.
  37. To subscribe this list, please send the following phrase
  38.  
  39.     subscribe YourFirstName YourFamilyName
  40. e.g.
  41.         subscribe Joseph Smith
  42.  
  43. in the mail body (not subject) to the address <ruby-talk-ctl@ruby-lang.org>.
  44.  
  45. * How to compile and install
  46.  
  47. This is what you need to do to compile and install Ruby:
  48.  
  49.   1. If ./configure does not exist or is older than configure.in,
  50.      run autoconf to (re)generate configure.
  51.  
  52.   2. Run ./configure, which will generate config.h and Makefile.
  53.  
  54.   3. Edit defines.h if you need.  Probably this step will not need.
  55.  
  56.   4. Remove comment mark(#) before the module names from ext/Setup (or
  57.      add module names if not present), if you want to link modules
  58.      statically.
  59.  
  60.      If you don't want to compile non static extension modules
  61.      (probably on architectures which does not allow dynamic loading),
  62.      remove comment mark from the line "#option nodynamic" in
  63.      ext/Setup.
  64.  
  65.   5. Run make.
  66.  
  67.   6. Optionally, run 'make test' to check whether the compiled Ruby
  68.      interpreter works well.  If you see the message "test succeeded",
  69.      your ruby works as it should (hopefully).
  70.  
  71.   7. Run 'make install'
  72.  
  73.      You may have to be a super user to install ruby.
  74.  
  75. If you fail to compile ruby, please send the detailed error report with
  76. the error log and machine/OS type, to help others.
  77.  
  78. * Copying
  79.  
  80. Ruby is copyrighted free software by Yukihiro Matsumoto <matz@zetabits.com>.
  81. You can redistribute it and/or modify it under either the terms of the GPL
  82. (see COPYING file), or the conditions below:
  83.  
  84.   1. You may make and give away verbatim copies of the source form of the
  85.      software without restriction, provided that you duplicate all of the
  86.      original copyright notices and associated disclaimers.
  87.  
  88.   2. You may modify your copy of the software in any way, provided that
  89.      you do at least ONE of the following:
  90.  
  91.        a) place your modifications in the Public Domain or otherwise
  92.           make them Freely Available, such as by posting said
  93.       modifications to Usenet or an equivalent medium, or by allowing
  94.       the author to include your modifications in the software.
  95.  
  96.        b) use the modified software only within your corporation or
  97.           organization.
  98.  
  99.        c) rename any non-standard executables so the names do not conflict
  100.       with standard executables, which must also be provided.
  101.  
  102.        d) make other distribution arrangements with the author.
  103.  
  104.   3. You may distribute the software in object code or executable
  105.      form, provided that you do at least ONE of the following:
  106.  
  107.        a) distribute the executables and library files of the software,
  108.       together with instructions (in the manual page or equivalent)
  109.       on where to get the original distribution.
  110.  
  111.        b) accompany the distribution with the machine-readable source of
  112.       the software.
  113.  
  114.        c) give non-standard executables non-standard names, with
  115.           instructions on where to get the original software distribution.
  116.  
  117.        d) make other distribution arrangements with the author.
  118.  
  119.   4. You may modify and include the part of the software into any other
  120.      software (possibly commercial).  But some files in the distribution
  121.      are not written by the author, so that they are not under this terms.
  122.  
  123.      They are gc.c(partly), utils.c(partly), regex.[ch], st.[ch] and some
  124.      files under the ./missing directory.  See each file for the copying
  125.      condition.
  126.  
  127.   5. The scripts and library files supplied as input to or produced as 
  128.      output from the software do not automatically fall under the
  129.      copyright of the software, but belong to whomever generated them, 
  130.      and may be sold commercially, and may be aggregated with this
  131.      software.
  132.  
  133.   6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
  134.      IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  135.      WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  136.      PURPOSE.
  137.  
  138. * Ruby home-page
  139.  
  140. The URL of the Ruby home-page is:
  141.  
  142.    http://www.ruby-lang.org/
  143.  
  144. * The Author
  145.  
  146. Feel free to send comments and bug reports to the author.  Here is the 
  147. author's latest mail address:
  148.  
  149.   matz@zetabits.com
  150.  
  151. -------------------------------------------------------
  152. created at: Thu Aug  3 11:57:36 JST 1995
  153. Local variables:
  154. mode: indented-text
  155. end:
  156.