Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
JRuby's fork of Ruby, to maintain diffs against stdlib and extension libraries.
Ruby C Emacs Lisp Tcl Ragel in Ruby Host Shell Other
branch: trunk

This branch is 11667 commits behind ruby:trunk

file.c: poisoned NUL

* file.c (rb_get_path_check): path name must not contain NUL bytes.


git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@37163 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
latest commit 7085db45e4
@nobu nobu authored
Failed to load latest commit information.
bcc32 * configure.in: read API version from include/ruby/version.h.
benchmark * include/ruby/ruby.h: introduce flonum technique for
bin * lib/rdoc: Update to RDoc 3.9. Fixed `ri []`, stopdoc creating an
bootstraptest * bootstraptest/test_block.rb: add tests for block with super.
cygwin * cygwin/GNUmakefile.in (SCRIPTPROGRAMS): ignore backup files and etc.
defs * tool/rbinstall.rb (gem): install all gemspecs under lib and ext.
doc * doc/re.rdoc: Fix spelling
enc encoding.c: unicode_p
ext * ext/zlib/zlib.c (zstream_run_func): don't call inflate() when
include random.c: rb_random_ulong_limited
lib mkmf.rb: use configured libdir value
man * README.ja: Update redmine.ruby-lang.org to bugs.ruby-lang.org
misc ruby-additional.el
missing setproctitle.c: _NSGetEnviron
nacl * nacl/GNUmakefile.in (.rbconfig.time): r36828 was incomplete.
sample remove trailing spaces
spec * spec/default.mspec: expand relative path for ruby_exe which uses
symbian Added HAVE_LABS and HAVE_LLABS to config.h
template encoding.c: unicode_p
test file.c: poisoned NUL
tool * tool/merger.rb: now can merge revision(s) without --ticket again.
win32 * gc.c: Use the non-recursive marking instead of recursion. The
.document * prelude.rb, .document: Stuff in prelude.rb should be documented
.editorconfig .editorconfig: new
.gdbinit .gdbinit: FLONUM support
.gitignore ignore timestamp file
.indent.pro * .indent.pro: added for ruby-style.
.travis.yml .travis.yml: revert.
BSDL Add BSDL file.
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 file.c: poisoned NUL
GPL * GPL: update text of GPLv2. [ruby-core:44488] [Bug #6328]
KNOWNBUGS.rb * KNOWNBUGS.rb: add tests. [ruby-dev:45656] [Bug #6460]
LEGAL * util.c, include/ruby/util.h (ruby_add_suffix): remove the function.
Makefile.in common.mk: gdb-ruby
NEWS array.c: use rb_random_ulong_limited
README single quotes
README.EXT * README.EXT, README.EXT.ja: use "sval" for the third argument
README.EXT.ja * README.EXT.ja: fixed args, same as r35977. [Bug #6597]
README.ja inilne markups
addr2line.c * addr2line.c: SIZE_MAX is defined in stdint.h, so r36755 breaks
addr2line.h * addr2line.c: use USE_ELF instead of __ELF__ because Solaris
array.c array.c: use rb_random_ulong_limited
atomic.h atomic.h: prefer GCC atomic builtins
bignum.c bignum.c: keep first zero
class.c internal.h: allocator function in rb_classext_t
common.mk common.mk: gdb-ruby
compar.c * array.c: Documentation: change => in call-seq to ->.
compile.c * vm_core.h (rb_call_info_t): add new type `rb_call_inf_t'.
complex.c * complex.c: Fix examples of r36993.
configure.in * gc.c: Use the non-recursive marking instead of recursion. The
constant.h * variable.c (rb_const_set): show the previous definition
cont.c * vm_core.h: remove rb_control_frame_t::bp (bp: base pointer).
debug.c * gc.c: use Bitmap Marking algorithm to avoid copy-on-write of
debug.h * debug.h: parenthesize macro arguments.
dir.c dir.c: fix recursion
dln.c * dln.c: Simplify and make consistent an ifdef for Mac OS X.
dln.h * configure.in (XCFLAGS): use -fvisibility=hidden if possible.
dln_find.c * gc.c (rb_objspace_free): global_List is allocated with xmalloc.
dmydln.c * encoding.c (rb_enc_codepoint_len): Use UNREACHABLE to avoid "control
dmyencoding.c * encoding.c (enc_init_db): moved to enc/encdb.c.
dmyext.c no K&R style
dmyversion.c * dmyversion.c: empty load path in miniruby.
encoding.c reapply r37098
enum.c enum.c: id_call
enumerator.c obj_init_copy
error.c * error.c (exc_to_s, name_err_to_s, name_err_mesg_to_str): do not
eval.c * eval.c (rb_mod_refinements): new method Module#refinements.
eval_error.c * vm_method.c (rb_method_defined_by): removed.
eval_intern.h * vm_core.h: remove lfp (local frame pointer) and rename
eval_jump.c volatile errinfo
file.c file.c: poisoned NUL
gc.c * eval.c, gc.c, iseq.c, node.h, vm_insnhelper.c, vm_insnhelper.h,
gc.h * ext/objspace/objspace.c: add ObjectSpace#reachable_objects_from.
gem_prelude.rb * ruby.c (process_options): revert r30549.
golf_prelude.rb cancel subversion backfire. sorry
goruby.c * goruby.c: windows support.
hash.c hash.c: raise on invalid input
ia64.s * removed trailing spaces.
id.c * insns.def: add new instruction `opt_empty_p' for optimize `empty?'
inits.c * vm_trace.c: separate trace_func related functions from
insns.def * vm_core.h (rb_call_info_t): add new type `rb_call_inf_t'.
internal.h process.c: uid gid exec options
io.c io.c: improved IO#reopen
iseq.c Suppress warning: 'iseqval' may be used uninitialized in this function
iseq.h Feature #7035
lex.c.blt * defs/keywords (reserved_word): made inline function static.
load.c Improve require/File.expand_path performance on Windows
main.c * include/ruby/ruby.h: Removed RUBY_GLOBAL_SETUP complely. It is
marshal.c * include/ruby/ruby.h: introduce flonum technique for
math.c * complex.c: use "__sun" instead of "__sun__" to detect SunOS.
method.h * eval.c, gc.c, iseq.c, node.h, vm_insnhelper.c, vm_insnhelper.h,
node.c * compile.c (iseq_set_arguments): keyword rest arg without keyword args.
node.h * eval.c, gc.c, iseq.c, node.h, vm_insnhelper.c, vm_insnhelper.h,
numeric.c * include/ruby/ruby.h: introduce flonum technique for
object.c internal.h: allocator function in rb_classext_t
pack.c * pack.c: fix typo.
parse.y parse.y: suppress warnings
prelude.rb * remove trailing spaces.
proc.c * vm_trace.c: support TracePoint. [ruby-trunk - Feature #6895]
process.c process.c: uid gid exec options
random.c random.c: rb_random_ulong_limited
range.c trivial changes
rational.c complex.c, rational.c: compatible marshal loader
re.c * re.c (rb_reg_initialize_m): Forgot to update output for or'd-options
regcomp.c Remove unused variables.
regenc.c * Merge Onigmo-5.13.1. [ruby-dev:45057] [Feature #5820]
regenc.h * Merge Onigmo-5.13.1. [ruby-dev:45057] [Feature #5820]
regerror.c * regcomp.c: Merge Onigmo 3d855b30d574536d3ae600260208c6624ae4791c.
regexec.c * regcomp.c: Merge Onigmo 3d855b30d574536d3ae600260208c6624ae4791c.
regint.h * regint.h (BITS_IN_ROOM, BS_ROOM, BS_BIT): suppress warnings.
regparse.c warning: no indirect flag
regparse.h * Merge Onigmo-5.13.1. [ruby-dev:45057] [Feature #5820]
regsyntax.c * Merge Onigmo-5.13.1. [ruby-dev:45057] [Feature #5820]
ruby.c configure.in: use configured libdir value
safe.c * use RB_TYPE_P which is optimized for constant types, instead of
signal.c * signal.c (rb_f_kill):
sparc.c adjust style.
sprintf.c sprintf.c: infect
st.c * st.c (st_foreach_check, st_foreach): remove ancient check. This
strftime.c unecessary macros and K&R style coding
string.c string.c: GC guard
struct.c obj_init_copy
thread.c * thread.c (rb_thread_aref):
thread_pthread.c thread_pthread.c: precise stack size
thread_pthread.h * thread_pthread.h: no Structured Exception Handling like macros.
thread_win32.c thread_win32.h: rb_thread_lock_t for USE_WIN32_MUTEX
thread_win32.h thread_win32.h: rb_thread_lock_t for USE_WIN32_MUTEX
time.c * time.c (time_sec): Remove extra wording about leap seconds and refer
timev.h * timev.h (TIME_SCALE): defined as 1000000000.
transcode.c update doc.
transcode_data.h Supports static linking of extensions and encodings again.
util.c Imports Ruby's port to NativeClient (a.k.a NaCl).
variable.c remove trailing spaces.
version.c * eval.c: Add doxygen comments.
version.h * 2012-10-12
vm.c * vm.c (vm_analysis_insn|operand|register): use st_insert
vm_backtrace.c internal.h: allocator function in rb_classext_t
vm_core.h * vm_core.h (rb_call_info_t): add new type `rb_call_inf_t'.
vm_dump.c * vm_dump.c: fix debug prints to catch up recent changes
vm_eval.c * eval.c, gc.c, iseq.c, node.h, vm_insnhelper.c, vm_insnhelper.h,
vm_exec.c * vm_exec.c, insns.def (leave): solve problems on
vm_exec.h * insns.def (getlocal, setlocal): remove old getlocal/setlocal
vm_insnhelper.c * vm_core.h (rb_call_info_t): add new type `rb_call_inf_t'.
vm_insnhelper.h * vm_core.h (rb_call_info_t): add new type `rb_call_inf_t'.
vm_method.c * eval.c, gc.c, iseq.c, node.h, vm_insnhelper.c, vm_insnhelper.h,
vm_opts.h * vm_opts.h (OPT_GLOBAL_METHOD_CACHE): new build option to
vm_trace.c internal.h: allocator function in rb_classext_t
vsnprintf.c unecessary macros and K&R style coding

README

= 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.)
    cf. http://bugs.ruby-lang.org/projects/ruby-trunk/wiki/SupportedPlatforms


== How to get Ruby

The Ruby distribution files can be found in 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 following command:

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

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

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

Or if you are using git then use 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 YourFirstName YourFamilyName
e.g.
        subscribe Joseph Smith

in the mail body (not subject) to the address <mailto:ruby-talk-ctl@ruby-lang.org>.


== 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 configure.in,
     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 <tt>optflags=..</tt> and <tt>warnflags=..</tt> as
     necessary to override them.

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

4.   Remove comment mark(<tt>#</tt>) 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 does not allow dynamic loading),
     remove comment mark from the line "<tt>#option nodynamic</tt>" in
     +ext/Setup+.

5.   Run +make+.

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

7.   Run '<tt>make install</tt>'

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

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

     If Ruby's API version is '_x.y.z_', the <tt>${MAJOR}</tt> is '_x_', the
     <tt>${MINOR}</tt> is '_y_', and the <tt>${TEENY}</tt> 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:

<mailto:matz@ruby-lang.org>

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