Ruby C Yacc Makefile Emacs Lisp C++ Other
Latest commit bdd6b99 Feb 24, 2017 @nobu nobu Integer.sqrt [Feature #13219]
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@57705 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Permalink
Failed to load latest commit information.
basictest basictest: --run-opt option Oct 19, 2016
benchmark benchmarks for Bug#13136 Jan 20, 2017
bin * bin/erb: $SAFE=3 is obsolete. Jun 18, 2015
bootstraptest make FIXNUM_MAX visible from Ruby Jan 30, 2017
ccan ccan/list/list.h: suppress unused argument warnings Sep 6, 2015
coverage fix a typo [ci skip] Sep 12, 2014
cygwin MFLAGS for nmake Feb 10, 2017
defs fix circular dependencies Feb 23, 2017
doc Update maintainers and standard library docs for GDBM. Feb 24, 2017
enc Merge Onigmo 6.0.0 Dec 10, 2016
ext gem name should be the downcase. Feb 24, 2017
gems Update gems/bundled_gems Feb 15, 2017
include backward.h: RClassDeprecated Feb 21, 2017
lib Update rdoc-5.1.0 Feb 24, 2017
man Remove Ns before puctuation Sep 26, 2016
misc ruby-additional.el: unquoted code block Nov 16, 2016
missing get rid of sprintf Dec 26, 2016
nacl Fix PNaCl configure/link errors. Oct 22, 2014
sample pty/shl.rb: update [ci skip] Feb 5, 2017
spec default.mspec: end of options Nov 9, 2016
template parse.y: TOKEN2ID Feb 11, 2017
test Integer.sqrt [Feature #13219] Feb 24, 2017
tool add performance counting mechanism for MRI debug/tuning purpose. Feb 21, 2017
win32 win32.c: memcpy instead of strlcpy Feb 16, 2017
.document * .document: [DOC] add rbconfig. [ci skip] Sep 14, 2016
.editorconfig Add config for *.yml [ci skip] Oct 30, 2016
.gdbinit .gdbinit: fix on empty strings [ci skip] Jan 25, 2017
.gitattributes add .gitattributes Nov 19, 2015
.gitignore .gitignore: add ext/rbconfig/sizeof/limits.c Feb 3, 2017
.indent.pro * .indent.pro: added for ruby-style. Mar 11, 2010
.travis.yml Add ruby_2_4 branch to test on travis [skip ci] Dec 23, 2016
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: expand tabs Feb 18, 2017
COPYING.ja Change encoding from EUC-JP to UTF-8. [Feature #5128] Sep 4, 2011
GPL * GPL: update text of GPLv2. [ruby-core:44488] [Bug #6328] Jun 3, 2012
KNOWNBUGS.rb add a ticket number. Jan 30, 2017
LEGAL Use https instead of http in some URLs Sep 11, 2016
Makefile.in MFLAGS for nmake Feb 10, 2017
NEWS Thread#fetch Feb 22, 2017
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: Drop support for BeOS now that Haiku is stable since… Sep 13, 2016
README.md Describe about RUBY_CODESIGN Jan 31, 2017
acinclude.m4 acinclude.m4: rename Jan 3, 2016
aclocal.m4 aclocal.m4: add Jan 3, 2016
addr2line.c get rid of strcpy Dec 26, 2016
addr2line.h * addr2line.c (fill_lines): loop reverse order not to overwrite Mar 26, 2014
appveyor.yml appveyor.yaml: matrix Feb 23, 2017
array.c array.c: check if numeric Feb 18, 2017
bignum.c Integer.sqrt [Feature #13219] Feb 24, 2017
class.c class.c: non-keyword hash class Jan 18, 2017
common.mk add performance counting mechanism for MRI debug/tuning purpose. Feb 21, 2017
compar.c Comparable#clamp Aug 11, 2016
compile.c compile.c: Fix a typo Feb 20, 2017
complex.c complex.c: remove deprecated functions Feb 21, 2017
configure.in fix typo and argument of r57506 Feb 2, 2017
constant.h use id_table for constant tables Dec 29, 2015
cont.c cont.c: avoid needless branch for dmark callbacks Feb 13, 2017
debug.c * debug.c (ruby_debug_printf): use rb_raw_obj_info() Jul 25, 2016
debug_counter.c add performance counting mechanism for MRI debug/tuning purpose. Feb 21, 2017
debug_counter.h add performance counting mechanism for MRI debug/tuning purpose. Feb 21, 2017
dir.c dir.c: getattrlist on OSX 10.5 Jan 1, 2017
dln.c get rid of strcpy Dec 26, 2016
dln.h dln.c: extra arguments Jun 30, 2013
dln_find.c dln_find.c: MAXPATHLEN is not used already Jun 2, 2016
dmydln.c * configure.in: add -Wsuggest-attribute=noreturn and suppress warnings. May 8, 2016
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 encoding.c: handle needmore error from rb_enc_precise_mbclen() Dec 14, 2016
enum.c [DOC] Update an obsolete example for slice_before. Feb 9, 2017
enumerator.c Enumerator::Lazy#chunk_while defined. Nov 5, 2016
error.c error.c: remove deprecated internal features Feb 21, 2017
eval.c eval.c: hide internal objects Feb 3, 2017
eval_error.c eval_error.c: backstrace in reverse order Feb 22, 2017
eval_intern.h eval_intern.h: make TH_PUSH_TAG() initialize rb_vm_tag::tag with Qundef Sep 26, 2016
eval_jump.c eval_jump.c: restore previous error info Apr 22, 2016
file.c file.c: refine message Jan 16, 2017
gc.c get rid of strcpy Dec 26, 2016
gc.h * gc.h, gc.c: introduce new debug function rb_obj_info_dump(VALUE obj) Oct 6, 2015
gem_prelude.rb Reduce system calls by activating the `did_you_mean` gem. Feb 25, 2016
golf_prelude.rb * golf_prelude.rb: syntax formatting for whitespace [Fixes GH-425] Nov 7, 2013
goruby.c goruby.c: call Init_golf [ci skip] Aug 23, 2016
hash.c backward.h: 2.2 deprecated features Feb 21, 2017
ia64.s * removed trailing spaces. Jun 9, 2012
id_table.c swithc id_table data structure. Jan 25, 2017
id_table.h id_table.h: dummy sentinel Aug 6, 2016
inits.c * random.c (InitVM_Random): move Random::DEFAULT initialization Nov 30, 2015
insns.def Use carry flag to reduce instructions Feb 2, 2017
internal.h eval_error.c: backstrace in reverse order Feb 22, 2017
io.c eval_error.c: backstrace in reverse order Feb 22, 2017
iseq.c immediate message mode of compile error Jan 12, 2017
iseq.h * iseq.h (struct iseq_compile_data): use struct rb_id_table May 14, 2016
lex.c.blt parse.y: symbol literals for alias/undef Mar 16, 2016
load.c Adjust indent [ci skip] Dec 9, 2016
loadpath.c * loadpath.c (RUBY_REVISION): Defined to suppress revision.h Jun 17, 2013
localeinit.c * remove trailing spaces. Jun 19, 2016
main.c * include/ruby/debug.h: introdudced. Nov 20, 2012
marshal.c marshal.c: revert r57631 partially Feb 15, 2017
math.c math.c: unused_obj Nov 19, 2016
method.h * eval.c, method.h, proc.c, vm.c, vm_eval.c, vm_insnhelper.c, vm_meth… Nov 5, 2016
miniinit.c miniinit.c: built-in encoding aliases Dec 26, 2015
node.c remove warning about enum and int comparison. Feb 8, 2017
node.h * compile.c: fix typos. Dec 14, 2015
numeric.c Integer.sqrt [Feature #13219] Feb 24, 2017
object.c numeric.c: Numeric#clone and #dup Feb 22, 2017
pack.c backward.h: 2.2 deprecated features Feb 21, 2017
parse.y Cast as VALUE to suppress type warnings Feb 20, 2017
prelude.rb Revert r57690 except for read_nonblock Feb 23, 2017
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 use rb_iseq_check() for USE_LAZY_LOAD. Feb 16, 2017
process.c process.c: PATH env in spawn Nov 6, 2016
random.c SecureRandom should try /dev/urandom first [Bug #9569] Jan 20, 2017
range.c range.c: check loading Nov 11, 2016
rational.c rational.c: infinity in power Feb 22, 2017
re.c refine warning message for binary regexp /.../n. Feb 22, 2017
regcomp.c Merge Onigmo 6.1.1 Feb 11, 2017
regenc.c Merge Onigmo 6.1.1 Feb 11, 2017
regenc.h Merge Onigmo 6.0.0 Dec 10, 2016
regerror.c get rid of strcat Dec 26, 2016
regexec.c Merge Onigmo 6.1.1 Feb 11, 2017
regint.h Merge Onigmo 6.1.1 Feb 11, 2017
regparse.c regparse.c: initialize return values Feb 20, 2017
regparse.h Merge Onigmo 6.1.1 Feb 11, 2017
regsyntax.c Merge Onigmo 6.0.0 Dec 10, 2016
ruby-runner.c ruby-runner.h Apr 14, 2016
ruby.c ruby.c: defining DATA Jan 31, 2017
ruby_assert.h fix build with VM_CHECK_MODE > 0 Jan 25, 2016
ruby_atomic.h Revert r52995 Dec 9, 2015
rubystub.c rubystub.c: sys/param.h for MAXPATHLEN Aug 20, 2016
safe.c * safe.c: removed needless doc related $SAFE=2 Jun 18, 2015
signal.c signal.c: improve stack overflow check Nov 27, 2016
siphash.c switch SipHash from SipHash24 to SipHash13 variant Jan 20, 2017
siphash.h switch SipHash from SipHash24 to SipHash13 variant Jan 20, 2017
sparc.c * sparc.c: Use __asm__ instead of asm for gcc. Apr 27, 2013
sprintf.c sprintf.c: avoid garbage in common (no exception) case Jan 31, 2017
st.c st.c: suppress a warning Dec 21, 2016
strftime.c strftime.c: limit result size Jun 14, 2016
string.c string.c (str_uminus): deduplicate strings Feb 24, 2017
struct.c backward.h: 2.2 deprecated features Feb 21, 2017
symbol.c symbol.c (rb_id2str): eliminate branch to set class Feb 3, 2017
symbol.h Use HAVE_BUILTIN___BUILTIN_CONSTANT_P May 20, 2016
thread.c Thread#fetch Feb 22, 2017
thread_pthread.c [DOC] replace Fixnum with Integer [ci skip] Oct 26, 2016
thread_pthread.h * thread_pthread.c (register_ubf_list): renamed from Nov 30, 2015
thread_sync.c allow Queue operation in trap. Jan 31, 2017
thread_win32.c Use PRIuSIZE format specifier for size_t values Sep 13, 2016
thread_win32.h * ext/openssl/depend: remove dependency from internal headers. May 14, 2014
time.c time.c (time_strftime): avoid garbage in common case Jan 31, 2017
timev.h configure.in, win32/Makefile.sub: PACKED_STRUCT with VC Feb 25, 2014
transcode.c * lib/net/http/header.rb: Fix typo. [ci skip][fix GH-1407] Aug 16, 2016
transcode_data.h transcode_data.h: missing cast Aug 8, 2015
util.c util.c: round to even Nov 4, 2016
variable.c add performance counting mechanism for MRI debug/tuning purpose. Feb 21, 2017
version.c version.c: no exit in ruby_show_copyright Jan 7, 2016
version.h * 2017-02-24 Feb 24, 2017
vm.c backward.h: 2.2 deprecated features Feb 21, 2017
vm_args.c vm_args.c: cache procs Oct 15, 2016
vm_backtrace.c * vm_trace.c (tracepoint_attr_callee_id, rb_tracearg_callee_id): Nov 5, 2016
vm_core.h use rb_iseq_check() for USE_LAZY_LOAD, too. Feb 16, 2017
vm_debug.h defines.h: RUBY_SYMBOL_EXPORT_{BEGIN,END} Apr 5, 2013
vm_dump.c skip T_IMEMO for VMDEBUG Jan 26, 2017
vm_eval.c vm.c: fix return in lambda Dec 31, 2016
vm_exec.c * vm_insnhelper.h: rename REG_(CFP|PC|SP|EP) to VM_REG_.... Nov 5, 2016
vm_exec.h * vm_exec.h (VM_DEBUG_STACKOVERFLOW): added. Dec 18, 2013
vm_insnhelper.c add performance counting mechanism for MRI debug/tuning purpose. Feb 21, 2017
vm_insnhelper.h insns.def: float comparison Jan 13, 2017
vm_method.c add performance counting mechanism for MRI debug/tuning purpose. Feb 21, 2017
vm_opts.h iseq.h: rename member Nov 25, 2015
vm_trace.c Add clang volatile fixes from FreeBSD and NetBSD. Dec 7, 2016
vsnprintf.c * internal.h (WARN_UNUSED_RESULT): moved to configure.in, to Sep 16, 2016

README.md

Build Status Build status

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, Haiku, etc.) cf. https://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:

https://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 https://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 https://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:

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

Mailing list

There is a mailing list to talk about Ruby. To subscribe to 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.

    • On Mac, set RUBY_CODESIGN environment variable with a signing identity. It uses the identity to sign ruby binary. See also codesign(1).
  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 the following directories and install files into 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 (https://www.ruby-lang.org/en/community/mailing-lists) or on websites like (https://stackoverflow.com).

Bug reports should be filed at https://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