Ruby C Objective-C Yacc Makefile M4 Other
Clone or download
matzbot * 2018-07-17
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@63981 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Latest commit e75fbfd Jul 16, 2018
Permalink
Failed to load latest commit information.
basictest basictest: --run-opt option Oct 19, 2016
benchmark benchmark/README.md: skip showing --timeout option [ci skip] Jul 11, 2018
bin erb.rb: deprecate safe_level of ERB.new Feb 22, 2018
bootstraptest Fix a bug of peephole optimization Jul 6, 2018
ccan ccan/list: sync with upstream Feb 1, 2018
coverage fix a typo [ci skip] Sep 12, 2014
cygwin MFLAGS for nmake Feb 10, 2017
defs gmake.mk: update in the source directory properly Jun 2, 2018
doc Promote irb library to default gems. Jul 9, 2018
enc ruby tool/update-deps --fix Jul 5, 2018
ext Fixup r63864 Jul 6, 2018
gems gems/bundled_gems: update to power_assert 1.1.2 Jun 10, 2018
include Improve branch misses Jul 12, 2018
lib webrick/httpresponse: set_redirect requires a valid URI Jul 14, 2018
man man/ruby.1: [DOC] fix grammar Apr 14, 2018
misc misc/ruby-style.el: use spaces for indentation Mar 17, 2018
missing [ci skip] tabify Jan 20, 2018
sample sample/timeout.rb: Remove unnecessary increment [ci skip] Mar 22, 2018
spec spec/ruby/security/cve_2018_6914_spec.rb: get rid of leftover files Jul 11, 2018
template fake.rb.in: duplicated RUBYOPT Jul 3, 2018
test No one knows how many leap seconds in year 2100 Jul 16, 2018
tool tool/downloader.rb: Jul 16, 2018
win32 common.mk: codesign ruby-runner too Jul 9, 2018
.document [DOC] Add win32/README.win32 to .document Apr 12, 2018
.editorconfig .editorconfig: Use spaces instead of tab except Makefiles Jan 25, 2018
.gdbinit .gdbinit: expand RBASIC macro for old gdb on mac Jun 14, 2018
.gitattributes rename ruby-runner as bin/ruby Sep 15, 2017
.gitignore benchmark: introduce benchmark_driver.gem Jul 8, 2018
.indent.pro * .indent.pro: added for ruby-style. Mar 11, 2010
.travis.yml .travis.yml: resurrect notification to #commits Feb 11, 2018
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 compile.c: fix positions encode Apr 5, 2018
LEGAL Update url with 404 status on LEGAL file. Feb 21, 2018
Makefile.in benchmark: introduce benchmark_driver.gem Jul 8, 2018
NEWS NEWS: add NEWS entry about Kernel#then [Feature #14594] Jul 1, 2018
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 [DOC] Use https: instead of git: [ci skip] Jul 3, 2018
README.md Update obsoleted URLs of supported platforms [ci skip] Jun 15, 2018
aclocal.m4 aclocal.m4: remove ruby_check_va_copy.m4 Feb 18, 2018
addr2line.c addr2line.c (kprintf): static Jul 9, 2018
addr2line.h * addr2line.c (fill_lines): loop reverse order not to overwrite Mar 26, 2014
appveyor.yml appveyor.yml: refactor r62402 Feb 14, 2018
array.c Make block spacing consistent Jul 11, 2018
ast.c ast.c: Fix defs Jun 28, 2018
bignum.c refine Integer#** and Float#** Jun 17, 2018
class.c mjit_compile.c: merge initial JIT compiler Feb 4, 2018
common.mk exe/ruby: link libm for fiddle test Jul 12, 2018
compar.c Comparable#clamp Aug 11, 2016
compile.c Remove redundant code in the compiler. Jul 9, 2018
complex.c share Float 0 Jun 17, 2018
configure.ac unrevert r63852 but keep SIGCHLD path disabled for win32 Jul 5, 2018
constant.h vm_insnhelper.c: rb_autoloading_value flag Feb 13, 2018
cont.c adjust indent [ci skip] Jul 3, 2018
debug.c internal.h: remove dependecy on ruby/io.h Jan 9, 2018
debug_counter.c debug_counter.c: debug_counter_names [ci skip] Mar 10, 2017
debug_counter.h debug_counter.h: include __FILE__ to recurse Feb 9, 2018
dir.c dir.c: fix directory glob Jul 9, 2018
dln.c constified Jan 9, 2018
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 encoding.c: rb_enc_find_index2 Dec 22, 2017
encoding.c check enc_capable. Jun 28, 2018
enum.c enum.c: bignum counter Jun 2, 2018
enumerator.c enumerator.c: pretty kwags Mar 15, 2018
error.c [DOC] Update doc of NameError.new [ci skip] Jul 16, 2018
eval.c rb_vm_insn_addr2insn: use st to perform addr2insn mapping Jun 6, 2018
eval_error.c eval_error.c: fix loop on exception in message Apr 11, 2018
eval_intern.h eval_intern.h: duplicate check Jan 18, 2018
eval_jump.c `$SAFE` as a process global state. [Feature #14250] Dec 28, 2017
file.c file.c: chardev is loadable Apr 13, 2018
gc.c give up insn attr handles_frame Jun 27, 2018
gc.h remove rb_threadptr_during_gc(). Oct 29, 2017
gem_prelude.rb Reduce system calls by activating the `did_you_mean` gem. Feb 25, 2016
golf_prelude.rb added `f` for 1 byte FizzBuzz because Hexagony has such feature May 21, 2018
goruby.c goruby.c: FD leak [ci skip] Mar 9, 2017
hash.c [DOC] Add call signature for {Array,Hash}#any? Jun 23, 2018
ia64.s * removed trailing spaces. Jun 9, 2012
id_table.c adjust styles [ci skip] May 10, 2017
id_table.h id_table.h: dummy sentinel Aug 6, 2016
inits.c Define AST module under RubyVM [experimental] May 31, 2018
insns.def insns.def: fix typo in comment Jul 15, 2018
internal.h signal.c: preserve trap(:CHLD, "IGNORE") behavior with SIGCHLD Jul 8, 2018
io.c io.c: fix compilation when IOV_MAX is not defined Jun 5, 2018
iseq.c mjit.c: disable calling JIT-ed code Jun 23, 2018
iseq.h Make VM_INSN_INFO_TABLE_IMPL=1 work Jun 13, 2018
lex.c.blt keywords: shrink struct kwtable Jan 21, 2018
load.c load.c: use ruby_sized_xfree for calloc-ed RArray VALUE May 21, 2018
loadpath.c -Wno-overlength-strings Jan 16, 2018
localeinit.c internal.h: remove dependecy on ruby/encoding.h Jan 9, 2018
main.c main.c: RUBY_DEBUG_ENV in devel Jun 30, 2017
marshal.c check enc_capable. Jun 28, 2018
math.c math.c: adjust cbrt Jun 6, 2018
method.h Add TracePoint#parameters Jun 3, 2018
miniinit.c miniinit.c: built-in encoding aliases Dec 26, 2015
mjit.c mjit: get rid of memory leak in pause+resume loop Jul 8, 2018
mjit.h mjit.h: avoid signed pointer comparisons (fix for 32-bit) Jul 3, 2018
mjit_compile.c revert r62655 for r63763 Jul 5, 2018
node.c Use nd_X shorthand for annotation Jun 28, 2018
node.h node.h: remove unused macro nd_compile_option Jul 15, 2018
numeric.c refine Integer#** and Float#** Jun 17, 2018
object.c Don't copy FL_USER* on Kernel#clone. [Bug #14847] Jul 9, 2018
pack.c pack/unpack M only handles LF line breaks [Feature #14352] Apr 19, 2018
parse.y parse.y (heredoc_identifier): Update comment for term_len Jul 16, 2018
prelude.rb prelude.rb: eliminate a private constant Jan 7, 2018
probes.d change lingering dtrace probe documentation from function- to method- May 30, 2015
probes_helper.h vm.c: disable dtrace in jit source Feb 20, 2018
proc.c Add TracePoint#parameters Jun 3, 2018
process.c process.c: adjust indent [ci skip] Jul 15, 2018
random.c prefer clock_gettime Jun 14, 2018
range.c range.c: [DOC] small improvement Jul 8, 2018
rational.c Add `exception:` keyword in Kernel#Rational() Mar 15, 2018
re.c re.c: do not escape terminator in Regexp.union Mar 16, 2018
regcomp.c Fix typos. Jan 18, 2018
regenc.c Merge Onigmo 6.1.1 Feb 11, 2017
regenc.h initializer paren-string `{("str")}` is a C99ism Jan 2, 2018
regerror.c get rid of strcat Dec 26, 2016
regexec.c label as lvalue is a GCCism Jan 2, 2018
regint.h Merge Onigmo 6.1.1 Feb 11, 2017
regparse.c Fix typos. Jan 18, 2018
regparse.h Fix typos. Jan 18, 2018
regsyntax.c Merge Onigmo 6.0.0 Dec 10, 2016
ruby-runner.c removed unusecd constants Jul 12, 2018
ruby.c ruby.c: disable DidYouMean as gem Jul 16, 2018
ruby_assert.h string literal longer than 509 characters is a C99ism Jan 2, 2018
ruby_atomic.h statement experssion is a GCCism Jan 2, 2018
rubystub.c rubystub.c: sys/param.h for MAXPATHLEN Aug 20, 2016
safe.c `$SAFE` as a process global state. [Feature #14250] Dec 28, 2017
signal.c signal.c: preserve trap(:CHLD, "IGNORE") behavior with SIGCHLD Jul 8, 2018
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 configure.ac Sep 29, 2017
sprintf.c sprintf.c: fix typo Apr 22, 2018
st.c st.c: remove redundant export declaration May 27, 2018
strftime.c adjust styles [ci skip] May 10, 2017
string.c move function declarations from insns.def to internal.h Jun 27, 2018
struct.c marshal.c: allow marshalling keyword_init struct Jan 5, 2018
symbol.c symbol.c: dsymbol initial encoding Jun 28, 2018
symbol.h symbol.h: remove stale symbol deleted at r47913 Apr 6, 2018
thread.c mjit: get rid of memory leak in pause+resume loop Jul 8, 2018
thread_pthread.c timer_thread: do not close pipes around fork Jul 12, 2018
thread_pthread.h thread*: all condvars are monotonic Apr 22, 2018
thread_sync.c thread_sync.c (rb_mutex_lock): fix deadlock Jun 22, 2018
thread_win32.c mjit: get rid of memory leak in pause+resume loop Jul 8, 2018
thread_win32.h * ext/openssl/depend: remove dependency from internal headers. May 14, 2014
time.c Prefixed reset_leap_second_info Jul 6, 2018
timev.h timev.h: just use "unsigned int" for bitfields Jan 16, 2018
transcode.c [DOC] missing docs at toplevel Feb 23, 2018
transcode_data.h transcode_data.h: missing cast Aug 8, 2015
util.c define NO_LONG_LONG appropriately Jan 4, 2018
variable.c Fix documentation in Object#remove_instance_variable Jul 14, 2018
version.c version.h: get rid of duplication Feb 24, 2018
version.h * 2018-07-17 Jul 16, 2018
vm.c const_missing on private constants Jul 6, 2018
vm_args.c vm_args.c: refined warning splat to var May 31, 2018
vm_backtrace.c Revert "Fix use of `rb_profile_frames` start parameter" Apr 27, 2018
vm_core.h vm_core.h, vm_dump.c: fix cast Jul 15, 2018
vm_debug.h defines.h: RUBY_SYMBOL_EXPORT_{BEGIN,END} Apr 5, 2013
vm_dump.c vm_core.h, vm_dump.c: fix cast Jul 15, 2018
vm_eval.c vm_eval.c: eval_string_protect wrapper May 8, 2018
vm_exec.c vm_exec.c: reduced repeated same calls Mar 4, 2018
vm_exec.h mjit_compile.c: use local variables for stack Mar 4, 2018
vm_insnhelper.c give up insn attr handles_frame Jun 27, 2018
vm_insnhelper.h remove assertion for hidden objects. Jun 27, 2018
vm_method.c Fix setting method visibility on method wrapped with prepend Mar 12, 2018
vm_opts.h Remove "trace_instruction" compile option. Dec 24, 2017
vm_trace.c mjit.c: disable calling JIT-ed code Jun 23, 2018
vsnprintf.c unused member May 23, 2017

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, macOS, Haiku, etc.) cf. https://github.com/ruby/ruby/blob/trunk/doc/contributing.rdoc#platform-maintainers

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 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 https://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.ac, 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. Optionally, run make update-gems and make extract-gems.

    If you want to install bundled gems, run make update-gems and make extract-gems before running make install.

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