Skip to content
The Ruby Programming Language
Ruby C HTML Yacc Makefile Emacs Lisp Other
Find file
Pull request Compare This branch is 962 commits ahead, 18699 commits behind trunk.
Latest commit 23ccbdf @unak unak merge revision(s) 48402:
	* lib/rexml/document.rb: add REXML::Document#document.
	  reported by Tomas Hoger <> and patched by nahi.

git-svn-id: svn+ssh:// b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Failed to load latest commit information.
bcc32 * read API version from include/ruby/version.h.
benchmark merge revision(s) 44772,44773: [Backport #9430]
bin * lib/rdoc: Update to 3.9.1. Fixes === lines in verbatim sections.
bootstraptest [Backport #7624]
cygwin * cygwin/ (SCRIPTPROGRAMS): ignore backup files and etc.
defs * defs/default_gems: separate from tool/rbinstall.rb.
doc * doc/re.rdoc (Repetition): fix typo. reported by Ori Avtalion
enc * (POSTLINK): sign built program using RUBY_CODESIGN
ext merge revision(s) 45274,45278,45280,48097: [Backport #9424]
include merge revision(s) 43398,43407,43408,43417: [Backport #9044]
lib merge revision(s) 48402:
man fix typos in man
misc merge revision(s) 34355:
missing merge revision(s) 36151: [Backport #7746]
sample * backport r33086 from trunk.
spec * spec/README: update the description.
symbian Added HAVE_LABS and HAVE_LLABS to config.h
template merge revision(s) 40525,40526,40528,40530: [Backport #8345]
test merge revision(s) 48402:
tool * (POSTLINK): sign built program using RUBY_CODESIGN
win32 merge revision(s) 43398,43407,43408,43417: [Backport #9044]
.document * prelude.rb, .document: Stuff in prelude.rb should be documented
.gdbinit * .gdbinit (rp): show type name for RTypedData.
.gitignore remove duplicated and change comment location * added for ruby-style.
.travis.yml * .travis.yml: Backport TravisCI configuration from trunk.
BSDL Add BSDL file.
COPYING * COPYING: change Ruby's License from a dual license with GPLv2
COPYING.ja * COPYING: change Ruby's License from a dual license with GPLv2
ChangeLog merge revision(s) 48402:
GPL * It is confusing to put the GPL license terms in the file COPYING;
KNOWNBUGS.rb [Backport #7624]
LEGAL merge revision(s) 32826,34732: [Backport #6681] * (POSTLINK): sign built program using RUBY_CODESIGN
NEWS * NEWS: cosmetic changes.
README * README: update.
README.EXT * README.EXT: fix typo. Patch by William Blackerby.
README.EXT.ja * README.EXT: fix typo. Patch by William Blackerby.
README.ja * README: update.
ToDo * error.c (Init_Exception): remove Exception#to_str. [Ruby2]
addr2line.c * addr2line.c: use USE_ELF instead of __ELF__ because Solaris
addr2line.h * addr2line.c: use USE_ELF instead of __ELF__ because Solaris
array.c merge revision(s) 42040,42041,42047,42068,42069: [Backport #8654]
bignum.c merge revision(s) 36763,36764: [Backport #8528]
class.c merge revision(s) 45076: [Backport #9535] * need to quote $BASERUBY because it may includes options.
compar.c merge revision(s) 43208: [Backport #9003]
compile.c merge revision(s) 38739: [Backport #7671]
complex.c merge revision(s) 34803: * (ARCH_FLAG): __sync_val_compare_and_swap_4 needs
constant.h * constant.h, variable.c: to ensure compatibility, rb_const_get_* must
cont.c merge revision(s) 34629,34630:
debug.c * debug.c: parenthesize macro arguments.
debug.h * debug.h: parenthesize macro arguments.
dir.c merge revision(s) 36905: [Backport #6977]
dln.c merge revision(s) 35354,35356,35357,35361:
dln.h * (XCFLAGS): use -fvisibility=hidden if possible.
dln_find.c * dln_find.c (dln_find_1): use rb_warning and return immediately
dmydln.c * dln_find.c: split from dln.c.
dmyencoding.c * encoding.c (enc_init_db): moved to enc/encdb.c.
dmyext.c * array.c: moved to ANSI function style from K&R function style.
dmyversion.c * dmyversion.c: empty load path in miniruby.
encoding.c merge revision(s) 34433: [Backport #6153]
enum.c merge revision(s) 32595:
enumerator.c * enumerator.c: include internal.h instead of declaring the external
error.c merge revision(s) 37068:
eval.c merge revision(s) 44628: [Backport #9413]
eval_error.c * internal.h: declare more internal functions.
eval_intern.h * fix for build on solaris 10.
eval_jump.c merge revision(s) 43685,43690,43705: [Backport #9110]
file.c * include/ruby/intern.h (rb_path_next, rb_path_skip_prefix,
gc.c merge revision(s) 43994,44000: [Backport #9205]
gc.h merge revision(s) 38134,38136: [Backport #7468]
gem_prelude.rb * ruby.c (process_options): revert r30549.
golf_prelude.rb cancel subversion backfire. sorry
goruby.c stripped trailing spaces.
hash.c merge revision(s) 43942,43957,43975: [Backport #9187]
ia64.s add reference.
id.c merge revision(s) 40525,40526,40528,40530: [Backport #8345]
inits.c * internal.h: declare internal functions here.
insns.def merge revision(s) 32688,33309,33408,33864,35874,38012: [Backport #7832]
internal.h merge revision(s) 39594,39596: [Backport #8010]
io.c merge revision(s) 44790: [Backport #9472]
iseq.c merge revision(s) 44568: [Backport #9399]
iseq.h merge revision(s) 38739: [Backport #7671]
lex.c.blt * defs/keywords (reserved_word): made inline function static.
load.c merge revision(s) 34849,34853,34854,34855,34859,34862,35384,35385,368…
main.c * main.c: <stdlib.h> is needed, to introduce the getenv(3)
marshal.c merge revision(s) 38357,38363: [Backport #7325]
math.c * complex.c (f_signbit): fix compile error in gcc4 on Solaris with
method.h reverted Module#mix -- r31873, r31917 and r31918.
node.c * node.c (add_id): remove duplicated rb_id2str() call.
node.h merge revision(s) 39722,43929: [Backport #9178]
numeric.c merge revision(s) 39594,39596: [Backport #8010]
object.c * object.c (rb_obj_clone): protect FL_MARK of a dest object. A lazy
pack.c merge revision(s) 34972:
parse.y merge revision(s) 44449: [Backport #9308]
prelude.rb * remove trailing spaces.
proc.c merge revision(s) 41342,41359,41361: [Backport #8341]
process.c fixed merge mistake at r44766.
random.c merge revision(s) 39772,39773,39774,39775,39777,39779,39781,39783: [B…
range.c * range.c (range_max): fix behavior with excluded end value.
rational.c merge revision(s) 42178: [Backport #8687]
re.c * internal.h: declare internal functions here.
regcomp.c * regcomp.c (optimize_node_left, set_optimize_info_from_tree): right
regenc.c merge revision(s) 34236: [Backport #5890]
regenc.h * (XCFLAGS): use -fvisibility=hidden if possible.
regerror.c * removed spaces just before tabs.
regexec.c * regexec.c (onig_search): fix problem with optimization of \z.
regint.h merge revision(s) 32544: [Backport #6005]
regparse.c merge revision(s) 32688,33309,33408,33864,35874,38012: [Backport #7832]
regparse.h * addr2line.c: suppressed shorten-64-to-32 warnings.
regsyntax.c stripped trailing spaces.
ruby.c merge revision(s) 36800: [Backport #6377]
ruby_atomic.h * ruby_atomic.h: fixed merge mistake of r44946. reported by ngoto at
safe.c fixed very important banners.
signal.c * ruby_atomic.h (ATOMIC_CAS): added.
siphash.c merge revision(s) 37585,37587,37591,37592,37597,37599:
siphash.h merge revision(s) 37585,37587,37591,37592,37597,37599:
sparc.c sparc.c was missing in r34199
sprintf.c * backport r33021 from trunk.
st.c [Backport #8328] [ruby-core:55250] Patch by funny-falcon
strftime.c merge revision(s) 35366,35377,35399,35406:
string.c merge revision(s) 44803: [Backport #9485]
struct.c * internal.h: add for internal use only.
thread.c merge revision(s) 43148,43149,43152: [Backport #8433]
thread_pthread.c merge revision(s) 44670,44671,44675: [Backport #8783]
thread_pthread.h * thread_pthread.h (rb_global_vm_lock_struct): add volatile to
thread_win32.c * include/ruby/intern.h, thread_pthread.c (rb_reserved_fd_p,
thread_win32.h fix win32 native_cond_timedwait() makes SIGSEGV.
time.c merge revision(s) 39766,39769: [Backport #8101]
timev.h * timev.h (TIME_SCALE): defined as 1000000000.
transcode.c merge revision(s) 35112,35121: [Backport #6190]
transcode_data.h * (XCFLAGS): use -fvisibility=hidden if possible.
util.c merge revision(s) 44195: [Backport #7772]
variable.c merge revision(s) 35010:
version.c * math.c: Attach documentation for Math.
version.h merge revision(s) 48402:
vm.c merge revision(s) 39276: [Backport #7825]
vm_core.h merge revision(s) 38739: [Backport #7671]
vm_dump.c * addr2line.c: use USE_ELF instead of __ELF__ because Solaris
vm_eval.c merge revision(s) 41343,41360,41386: [Backport #8531]
vm_exec.c * vm_exec.c: remove conditions for clang
vm_exec.h merge revision(s) 37661: [Backport #7633]
vm_insnhelper.c merge revision(s) 32688,33309,33408,33864,35874,38012: [Backport #7832]
vm_insnhelper.h * vm_core.h, vm_insnhelper.h: move decl. of
vm_method.c merge revision(s) 32688,33309,33408,33864,35874,38012: [Backport #7832]
vm_opts.h * vm_opts.h: enable "OPT_TRACE_INSTRUCTION" on default.
vsnprintf.c merge revision(s) 42908,42918: [Backport #8864]


* What's Ruby

Ruby is the interpreted scripting language for quick and
easy object-oriented programming.  It has many features to
process text files and to do system management tasks (as in
Perl).  It is simple, straight-forward, and extensible.

* Features of Ruby

  + Simple Syntax
  + *Normal* Object-Oriented features(ex. class, method calls)
  + *Advanced* Object-Oriented features(ex. Mix-in, Singleton-method)
  + Operator Overloading
  + Exception Handling
  + Iterators and Closures
  + Garbage Collection
  + Dynamic Loading of Object files(on some architecture)
  + Highly Portable (works on many Unix-like/POSIX compatible platforms
    as well as Windows, Mac OS X, BeOS etc.)

* How to get Ruby

The Ruby distribution files can be found in the following FTP site:

The trunk of the Ruby source tree can be checked out with the
following command:

  $ svn co ruby

There are some other branches under development.  Try the following
command and see the list of branches:

  $ svn ls

* Ruby home-page

The URL of the Ruby home-page is:

* Mailing list

There is a mailing list to talk about Ruby.
To subscribe this list, please send the following phrase

	subscribe YourFirstName YourFamilyName
        subscribe Joseph Smith

in the mail body (not subject) to the address <>.

* How to compile and install

This is what you need to do to compile and install Ruby:

  1. If ./configure does not exist or is older than,
     run autoconf to (re)generate configure.

  2. Run ./configure, which will generate config.h and Makefile.

     Some C compiler flags may be added by default depending on your
     environment.  Specify optflags=.. and warnflags=.. as necessary
     to override them.

  3. Edit defines.h if you need.  Usually this step will not be needed.

  4. Remove comment mark(#) before the module names from ext/Setup (or
     add module names if not present), if you want to link modules

     If you don't want to compile non static extension modules
     (probably on architectures which does not allow dynamic loading),
     remove comment mark from the line "#option nodynamic" in

  5. Run make.

  6. Optionally, run 'make test' to check whether the compiled Ruby
     interpreter works well.  If you see the message "test succeeded",
     your ruby works as it should (hopefully).

  7. Run 'make install'

     This command will create following directories and install files
     onto them.

       * ${DESTDIR}${prefix}/bin
       * ${DESTDIR}${prefix}/include/ruby-${MAJOR}.${MINOR}.${TEENY}
       * ${DESTDIR}${prefix}/include/ruby-${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}
       * ${DESTDIR}${prefix}/lib
       * ${DESTDIR}${prefix}/lib/ruby
       * ${DESTDIR}${prefix}/lib/ruby/${MAJOR}.${MINOR}.${TEENY}
       * ${DESTDIR}${prefix}/lib/ruby/${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}
       * ${DESTDIR}${prefix}/lib/ruby/site_ruby
       * ${DESTDIR}${prefix}/lib/ruby/site_ruby/${MAJOR}.${MINOR}.${TEENY}
       * ${DESTDIR}${prefix}/lib/ruby/site_ruby/${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}
       * ${DESTDIR}${prefix}/lib/ruby/vendor_ruby
       * ${DESTDIR}${prefix}/lib/ruby/vendor_ruby/${MAJOR}.${MINOR}.${TEENY}
       * ${DESTDIR}${prefix}/lib/ruby/vendor_ruby/${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}
       * ${DESTDIR}${prefix}/lib/ruby/gems/${MAJOR}.${MINOR}.${TEENY}
       * ${DESTDIR}${prefix}/share/man/man1
       * ${DESTDIR}${prefix}/share/ri/${MAJOR}.${MINOR}.${TEENY}/system

     If Ruby's API version is `x.y.z', the ((|${MAJOR}|)) is `x', the
     ((|${MINOR}|)) is `y', and the ((|${TEENY}|)) is `z'.

     NOTE: teeny of the API version may be different from one of
     Ruby's program version

     You may have to be a super user to install ruby.

If you fail to compile ruby, please send the detailed error report with
the error log and machine/OS type, to help others.

* Copying

See the file COPYING.

* The Author

Feel free to send comments and bug reports to the author.  Here is the 
author's latest mail address:

created at: Thu Aug  3 11:57:36 JST 1995
Local variables:
mode: indented-text
Something went wrong with that request. Please try again.