Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
The Ruby Programming Language
Ruby C HTML Yacc Makefile Emacs Lisp Other

* 2015-08-31

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@51729 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
latest commit 16e86cdfd7
svn authored
Failed to load latest commit information.
benchmark new benchmarks for hashing dsyms and fixnums
bin * bin/erb: $SAFE=3 is obsolete.
bootstraptest * bootstraptest/test_method.rb: remove a test because $SAFE=2 was
ccan ccan/list/list.h: sync with ccan upstream
coverage fix a typo [ci skip]
cygwin win32.c: fake lchown
defs Makefile.in: PIC lex.c
doc contributing.rdoc: double quotes [ci skip]
enc unicode.c: no st.h
ext * ext/openssl/ossl_ssl.c (static const struct): Only add SSLv3 support
gems * gems/bundled_gems: update latest version of bundled gems.
include oniguruma.h: constify
lib * lib/rdoc/*: Update rdoc master(cfffed5)
man man: updated
misc Import ruby-electric.el version 2.2.3 from upstream
missing missing/setproctitle.c: Avoid invalidating argv[1], argv[2], etc. unt…
nacl Fix PNaCl configure/link errors.
sample * sample/exyacc.rb: Fix some typos.
spec * spec/default.mspec: use default configuration file name.
template common.mk: fix conflict of version.i
test * class.c (move_refined_method): should insert a write barrier
tool compressed mantypes
win32 win32.c: suppress warnings
.document * .document: removed needless entries.
.editorconfig .editorconfig: new
.gdbinit refix r51329 and show thread information
.gitignore common.mk: fix conflict of version.i
.indent.pro * .indent.pro: added for ruby-style.
.travis.yml Revert "try to run travis without sudo to run in container"
BSDL * BSDL: update copyright notice for 2013.
CONTRIBUTING.md [DOC] Please see _the_ official issue tracker... [ci skip]
COPYING * COPYING: change Ruby's License from a dual license with GPLv2
COPYING.ja Change encoding from EUC-JP to UTF-8. [Feature #5128]
ChangeLog * class.c (move_refined_method): should insert a write barrier
GPL * GPL: update text of GPLv2. [ruby-core:44488] [Bug #6328]
KNOWNBUGS.rb * test/ruby/test_method.rb (test_unlinked_method_entry_in_method_obje…
LEGAL LEGAL: adjust style
Makefile.in Makefile.in: PIC lex.c
NEWS * ext/objspace/objspace.c: add a new method ObjectSpace.count_symbols.
README.EXT README.EXT: add redirect [ruby-core:68631]
README.EXT.ja README.EXT.ja: add redirect [ruby-core:68631]
README.ja.md README.ja.md: fix markup miss. [ci skip]
README.md * README.md: fix a typo pointed out by raoulvdberge. [ci skip] [DOC]
addr2line.c * addr2line.c (fill_lines): get base addrs in fill_lines to use it
addr2line.h * addr2line.c (fill_lines): loop reverse order not to overwrite
array.c array.c: fix buffer size
bignum.c internal.h: roomof
class.c * class.c (move_refined_method): should insert a write barrier
common.mk win32.c: rb_w32_reparse
compar.c compar.c: variable name [ci skip]
compile.c * compile.c (iseq_set_sequence): rename variable names
complex.c ruby/missing.h: M_PI fallback definition
configure.in win32.c: fake lchown
constant.h variable.c: Module#deprecate_constant
cont.c * include/ruby/ruby.h, cont.c, vm_trace.c: add a new event
debug.c * debug.c (ruby_debug_print_id): use rb_id2name() for fprintf().
dir.c win32.c: support known reparse points only
dln.c dln.c: fix EXTERNAL_PREFIX
dln.h dln.c: extra arguments
dln_find.c dln_find.c: define S_ISREG
dmydln.c * encoding.c (rb_enc_codepoint_len): Use UNREACHABLE to avoid "control
dmyenc.c load.c: tweak the return value
dmyext.c dmyenc.c: separate
encoding.c encoding.c: fix document [ci skip]
enum.c * enum.c: added doc for Enumerable#zip
enumerator.c * internal.h: use T_IMEMO to represent `struct MEMO' value.
error.c error.c: remove singleton method
eval.c improve handling of timer thread shutdown
eval_error.c eval.c: check tag value
eval_intern.h compile.c: use ruby_tag_type
eval_jump.c eval.c: use the given thread
file.c file.c: syserr_fail2_in
gc.c * gc.c (gc_mark_children): check if RCLASS_EXT is valid
gc.h gc.h: evaluate the macro argument only once
gem_prelude.rb * ruby.c (process_options): revert r30549.
golf_prelude.rb * golf_prelude.rb: syntax formatting for whitespace [Fixes GH-425]
goruby.c goruby.c: suppress warning
hash.c hash.c: improve integer/fixnum hashing
ia64.s * removed trailing spaces.
id_table.c id_table.c: aliases
id_table.h id_table.h: callback function types
inits.c * internal.h: Include ruby.h and ruby/encoding.h to be
insns.def insns.def: redundant call
internal.h object.c: rb_num_to_dbl
io.c io.c: initialize variable
iseq.c * vm_opts.h, iseq.c, iseq.h: add compile option to force frozen
iseq.h * vm_opts.h, iseq.c, iseq.h: add compile option to force frozen
lex.c.blt Makefile.in: PIC lex.c
load.c load.c (features_index_add): avoid repeat calculation
loadpath.c * loadpath.c (RUBY_REVISION): Defined to suppress revision.h
localeinit.c encoding.c: find encoding index
main.c * include/ruby/debug.h: introdudced.
marshal.c * id_table.h: introduce ID key table.
math.c object.c: rb_num_to_dbl
method.h vm_method.c: reuse method entry
miniinit.c encoding.c: find encoding index
node.c gc.c: move tmp buffer functions
node.h rb_parser_compile_*: remove volatile arg
numeric.c * numeric.c (Init_Numeric): Fix document for Float::MIN and
object.c object.c: rb_num_to_dbl
pack.c * pack.c (pack_{un,}pack): new template character `j` and `J`, pointer
parse.y parse.y: fix labelarg
prelude.rb * prelude.rb: [DOC] Update Thread::exclusive docs by @stevenharman.
probes.d change lingering dtrace probe documentation from function- to method-
probes_helper.h probes_helper.h (RUBY_DTRACE_HOOK): correct type for _id
proc.c vm_method.c: reuse method entry
process.c process.c: [DOC] env values in spawn [ci skip]
random.c random.c: get rid of blocking
range.c range.c: call range_include directly if possible
rational.c * remove trailing spaces.
re.c re.c: fix wchar match at EOS
regcomp.c * reg*.c: Merge Onigmo 5.15.0 38a870960aa7370051a3544
regenc.c oniguruma.h: constify
regenc.h oniguruma.h: constify
regerror.c * regcomp.c: Merge Onigmo 5.14.1 25a8a69fc05ae3b56a09.
regexec.c uninitialized variable
regint.h * Avoid undefined behaviors found by gcc -fsanitize=undefined.
regparse.c regparse.c: remove unused variable
regparse.h * reg*.c: Merge Onigmo 5.15.0 38a870960aa7370051a3544
regsyntax.c * Merge Onigmo-5.13.1. [ruby-dev:45057] [Feature #5820]
ruby.c * make rb_iseq_t T_IMEMO object (type is imemo_iseq).
ruby_atomic.h ruby_atomic.h: atomic VALUE operations
safe.c * safe.c: removed needless doc related $SAFE=2
signal.c revert r31760 and r31761
siphash.c UNALIGNED_WORD_ACCESS on ppc64
siphash.h * siphash.h: check configure macros before include newer headers.
sparc.c * sparc.c: Use __asm__ instead of asm for gcc.
sprintf.c sprintf.c: rb_inspect returns a string
st.c st.c: constify st_table* in private functions
strftime.c * strftime.c (rb_strftime_with_timespec): Test yday range.
string.c string.c: move common statement
struct.c * make rb_iseq_t T_IMEMO object (type is imemo_iseq).
symbol.c symbol.c: suppress warnings
symbol.h * ext/objspace/objspace.c: add a new method ObjectSpace.count_symbols.
thread.c * ext/thread/thread.c: move definitions of Queue, SizedQueue
thread_pthread.c * thread_pthread.c (reserve_stack): ensure the memory is really
thread_pthread.h thread_pthread: prefer rb_nativethread* types/functions
thread_tools.c * remove trailing spaces.
thread_win32.c improve handling of timer thread shutdown
thread_win32.h * ext/openssl/depend: remove dependency from internal headers.
time.c * time.c (time_getlocaltime): [DOC] Add examples of valid utc_offset
timev.h configure.in, win32/Makefile.sub: PACKED_STRUCT with VC
transcode.c transcode.c: GC guards
transcode_data.h transcode_data.h: missing cast
util.c util.c: fix off-by-one error
variable.c variable.c: wrap long lines
version.c fake.rb.in: scan version.c
version.h * 2015-08-31
vm.c * vm.c (hook_before_rewind): prevent kicking :return event while
vm_args.c * vm_core.h: size should be unsigned.
vm_backtrace.c * make rb_iseq_t T_IMEMO object (type is imemo_iseq).
vm_core.h improve handling of timer thread shutdown
vm_debug.h defines.h: RUBY_SYMBOL_EXPORT_{BEGIN,END}
vm_dump.c * make rb_iseq_t T_IMEMO object (type is imemo_iseq).
vm_eval.c vm_eval.c: cache results
vm_exec.c * vm_core.h: constify rb_iseq_constant_body::iseq_encoded and
vm_exec.h * vm_exec.h (VM_DEBUG_STACKOVERFLOW): added.
vm_insnhelper.c vm_insnhelper.c: use update argc
vm_insnhelper.h * method.h: split rb_method_definition_t::flag to several flags.
vm_method.c vm_eval.c: cache results
vm_opts.h * vm_opts.h, iseq.c, iseq.h: add compile option to force frozen
vm_trace.c * include/ruby/ruby.h, cont.c, vm_trace.c: add a new event
vsnprintf.c sprintf.c: ruby specific functions

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.