Skip to content
The Ruby Programming Language
Ruby C HTML Yacc Makefile Emacs Lisp Other
Pull request Compare This branch is 1652 commits behind ruby:trunk.
Latest commit 7f71cdc Dec 23, 2015 svn * 2015-12-24
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@53267 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Failed to load latest commit information.
benchmark * benchmark/bm_app_aobench.rb: fix typos. Dec 14, 2015
bin * bin/erb: $SAFE=3 is obsolete. Jun 18, 2015
bootstraptest * bootstraptest/runner.rb: use safe navigation operator. Dec 14, 2015
ccan ccan/list/list.h: suppress unused argument warnings Sep 6, 2015
coverage fix a typo [ci skip] Sep 12, 2014
cygwin win32.c: fake lchown Aug 26, 2015
defs * compile.c (iseq_compile_each): add debug information to NODE_STR Nov 20, 2015
doc Fix typo in contributing docs [ci skip] Dec 22, 2015
enc * enc/windows_1250.c: Should not use C++ style comments (C99 feature). Dec 19, 2015
ext io/console: fix gem build failure on Windows Dec 23, 2015
gems * gems/bundled_gems: Upgrade the did_you_mean gem to 1.0.0 Dec 22, 2015
include rb_readwrite_syserr_fail Dec 23, 2015
lib [DOC] Fix typos Dec 23, 2015
man ruby.1: --dump [ci skip] Nov 15, 2015
misc parse.y: ANDDOT fluent interface Nov 12, 2015
missing explicit_bzero.c: fix typos Dec 2, 2015
nacl Fix PNaCl configure/link errors. Oct 22, 2014
sample * properties. Dec 11, 2015
spec * spec/default.mspec: use default configuration file name. Feb 25, 2015
template * lib/erb.rb: revert r53123. It break compatibility like thor and rsp… Dec 20, 2015
test Revert r53253. naruse fixed it differently in r53244 Dec 22, 2015
tool * remove trailing spaces. Dec 15, 2015
win32 Fix cross build Dec 5, 2015
.document * .document: removed needless entries. Mar 25, 2015
.editorconfig .editorconfig: new Sep 15, 2012
.gdbinit rbi Nov 10, 2015
.gitattributes add .gitattributes Nov 19, 2015
.gitignore * .gitignore: ignored ISeq binary format. Dec 9, 2015
.indent.pro * .indent.pro: added for ruby-style. Mar 11, 2010
.travis.yml * .travis.yml: retry. Sep 9, 2015
BSDL * BSDL: update copyright notice for 2013. Feb 9, 2013
CONTRIBUTING.md [DOC] Please see _the_ official issue tracker... [ci skip] Jun 13, 2014
COPYING * COPYING: change Ruby's License from a dual license with GPLv2 Sep 15, 2010
COPYING.ja Change encoding from EUC-JP to UTF-8. [Feature #5128] Sep 4, 2011
ChangeLog io/console: fix gem build failure on Windows Dec 23, 2015
GPL * GPL: update text of GPLv2. [ruby-core:44488] [Bug #6328] Jun 3, 2012
KNOWNBUGS.rb KNOWNBUGS.rb: Fixed typo, made more explicit [ci skip] Dec 13, 2015
LEGAL LEGAL: adjust style Aug 17, 2015
Makefile.in Makefile.in: remove unintentional exec Dec 20, 2015
NEWS io/console: fix gem build failure on Windows Dec 23, 2015
README.EXT README.EXT: add redirect [ruby-core:68631] Mar 25, 2015
README.EXT.ja README.EXT.ja: add redirect [ruby-core:68631] Mar 30, 2015
README.ja.md README.ja.md: fix markup miss. [ci skip] Jun 10, 2015
README.md * README.md: improve markdown rendering for readable. Sep 12, 2015
aclocal.m4 Makefile.in: tty at reconfig Oct 21, 2015
addr2line.c * addr2line.c (fill_lines): get base addrs in fill_lines to use it Apr 14, 2014
addr2line.h * addr2line.c (fill_lines): loop reverse order not to overwrite Mar 26, 2014
array.c * array.c: Improve and fix documentation for Array#dig Dec 8, 2015
bignum.c make local symbols static Dec 8, 2015
class.c gc.c: do not expose internal singleton class Dec 22, 2015
common.mk common.mk: help of exam [ci skip] Dec 12, 2015
compar.c * compar.c: Update doc for == [#7688] [ci-skip] Dec 15, 2015
compile.c * compile.c (ibf_load_object_string): use fstring if frozen string. Dec 18, 2015
complex.c preserve encodings in error messages Sep 28, 2015
configure.in configure.in: get rid of macro redefinition Dec 23, 2015
constant.h variable.c: Module#deprecate_constant Jul 30, 2015
cont.c * cont.c: fix a double word typo. Dec 10, 2015
debug.c ruby.h: add prefix Sep 13, 2015
dir.c * compile.c: fix typos. Dec 14, 2015
dln.c Drop support for BeOS Nov 24, 2015
dln.h dln.c: extra arguments Jun 30, 2013
dln_find.c * ChangeLog: Good-bye OS/2. Oct 18, 2015
dmydln.c * encoding.c (rb_enc_codepoint_len): Use UNREACHABLE to avoid "control Apr 13, 2012
dmyenc.c load.c: tweak the return value Dec 3, 2014
dmyext.c dmyenc.c: separate Nov 27, 2014
encindex.h revert r52336 (commit miss) Oct 29, 2015
encoding.c * introduce new ISeq binary format serializer/de-serializer Dec 8, 2015
enum.c * enum.c: fix a typo in documentation. Dec 14, 2015
enumerator.c enumerator.c: use ALLOCV Dec 15, 2015
error.c io.c: encoding in warnings Dec 13, 2015
eval.c * vm.c (rb_vm_cref_replace_with_duplicated_cref): added. Nov 20, 2015
eval_error.c eval_error.c: Fix a format of `NameError#message` Oct 31, 2015
eval_intern.h * vm.c (rb_vm_cref_replace_with_duplicated_cref): added. Nov 20, 2015
eval_jump.c eval.c: use the given thread Feb 24, 2015
file.c prefer rb_syserr_fail Dec 23, 2015
gc.c gc.c: do not expose internal singleton class Dec 22, 2015
gc.h * gc.h, gc.c: introduce new debug function rb_obj_info_dump(VALUE obj) Oct 6, 2015
gem_prelude.rb * ruby.c (usage, enable_option, disable_option, process_options): new Sep 9, 2015
golf_prelude.rb * golf_prelude.rb: syntax formatting for whitespace [Fixes GH-425] Nov 7, 2013
goruby.c goruby.c: suppress warning Aug 10, 2014
hash.c * gc.c: Delete excess semicolon after RUBY_ALIAS_FUNCTION(). Dec 15, 2015
ia64.s * removed trailing spaces. Jun 9, 2012
id_table.c id_table: const correctness for _size and _memsize Nov 2, 2015
id_table.h id_table: const correctness for _size and _memsize Nov 2, 2015
inits.c * random.c (InitVM_Random): move Random::DEFAULT initialization Nov 30, 2015
insns.def insns.def (opt_case_dispatch): avoid converting Infinity Dec 11, 2015
internal.h gc.c: do not expose internal singleton class Dec 22, 2015
io.c rb_readwrite_syserr_fail Dec 23, 2015
iseq.c * enum.c: fix a typo in documentation. Dec 14, 2015
iseq.h * introduce new ISeq binary format serializer/de-serializer Dec 8, 2015
lex.c.blt keywords: make name singed Nov 2, 2015
load.c * introduce new ISeq binary format serializer/de-serializer Dec 8, 2015
loadpath.c * loadpath.c (RUBY_REVISION): Defined to suppress revision.h Jun 17, 2013
localeinit.c localeinit.c: encindex.h Sep 15, 2015
main.c * include/ruby/debug.h: introdudced. Nov 20, 2012
marshal.c marshal.c: remove NULL checks for *_memsize Dec 9, 2015
math.c object.c: rb_num_to_dbl Aug 13, 2015
method.h * method.h: introduce the folliwing field and macros. Nov 18, 2015
miniinit.c encoding.c: find encoding index Aug 24, 2015
node.c node.c: NODE_QCALL Dec 5, 2015
node.h * compile.c: fix typos. Dec 14, 2015
numeric.c * enum.c: fix a typo in documentation. Dec 14, 2015
object.c * object.c (rb_inspect): check the default internal encoding as Dec 13, 2015
pack.c pack.c: check index range Dec 13, 2015
parse.y parse.y: labeled heredoc Dec 20, 2015
prelude.rb add missing options to call-seq of IO#read_nonblock Dec 7, 2015
probes.d change lingering dtrace probe documentation from function- to method- May 30, 2015
probes_helper.h vm.c: ruby_th_dtrace_setup Oct 29, 2015
proc.c * proc.c (rb_mod_define_method): should check Symbol or not. Dec 20, 2015
process.c prefer rb_syserr_fail Dec 23, 2015
random.c * *.c (*_memsize): do not check ptr. Dec 9, 2015
range.c range.c: infected by the receiver Dec 3, 2015
rational.c rational.c: preserve encoding in exception Sep 11, 2015
re.c re.c: names encoding Dec 17, 2015
regcomp.c Revert r52995 Dec 9, 2015
regenc.c * regcomp.c, regenc.c, regexec.c, regint.h, enc/unicode.c: Nov 26, 2015
regenc.h oniguruma.h: constify Aug 27, 2015
regerror.c * regcomp.c: Merge Onigmo 5.14.1 25a8a69fc05ae3b56a09. Jul 16, 2014
regexec.c regexec.c: fix build with direct threaded VM Dec 22, 2015
regint.h Revert r52995 Dec 9, 2015
regparse.c Revert r52995 Dec 9, 2015
regparse.h regparse.h: ANSI alias rule fix Dec 9, 2015
regsyntax.c * Merge Onigmo-5.13.1. [ruby-dev:45057] [Feature #5820] Feb 17, 2012
ruby.c version.c: remove ruby_engine_name Nov 29, 2015
ruby_atomic.h Revert r52995 Dec 9, 2015
safe.c * safe.c: removed needless doc related $SAFE=2 Jun 18, 2015
signal.c Drop support for BeOS Nov 24, 2015
siphash.c UNALIGNED_WORD_ACCESS on ppc64 Jul 23, 2014
siphash.h * siphash.h: check configure macros before include newer headers. Nov 9, 2012
sparc.c * sparc.c: Use __asm__ instead of asm for gcc. Apr 27, 2013
sprintf.c sprintf.c: fix garbage inserted with Rational Dec 3, 2015
st.c st.c: constify st_table* in private functions Jul 29, 2015
strftime.c * strftime.c (rb_strftime_with_timespec): Test yday range. Apr 6, 2013
string.c * string.c: Fix document. Default value of the first Dec 23, 2015
struct.c * array.c: Improve and fix documentation for Array#dig Dec 8, 2015
symbol.c symbol.c: rb_sym_intern Nov 30, 2015
symbol.h * ext/objspace/objspace.c: add a new method ObjectSpace.count_symbols. Aug 21, 2015
thread.c * *.c (*_memsize): do not check ptr. Dec 9, 2015
thread_pthread.c * compile.c: fix typos. Dec 14, 2015
thread_pthread.h * thread_pthread.c (register_ubf_list): renamed from Nov 30, 2015
thread_sync.c * *.c (*_memsize): do not check ptr. Dec 9, 2015
thread_win32.c * thread_pthread.c (register_ubf_list): renamed from Nov 30, 2015
thread_win32.h * ext/openssl/depend: remove dependency from internal headers. May 14, 2014
time.c * time.c (rb_time_timespec_new): swap utc and localtime Nov 10, 2015
timev.h configure.in, win32/Makefile.sub: PACKED_STRUCT with VC Feb 25, 2014
transcode.c transcode.c: infection Dec 17, 2015
transcode_data.h transcode_data.h: missing cast Aug 8, 2015
util.c prefer rb_syserr_fail Dec 23, 2015
variable.c * variable.c (struct ivar_update): rename "extended" to "iv_extended" Dec 21, 2015
version.c version.c: remove ruby_engine_name Nov 29, 2015
version.h * 2015-12-24 Dec 23, 2015
vm.c * vm.c (vm_exec): call RUBY_DTRACE_CMETHOD_RETURN_HOOK instead of Dec 18, 2015
vm_args.c * vm_args.c (vm_caller_setup_arg_block): remove code for ifunc Dec 17, 2015
vm_backtrace.c vm_backtrace.c: ignore ifunc frames Dec 21, 2015
vm_core.h * vm_core.h: define USE_LAZY_LOAD if it is not defined. Dec 18, 2015
vm_debug.h defines.h: RUBY_SYMBOL_EXPORT_{BEGIN,END} Apr 5, 2013
vm_dump.c * vm_dump.c (rb_print_backtrace): our addr2line doesn't work on sparc. Oct 27, 2015
vm_eval.c vm_eval.c: hook after method_missing Dec 12, 2015
vm_exec.c * vm_core.h: constify rb_iseq_constant_body::iseq_encoded and Jul 23, 2015
vm_exec.h * vm_exec.h (VM_DEBUG_STACKOVERFLOW): added. Dec 18, 2013
vm_insnhelper.c * vm_insnhelper.c: move vm_callee_setup_block_arg() (and related Dec 22, 2015
vm_insnhelper.h * refactoring CREF related code. Nov 13, 2015
vm_method.c * vm_method.c (rb_method_entry_make, check_override_opt_method): Dec 18, 2015
vm_opts.h iseq.h: rename member Nov 25, 2015
vm_trace.c * enum.c: fix a typo in documentation. Dec 14, 2015
vsnprintf.c * compile.c: fix typos. Dec 14, 2015

README.md

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 (e.g. class, method calls)
  • Advanced Object-oriented Features (e.g. Mix-in, Singleton-method)
  • Operator Overloading
  • Exception Handling
  • Iterators and Closures
  • Garbage Collection
  • Dynamic Loading of Object Files (on some architectures)
  • Highly Portable (works on many Unix-like/POSIX compatible platforms as well as Windows, Mac OS X, BeOS, etc.) cf. http://bugs.ruby-lang.org/projects/ruby-trunk/wiki/SupportedPlatforms

How to get Ruby

For a complete list of ways to install Ruby, including using third-party tools like rvm, see:

http://www.ruby-lang.org/en/downloads/

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

ftp://ftp.ruby-lang.org/pub/ruby/

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

$ svn co http://svn.ruby-lang.org/repos/ruby/trunk/ ruby

Or if you are using git then use the following command:

$ git clone git://github.com/ruby/ruby.git

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

$ svn ls http://svn.ruby-lang.org/repos/ruby/branches/

Or if you are using git then use the following command:

$ git ls-remote git://github.com/ruby/ruby.git

Ruby home page

The URL of the Ruby home page is:

http://www.ruby-lang.org/

Mailing list

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

subscribe

in the mail body (not subject) to the address ruby-talk-request@ruby-lang.org.

How to compile and install

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

  1. If you want to use Microsoft Visual C++ to compile ruby, read win32/README.win32 instead of this document.

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

  3. 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.

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

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

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

    Usually this step will not be needed.

  6. Run make.

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

  8. 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.

Some extension libraries may not get compiled because of lack of necessary external libraries and/or headers, then you will need to run 'make distclean-ext' to remove old configuration after installing them in such case.

Copying

See the file COPYING.

Feedback

Questions about the Ruby language can be asked on the Ruby-Talk mailing list (http://www.ruby-lang.org/en/community/mailing-lists) or on websites like (http://stackoverflow.com).

Bug reports should be filed at http://bugs.ruby-lang.org. Read HowToReport for more information.

Contributing

See the file CONTRIBUTING.md

The Author

Ruby was originally designed and developed by Yukihiro Matsumoto (Matz) in 1995.

matz@ruby-lang.org

Something went wrong with that request. Please try again.