The Ruby Programming Language [mirror]
Go to file
nobu 5d75d9bf3d * ext/iconv/iconv.c (iconv_create): find encoding without options.
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@16834 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
2008-06-05 05:03:46 +00:00
bcc32 * Makefile.in, common.mk, configure.in, {win32,bcc32}/Makefile.sub 2008-04-03 03:56:07 +00:00
benchmark * vm.c, insns.def, eval.c, vm_insnhelper.c: fix CREF handling. 2008-05-19 03:08:50 +00:00
bin Import RubyGems 1.1.0 2008-03-31 22:40:06 +00:00
bootstraptest add a test for [ruby-dev:34679]. 2008-05-24 01:57:02 +00:00
cygwin * cygwin/GNUmakefile.in (clean-local): should be double-colon. 2008-02-24 15:01:06 +00:00
djgpp * configure.in, cygwin/GNUmakefile.in, */Makefile.sub, 2007-12-24 06:42:06 +00:00
doc * enumerator.c (enumerator_with_memo): New method: with_memo(). 2008-06-03 12:43:45 +00:00
enc * enc/iso_8859_5.c: Large omicron should lowercase to small omicron. 2008-06-02 13:30:38 +00:00
ext * ext/iconv/iconv.c (iconv_create): find encoding without options. 2008-06-05 05:03:46 +00:00
include * suppress warnings on cygwin, mingw and mswin. 2008-06-01 19:55:25 +00:00
lib * lib/rdoc.rb: massive spelling correction patch from Evan Farrar 2008-06-04 09:37:38 +00:00
misc * misc/ruby-mode.el (ruby-mode): use run-hooks if run-mode-hook is 2008-05-26 07:51:21 +00:00
missing * lib/rdoc.rb: massive spelling correction patch from Evan Farrar 2008-06-04 09:37:38 +00:00
sample wait signal arrival 10sec. 2008-02-13 13:20:12 +00:00
template * compile.c (struct iseq_link_element, struct iseq_insn_data): made 2008-04-20 05:58:59 +00:00
test * test/iconv/test_{basic,option}.rb, test/iconv/utils.rb: added. 2008-06-05 04:58:41 +00:00
tool * vm_core.h (rb_num_t): moved form vm.h. 2008-05-23 03:23:08 +00:00
vms
win32 * win32/Makefile.sub (miniruby$(EXEEXT)): miniruby cannot be 2008-06-03 11:04:18 +00:00
wince * {bcc32,win32,wince}/Makefile.sub (MISSING): added cbrt.obj. 2008-02-10 06:07:31 +00:00
x68
yarvtest * eval.c (rb_f_send): allow send/__send__ to call methods of all 2007-11-04 20:36:20 +00:00
.cvsignore
.document
.gdbinit * .gdbinit (rp): T_VALUES is no longer defined. 2008-05-23 02:38:02 +00:00
COPYING
COPYING.ja
ChangeLog * ext/iconv/iconv.c (iconv_create): find encoding without options. 2008-06-05 05:03:46 +00:00
GPL
LEGAL * math.c (math_gamma): new method Math.gamma. 2008-02-07 01:43:43 +00:00
LGPL
Makefile.in * Makefile.in, configure.in (warnflags): defaulted to -Wall 2008-05-31 06:58:11 +00:00
README * README, README.ja: Add a note about default C flags. 2008-05-31 14:34:23 +00:00
README.EXT * README.EXT: updated. a patch from Keita Yamaguchi 2007-12-23 21:01:25 +00:00
README.EXT.ja * README.EXT.ja, dir.c, eval.c, eval_intern.h, lex.c.src, 2007-12-25 04:17:06 +00:00
README.ja * README, README.ja: Add a note about default C flags. 2008-05-31 14:34:23 +00:00
ToDo
array.c * array.c (rb_ary_delete_if): should return enumerator if no block 2008-05-31 09:27:42 +00:00
bignum.c * bignum.c (bigzero_p): check from MSB to LSB. [ruby-dev:34649] 2008-05-12 04:44:13 +00:00
blockinlining.c * eval_method.c: renamed from vm_method.c. "vm_method.c" is included 2008-05-24 17:50:17 +00:00
class.c fix doc. 2008-03-09 01:04:46 +00:00
common.mk * common.mk (prelude.c): simply depends on PREP. [ruby-dev:34877] 2008-05-30 03:18:45 +00:00
compar.c * bignum.c (rb_cmpint): moved from compar.c, to check bignum 2008-04-06 17:11:50 +00:00
compile.c * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
compile.h * compile.c, compile.h (compile_debug): made runtime option. 2008-04-14 05:34:04 +00:00
complex.c * math.c (to_flo): rb_Float() accepts even strings for input. 2008-05-16 04:17:45 +00:00
config.guess
config.sub
configure.in * configure.in (CFLAGS, CXXFLAGS): include additional flags to 2008-06-04 04:07:01 +00:00
cont.c * cont.c (cont_restore_0): dynamic stack direction code should be 2008-05-08 22:48:38 +00:00
debug.c * eval_intern.h (enum ruby_tag_type): enum for debug. 2008-05-08 06:56:59 +00:00
debug.h * compile.c, compile.h (compile_debug): made runtime option. 2008-04-14 05:34:04 +00:00
dir.c * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
distruby.rb
dln.c * dln.c (dln_find_exe_r, dln_find_file_r): reentrant versions. 2008-05-07 21:43:54 +00:00
dln.h * dln.c (dln_find_exe_r, dln_find_file_r): reentrant versions. 2008-05-07 21:43:54 +00:00
dmydln.c
dmyencoding.c * encoding.c (enc_init_db): moved to enc/encdb.c. 2008-04-07 06:51:33 +00:00
dmyext.c
encoding.c * suppress warnings on cygwin, mingw and mswin. 2008-06-01 19:55:25 +00:00
enum.c * enum.c (enum_count, count_all_i, Init_Enumerable), 2008-05-29 19:18:54 +00:00
enumerator.c * enumerator.c (enumerator_with_index, enumerator_with_memo): Fix 2008-06-04 06:46:54 +00:00
error.c * error.c (exc_equal): == operator should be transitional. 2008-05-24 13:39:57 +00:00
eval.c * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
eval_error.c * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
eval_intern.h * eval_method.c: renamed from vm_method.c. "vm_method.c" is included 2008-05-24 17:50:17 +00:00
eval_jump.c * eval_method.c: renamed from vm_method.c. "vm_method.c" is included 2008-05-24 17:50:17 +00:00
eval_safe.c * common.mk, *.ci: renamed to *.c. 2007-12-20 09:29:46 +00:00
file.c * file.c (file_expand_path): fix for non-existent files and SFN of 2008-06-03 07:06:23 +00:00
gc.c * gc.c (count_objects): clear given hash. 2008-05-31 14:03:23 +00:00
gc.h * gc.h: extern variable should not be initialized. 2007-12-21 08:13:39 +00:00
gem_prelude.rb * ruby.c (ruby_init_gems), gem_prelude.rb: check if Gem is defined 2008-05-12 01:52:53 +00:00
golf_prelude.rb * golf_prelude.rb (Object.const_missing): fixed typo. 2008-03-17 07:35:11 +00:00
goruby.c * main.c, goruby.c (RUBY_MAIN_INIT): removed. 2007-12-30 22:39:34 +00:00
hash.c * hash.c (env_each_key, env_each_value, env_reject_bang) 2008-05-25 16:06:00 +00:00
ia64.s
id.c * eval_method.c: renamed from vm_method.c. "vm_method.c" is included 2008-05-24 17:50:17 +00:00
id.h * eval_method.c: renamed from vm_method.c. "vm_method.c" is included 2008-05-24 17:50:17 +00:00
inits.c both complex and rational are now builtin classes. 2008-03-16 00:23:43 +00:00
insnhelper.h * eval_intern.h, insnhelper.h, thread_pthread.h, vm_core.h, vm_opts.h: 2008-01-18 08:56:11 +00:00
insns.def * insns.def (DEFINE_INSN): subtract of pointers is ptrdiff_t. 2008-06-01 03:23:50 +00:00
install-sh
instruby.rb * instruby.rb (open_for_install): write block result and rewrite only 2008-03-21 00:24:30 +00:00
io.c * re.c: fix SEGV by Regexp.allocate.names, Match.allocate.names, etc. 2008-06-02 12:45:42 +00:00
iseq.c * suppress warnings on cygwin, mingw and mswin. 2008-06-01 19:55:25 +00:00
keywords * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
lex.c.blt * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
lex.c.src * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
load.c * vm.c, insns.def, eval.c, vm_insnhelper.c: fix CREF handling. 2008-05-19 03:08:50 +00:00
main.c * include/ruby/mvm.h: new header file for MVM, and moved rb_vm_t and 2008-05-31 06:17:45 +00:00
marshal.c * marshal.c (w_object): add a check for modification of array during 2008-06-02 15:29:11 +00:00
math.c * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
mdoc2man.rb
mkconfig.rb * mkconfig.rb: hide build path from rbconfig.rb. 2008-06-02 04:07:07 +00:00
numeric.c * numeric.c: "%" is required before PRI?VALUE. 2008-05-27 23:43:46 +00:00
object.c * object.c (rb_obj_alloc): RDoc updated. a patch from Gaston 2008-06-04 09:55:14 +00:00
opt_insn_unif.def
opt_operand.def
pack.c * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
parse.y * parse.y (assignable_gen): when "self = 1" was evalueted, unnecessary 2008-05-19 16:14:30 +00:00
prec.c * $Date$ keyword removed to avoid inclusion of locale dependent 2008-01-06 15:49:38 +00:00
prelude.rb * prelude.rb (require_relative): move require_relative from 2008-04-12 14:50:18 +00:00
proc.c * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
process.c * process.c (run_exec_pgroup): C99 ism. 2008-06-03 04:36:28 +00:00
random.c * numeric.c (fix_to_s): avoid rb_scan_args() when no argument 2008-03-05 05:22:17 +00:00
range.c * range.c (range_step): call to_int if step is not a numeric 2008-05-02 08:31:04 +00:00
rational.c * rational.c (string_to_r_internal): use rb_isdigit. 2008-06-01 18:23:10 +00:00
re.c * re.c: fix SEGV by Regexp.allocate.names, Match.allocate.names, etc. 2008-06-02 12:45:42 +00:00
regcomp.c * include/ruby/oniguruma.h: Oniguruma 1.9.1 merged. 2008-01-03 15:55:04 +00:00
regenc.c * include/ruby/oniguruma.h: precise mbclen API redesigned to avoid 2008-01-27 14:27:07 +00:00
regenc.h * regparse.c (PINC): use optimized enclen() instead of 2008-05-19 08:25:03 +00:00
regerror.c * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
regexec.c * regexec.c (slow_search): check the case when the length is 1. 2008-05-19 14:21:15 +00:00
regint.h * regint.h (include): include ruby.h instead of defines.h and config.h. 2008-03-19 02:50:12 +00:00
regparse.c * regparse.c (PINC): use optimized enclen() instead of 2008-05-19 08:25:03 +00:00
regparse.h * eval_intern.h, insnhelper.h, thread_pthread.h, vm_core.h, vm_opts.h: 2008-01-18 08:56:11 +00:00
regsyntax.c
ruby.1 * ruby.1: fixed typo. 2008-04-17 15:09:06 +00:00
ruby.c * ruby.c (set_arg0): reverted used variable definition. 2008-06-01 18:52:15 +00:00
rubytest.rb * re.c (rb_char_to_option_kcode): use rb_enc_find_index() instead 2008-01-14 13:49:29 +00:00
runruby.rb
signal.c * signal.c (esignal_signo): fix SignalException#signo which returned 2008-05-30 13:32:39 +00:00
sprintf.c update sprintf rdoc. 2008-04-20 06:44:41 +00:00
st.c * error.c (builtin_types), signal.c (siglist), st.c (primes), 2008-04-26 08:30:22 +00:00
string.c * string.c (hash): should be "static". 2008-06-04 23:13:27 +00:00
struct.c * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
thread.c * suppress warnings on cygwin, mingw and mswin. 2008-06-01 19:55:25 +00:00
thread_pthread.c * vm_core.h (struct rb_unblock_callback), thread.c 2008-05-30 01:52:38 +00:00
thread_pthread.h * eval_intern.h, insnhelper.h, thread_pthread.h, vm_core.h, vm_opts.h: 2008-01-18 08:56:11 +00:00
thread_win32.c * vm_core.h (struct rb_unblock_callback), thread.c 2008-05-30 01:52:38 +00:00
thread_win32.h * $Date$ keyword removed to avoid inclusion of locale dependent 2008-01-06 15:49:38 +00:00
time.c * suppress warnings on cygwin, mingw and mswin. 2008-06-01 19:55:25 +00:00
transcode.c * insns.def (DEFINE_INSN): subtract of pointers is ptrdiff_t. 2008-06-01 03:23:50 +00:00
transcode_data.h * transcode.c (str_transcode): initialize transcoder in 2008-01-21 05:32:12 +00:00
util.c * util.c (ruby_strtod, dtoa): initialize more variables for error 2008-06-01 23:47:02 +00:00
variable.c * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
version.c * version.c (MKSTR): make US-ASCII. [ruby-dev:34010] 2008-03-10 06:53:50 +00:00
version.h * test/ruby/test_process.rb: add tests. 2008-06-04 16:30:03 +00:00
vm.c * suppress warnings on cygwin, mingw and mswin. 2008-06-01 19:55:25 +00:00
vm.h * vm_core.h (rb_num_t): moved form vm.h. 2008-05-23 03:23:08 +00:00
vm_core.h * include/ruby/mvm.h: new header file for MVM, and moved rb_vm_t and 2008-05-31 06:17:45 +00:00
vm_dump.c * insns.def (DEFINE_INSN): subtract of pointers is ptrdiff_t. 2008-06-01 03:23:50 +00:00
vm_eval.c * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
vm_evalbody.c * eval_method.c: renamed from vm_method.c. "vm_method.c" is included 2008-05-24 17:50:17 +00:00
vm_insnhelper.c * eval_method.c: renamed from vm_method.c. "vm_method.c" is included 2008-05-24 17:50:17 +00:00
vm_method.c * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
vm_opts.h * eval.c, vm.c, vm_core.h, vm_insnhelper.c: specify "const". 2008-05-22 04:28:13 +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.

     Some C compiler flags may be added by default depending on your
     environment.  Specify optflags=.. and warnflags=.. as necessary
     to override them.

  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: