The Ruby Programming Language [mirror]
Go to file
matz b2c25d56c5 * enum.c (take_i): small cosmetic / documentation patch from
Tadashi Saito <shiba AT mail2.accsnet.ne.jp>. [ruby-dev:30446]

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@11927 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
2007-02-27 19:04:52 +00:00
bcc32 * Makefile.in, */Makefile.sub, common.mk (vmasm): generalized. 2007-02-02 18:23:07 +00:00
benchmark set svn:eol-style 2007-02-12 23:01:19 +00:00
bin * bin/rdoc: ues File.exist? instead of File.exists. 2006-12-08 08:01:06 +00:00
bootstraptest * bootstraptest/runner.rb: show source code in error message. 2007-02-25 02:10:38 +00:00
cygwin
djgpp * djgpp/config.status: wrongly revised file. 2007-01-13 13:24:35 +00:00
doc set svn:eol-style 2007-02-12 23:01:19 +00:00
ext * ext/nkf/nkf.c (rb_str_resize, rb_nkf_kconv, rb_nkf_guess1, 2007-02-27 10:35:17 +00:00
lib * lib/base64.rb (Base64::b64encode): Fix documentation; submitted 2007-02-27 10:16:59 +00:00
misc * misc/ruby-mode.el (ruby-font-lock-syntactic-keywords): fix 2007-01-24 09:09:51 +00:00
missing
sample * compile.c (iseq_compile_each, set_block_local_tbl) : 2007-01-05 03:43:12 +00:00
template * *.def, proc.c, vm_opts.h.base, template/*: set properties. 2007-02-02 15:21:41 +00:00
test * test/{dbm,gdbm}/test_{dbm,gdbm}.rb: shouldn't use host_os. use 2007-02-27 16:22:10 +00:00
tool * compile.c, insns.def: remove (get|set)instancevariable2 and add a 2007-02-06 05:22:17 +00:00
vms
win32 * win32/Makefile.sub: enable -Zi (debug) option. 2007-02-25 02:48:19 +00:00
wince * Makefile.in, */Makefile.sub, common.mk (vmasm): generalized. 2007-02-02 18:23:07 +00:00
x68
yarvtest * yarvtest/test_method.rb: removed (merged to bootstraptest). 2007-02-24 09:56:02 +00:00
.cvsignore * .cvsignore: ignore timestamp files and installed list file. 2006-09-21 17:06:50 +00:00
.document
COPYING
COPYING.ja
ChangeLog * enum.c (take_i): small cosmetic / documentation patch from 2007-02-27 19:04:52 +00:00
GPL
LEGAL
LGPL
Makefile.in * Makefile.in, */Makefile.sub, common.mk (vmasm): generalized. 2007-02-02 18:23:07 +00:00
README Update the distribution information. 2007-02-20 07:34:30 +00:00
README.EXT * README.EXT: should mention new macros: RSTRING_PTR, RSTRING_LEN, 2006-09-16 10:51:35 +00:00
README.EXT.ja * README.EXT: should mention new macros: RSTRING_PTR, RSTRING_LEN, 2006-09-16 10:51:35 +00:00
README.ja fix 2007-02-20 07:35:33 +00:00
ToDo
array.c * this commit is a result of refactoring. only renaming functions, 2007-02-07 01:25:05 +00:00
ascii.c
bignum.c * bignum.c (rb_big2str0): use better approximation. 2006-10-30 10:31:01 +00:00
blockinlining.c * yarvcore.h, vm.h: rename th_invoke_yield() to th_yield(). 2007-02-26 22:51:33 +00:00
call_cfunc.ci * call_cfunc.ci, compile.c, compile.h, debug.h, eval.c, 2007-02-02 16:26:04 +00:00
class.c * Merge YARV 2006-12-31 15:02:22 +00:00
common.mk * mkconfig.rb (RbConfig): add CONFIG['PATCHLEVEL'] 2007-02-27 15:12:18 +00:00
compar.c
compile.c * yarvcore.h: 2007-02-25 01:34:33 +00:00
compile.h * yarvcore.h: 2007-02-25 01:34:33 +00:00
config.guess
config.sub
configure.in * configure.in (--enable-auto-image-base): avoid the neccessity to 2007-02-27 13:28:48 +00:00
debug.c * this commit is a result of refactoring. only renaming functions, 2007-02-07 01:25:05 +00:00
debug.h * this commit is a result of refactoring. only renaming functions, 2007-02-07 01:25:05 +00:00
defines.h
dir.c * object.c (Init_Object): new method Dir.exist?(path). 2006-12-07 15:18:14 +00:00
distruby.rb * mkconfig.rb (RbConfig): add CONFIG['PATCHLEVEL'] 2007-02-27 15:12:18 +00:00
dln.c * dln.c: use dlopen on Mac OS X 10.3 or later. 2007-02-23 01:31:37 +00:00
dln.h
dmydln.c
dmyext.c
enum.c * enum.c (take_i): small cosmetic / documentation patch from 2007-02-27 19:04:52 +00:00
enumerator.c * enumerator.c (enumerator_init_copy): need to copy internal 2007-01-25 22:52:38 +00:00
error.c * blockinlining.c, error.c, eval.c, eval_error.h, eval_intern.h, 2007-02-08 06:37:46 +00:00
euc_jp.c
eval.c * yarvcore.h, vm.h: rename th_invoke_yield() to th_yield(). 2007-02-26 22:51:33 +00:00
eval_error.h * blockinlining.c, error.c, eval.c, eval_error.h, eval_intern.h, 2007-02-08 06:37:46 +00:00
eval_intern.h * process.c: fix to use rb_status_line_set/get/clear(). 2007-02-08 06:48:34 +00:00
eval_jump.h * yarvcore.h: add rb_thread_t#top_wrapper, top_self. 2007-02-25 16:29:26 +00:00
eval_load.c * yarvcore.h: add rb_thread_t#top_wrapper, top_self. 2007-02-25 16:29:26 +00:00
eval_method.h * this commit is a result of refactoring. only renaming functions, 2007-02-07 01:25:05 +00:00
eval_safe.h * blockinlining.c, error.c, eval.c, eval_error.h, eval_intern.h, 2007-02-08 06:37:46 +00:00
file.c * file.c, gc.c, io.c, ruby.h, rubyio.h, win32/win32.h (rb_io_t): 2007-02-24 10:30:50 +00:00
gc.c * file.c, gc.c, io.c, ruby.h, rubyio.h, win32/win32.h (rb_io_t): 2007-02-24 10:30:50 +00:00
gc.h * eval_thread.c, common.mk: remove eval_thread.c. 2007-02-05 12:21:01 +00:00
hash.c * string.c (rb_str_partition): RDoc update. a patch from 2006-10-12 16:07:21 +00:00
ia64.s
inits.c * blockinlining.c, compile.c, compile.h, error.c, eval.c, 2007-02-06 19:00:03 +00:00
insnhelper.h * blockinlining.c, compile.c, compile.h, error.c, eval.c, 2007-02-06 19:00:03 +00:00
insns.def * yarvcore.h, vm.h: rename th_invoke_yield() to th_yield(). 2007-02-26 22:51:33 +00:00
install-sh
instruby.rb * instruby.rb, mkconfig.rb, rubytest.rb, bcc32/mkexports.rb, win32/{resource,mkexports}.rb: set executable. 2006-12-21 15:38:39 +00:00
intern.h * ruby.h: define RUBY_VM macro and remove NATIVETHREAD* macros. 2007-02-25 02:43:43 +00:00
io.c * file.c, gc.c, io.c, ruby.h, rubyio.h, win32/win32.h (rb_io_t): 2007-02-24 10:30:50 +00:00
iseq.c * yarvcore.h: add rb_thread_t#top_wrapper, top_self. 2007-02-25 16:29:26 +00:00
keywords
lex.c
main.c * call_cfunc.ci, compile.c, compile.h, debug.h, eval.c, 2007-02-02 16:26:04 +00:00
marshal.c * parse.y, compile.c, gc.c, insns.def, intern.h, iseq.c, node.h, 2007-02-23 02:49:41 +00:00
math.c * math.c (math_log): update document to mention second optional 2007-02-16 11:12:11 +00:00
mdoc2man.rb
missing.h
mkconfig.rb * mkconfig.rb (RbConfig): add CONFIG['PATCHLEVEL'] 2007-02-27 15:12:18 +00:00
node.h * parse.y, node.h, compile.c: change node tree structure. a purpose 2007-02-24 02:07:05 +00:00
numeric.c * numeric.c (fix_equal): A bit more optimization. 2007-02-21 13:30:17 +00:00
object.c * parse.y, compile.c, gc.c, insns.def, intern.h, iseq.c, node.h, 2007-02-23 02:49:41 +00:00
oniguruma.h merge Oniguruma 4.4.5 2006-10-28 11:15:41 +00:00
opt_insn_unif.def * *.def, proc.c, vm_opts.h.base, template/*: set properties. 2007-02-02 15:21:41 +00:00
opt_operand.def * *.def, proc.c, vm_opts.h.base, template/*: set properties. 2007-02-02 15:21:41 +00:00
pack.c * pack.c (pack_unpack): execute block if given with unpacked value 2006-10-15 22:57:37 +00:00
parse.y * parse.y (f_arg, opt_f_block_arg): ripper should export VALUE. 2007-02-24 08:45:58 +00:00
prec.c
proc.c * yarvcore.h: 2007-02-25 01:34:33 +00:00
process.c * process.c (rb_waitpid_blocking, rb_waitpid): use UBF feature. 2007-02-24 09:43:40 +00:00
random.c * random.c (rb_f_rand): RDoc typo fix. a patch from Frederick 2006-09-24 23:14:14 +00:00
range.c * call_cfunc.ci, compile.c, compile.h, debug.h, eval.c, 2007-02-02 16:26:04 +00:00
re.c * re.c (reg_operand): allow symbols to be operands for regular 2007-02-14 04:57:25 +00:00
re.h
regcomp.c merge Oniguruma 4.4.5 2006-10-28 11:15:41 +00:00
regenc.c
regenc.h * call_cfunc.ci, compile.c, compile.h, debug.h, eval.c, 2007-02-02 16:26:04 +00:00
regerror.c merge Oniguruma 4.4.5 2006-10-28 11:15:41 +00:00
regex.h
regexec.c fix offset value in STATE_CHECK_BUFF_INIT() 2006-10-29 10:55:27 +00:00
regint.h merge Oniguruma 4.4.5 2006-10-28 11:15:41 +00:00
regparse.c merge Oniguruma 4.4.5 2006-10-28 11:15:41 +00:00
regparse.h
ruby.1
ruby.c * Merge YARV 2006-12-31 15:02:22 +00:00
ruby.h * ruby.h: define RUBY_VM macro and remove NATIVETHREAD* macros. 2007-02-25 02:43:43 +00:00
rubyio.h * rubyio.h (HAVE_RB_IO_T): macro to tell if rb_io_t is defined. 2007-02-25 01:16:58 +00:00
rubysig.h * Merge YARV 2006-12-31 15:02:22 +00:00
rubytest.rb * Merge YARV 2006-12-31 15:02:22 +00:00
runruby.rb * Merge YARV 2006-12-31 15:02:22 +00:00
signal.c * ruby.h: define RUBY_VM macro and remove NATIVETHREAD* macros. 2007-02-25 02:43:43 +00:00
sjis.c
sprintf.c * sprintf.c (rb_str_format): should preserve leading zero 2006-10-30 03:39:44 +00:00
st.c * Merge YARV 2006-12-31 15:02:22 +00:00
st.h * hash.c (rb_hash_identical): a new method to make a hash to 2006-09-11 08:09:19 +00:00
string.c * parse.y, compile.c, gc.c, insns.def, intern.h, iseq.c, node.h, 2007-02-23 02:49:41 +00:00
struct.c * struct.c (inspect_struct): do not display a class name for 2006-09-16 02:20:59 +00:00
thread.c * thread.c (rb_thread_run): fix to ANSI style. 2007-02-25 02:36:58 +00:00
thread_pthread.ci * intern.h (rb_thread_blocking_region): add prototype. 2007-02-24 09:41:41 +00:00
thread_pthread.h * thread.c, thread_pthread.ci, thread_win32.ci (thread_start_func_1): 2007-02-08 20:24:55 +00:00
thread_win32.ci * process.c (rb_waitpid_blocking, rb_waitpid): use UBF feature. 2007-02-24 09:43:40 +00:00
thread_win32.h * thread_win32.h: undefine _WIN32 on cygwin. [ruby-dev:30303] 2007-02-07 14:25:03 +00:00
time.c * Merge YARV 2006-12-31 15:02:22 +00:00
utf8.c
util.c * util.c (__crt0_glob_function): use ruby_glob() instead of rb_globi(). 2007-02-27 13:27:14 +00:00
util.h * Merge YARV 2006-12-31 15:02:22 +00:00
variable.c * parse.y, compile.c, gc.c, insns.def, intern.h, iseq.c, node.h, 2007-02-23 02:49:41 +00:00
version.c Sun Nov 26 16:36:46 2006 URABE Shyouhei <shyouhei@ruby-lang.org> 2006-11-26 09:34:32 +00:00
version.h * mkconfig.rb (RbConfig): add CONFIG['PATCHLEVEL'] 2007-02-27 15:12:18 +00:00
vm.c * yarvcore.h, vm.h: rename th_invoke_yield() to th_yield(). 2007-02-26 22:51:33 +00:00
vm.h * vm.(c|h), yarvcore.(c|h) (yarvGlobalStateVersion): rename to 2007-02-14 18:08:10 +00:00
vm_dump.c * yarvcore.h: 2007-02-25 01:34:33 +00:00
vm_evalbody.ci * blockinlining.c, error.c, eval.c, eval_error.h, eval_intern.h, 2007-02-08 06:37:46 +00:00
vm_macro.def * parse.y, node.h, compile.c: change node tree structure. a purpose 2007-02-24 02:07:05 +00:00
vm_opts.h * vm_opts.h: set properties: 2007-02-06 07:41:30 +00:00
yarvcore.c * yarvcore.h, vm.h: rename th_invoke_yield() to th_yield(). 2007-02-26 22:51:33 +00:00
yarvcore.h * yarvcore.h, vm.h: rename th_invoke_yield() to th_yield(). 2007-02-26 22:51:33 +00:00

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 machines, and on DOS,
    Windows, Mac, BeOS etc.)


* 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

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/


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

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

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

  5. Run make.

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

  7. Run 'make install'

     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:

  matz@netlab.jp

-------------------------------------------------------
created at: Thu Aug  3 11:57:36 JST 1995
Local variables:
mode: indented-text
end: