The Ruby Programming Language [mirror]
Go to file
matz d68321c18e * file.c (rb_file_s_expand_path): new class method for class File.
* file.c (file_expand_path): add absolute_path handling (no ~user
  expansion).  [ruby-core:18319]

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@18892 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
2008-08-28 03:51:22 +00:00
bcc32 * common.mk (parse.h): workaround for nmake. 2008-08-14 02:45:11 +00:00
benchmark * vm.c, insns.def, eval.c, vm_insnhelper.c: fix CREF handling. 2008-05-19 03:08:50 +00:00
bin
bootstraptest * gc.c (rb_gc_call_finalizer_at_exit): self-referencing finalizers 2008-08-06 11:48:30 +00:00
cygwin * configure.in (gnumake): check for GNU make. 2008-08-14 03:01:42 +00:00
djgpp * configure.in (gnumake): check for GNU make. 2008-08-14 03:01:42 +00:00
doc * enumerator.c: Activate Enumerator#with_object and add 2008-08-26 05:45:18 +00:00
enc * enc/emacs_mule.c: fix ctype. 2008-08-24 22:10:57 +00:00
ext * ext/win32ole/win32ole.c (ole_invoke): WIN32OLE#[] and WIN32OLE#[]= 2008-08-27 14:43:23 +00:00
include * include/ruby/io.h (rb_io_t): refcnt field removed. 2008-08-27 17:19:19 +00:00
lib revert removed comment. 2008-08-27 05:02:32 +00:00
misc * misc/ruby-mode.el (ruby-imenu-create-index-in-block): Fix the 2008-08-07 09:04:27 +00:00
missing * configure.in: removed strftime from AC_REPLACE_FUNCS(). 2008-08-20 16:04:11 +00:00
sample * sample/exyacc.rb: fixed NoMethodError(Kernel#sub!). 2008-07-26 14:19:50 +00:00
spec Improved compatibility for mspec. 2008-08-04 11:44:41 +00:00
template * compile.c (struct iseq_link_element, struct iseq_insn_data): made 2008-04-20 05:58:59 +00:00
test * test/cgi/test_cgi_multipart.rb: add test for multipart. 2008-08-28 00:30:40 +00:00
tool * common.mk (dist): tool/make-snapshot is executable. 2008-08-25 17:47:57 +00:00
vms
win32 * win32.c (init_stdhandle): set binmode. 2008-08-25 14:58:01 +00:00
wince * configure.in (rb_cv_missing__dtos18, rb_cv_missing_fconvert), 2008-08-09 23:15:08 +00:00
x68
yarvtest
.cvsignore
.document
.gdbinit * .gdbinit (rp): T_VALUES is no longer defined. 2008-05-23 02:38:02 +00:00
COPYING
COPYING.ja
ChangeLog * file.c (rb_file_s_expand_path): new class method for class File. 2008-08-28 03:51:22 +00:00
GPL
KNOWNBUGS.rb * vm_core.h (rb_thread_t), vm.c (rb_thread_mark), process.c 2008-07-10 03:10:00 +00:00
LEGAL
LGPL
Makefile.in * configure.in (BUILTIN_TRANSSRCS): defined. 2008-08-24 15:58:43 +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, README.EXT.ja: mention about FIX2LONG and NUM2LONG. 2008-07-22 09:09:41 +00:00
README.EXT.ja * README.EXT, README.EXT.ja: mention about FIX2LONG and NUM2LONG. 2008-07-22 09:09:41 +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_sample): performance improvement for huge array. 2008-08-20 07:40:03 +00:00
bignum.c * array.c, bignum.c, cont.c, dir.c, dln.c, encoding.c, enumerator.c, 2008-06-08 10:01:40 +00:00
blockinlining.c * include/ruby/ruby.h (CONST_ID): constant ID cache for non-gcc. 2008-06-09 09:25:32 +00:00
class.c * object.c (rb_obj_untrusted): new method Object#untrusted?. 2008-08-13 07:25:05 +00:00
common.mk * common.mk (dist): tool/make-snapshot is executable. 2008-08-25 17:47:57 +00:00
compar.c * include/ruby/ruby.h (rb_intern_const): tiny optimization. 2008-08-16 00:20:31 +00:00
compile.c * compile.c (defined_expr): default defined? should return 2008-08-25 14:04:09 +00:00
compile.h * compile.h: fix to skip inserting a trace insn. 2008-07-08 04:43:02 +00:00
complex.c * complex.c (nucomp_div): now behaves as quo. 2008-08-22 12:27:54 +00:00
config.guess * config.guess ({powerpc-apple,i586-pc}-haiku): re-applied r18403. 2008-08-10 03:34:44 +00:00
config.sub * config.{guess,sub}: updated to automake-1.10.1. 2008-08-10 03:29:21 +00:00
configure.in * configure.in (BUILTIN_TRANSSRCS): defined. 2008-08-24 15:58:43 +00:00
cont.c * include/ruby/ruby.h (enum ruby_special_consts): ISO C forbids 2008-07-01 08:27:58 +00:00
debug.c * object.c (rb_obj_untrusted): new method Object#untrusted?. 2008-08-13 07:25:05 +00:00
debug.h * compile.c, compile.h (compile_debug): made runtime option. 2008-04-14 05:34:04 +00:00
dir.c * dir.c (dir_enc_str_new): set US-ASCII to the path 2008-08-22 03:32:13 +00:00
distruby.rb
dln.c * dln.c (load_lib): use dln_find_file_r instead of dln_find_file. 2008-07-28 05:29:56 +00:00
dln.h * dln.h (dln_find_exe, dln_find_file): deprecated, use reentrant 2008-07-27 00:15:31 +00:00
dmydln.c
dmyencoding.c
dmyext.c
encoding.c * encoding.c (enc_compatible_p): raise TypeError when argument is Encoding. 2008-08-23 21:12:32 +00:00
enum.c * enum.c (enum_take): get rid of extraneous iteration. 2008-08-20 13:24:51 +00:00
enumerator.c * enumerator.c: Activate Enumerator#with_object and add 2008-08-26 05:45:18 +00:00
error.c * error.c (rb_eEncCompatError): add Exception. 2008-08-12 18:17:05 +00:00
eval.c * eval.c (Init_eval): typo fixed in r17833. 2008-07-03 12:06:22 +00:00
eval_error.c * suppress warnings with -Wwrite-string. 2008-05-31 09:28:20 +00:00
eval_intern.h * configure.in (shutdown, sched_yield, pthread_attr_setinheritsched): 2008-08-08 08:03:19 +00:00
eval_jump.c * include/ruby/intern.h, proc.c: revert rb_proc_call() and 2008-06-10 16:33:51 +00:00
eval_safe.c
file.c * file.c (rb_file_s_expand_path): new class method for class File. 2008-08-28 03:51:22 +00:00
gc.c * include/ruby/io.h (rb_io_t): remove path field and add pathv field. 2008-08-23 00:47:54 +00:00
gc.h * gc.h (STACK_UPPER): moved from gc.c 2008-06-14 02:59:19 +00:00
gem_prelude.rb Fix RubyGems for 1.9, r1780 2008-06-17 23:59:31 +00:00
golf_prelude.rb * golf_prelude.rb, lib/set.rb (TC_Set#test_each), 2008-08-13 08:03:30 +00:00
goruby.c
hash.c * include/ruby/ruby.h (rb_intern_const): tiny optimization. 2008-08-16 00:20:31 +00:00
ia64.s
id.c * id.c (Init_id): commit miss. 2008-08-16 06:43:37 +00:00
id.h * include/ruby/encoding.h (rb_enc_ispunct): added. 2008-08-14 08:57:07 +00:00
inits.c * include/ruby/encoding.h (rb_enc_ispunct): added. 2008-08-14 08:57:07 +00:00
insnhelper.h
insns.def * configure.in (sizeof ptrdiff_t): check for size of ptrdiff_t. 2008-07-12 13:17:29 +00:00
install-sh
instruby.rb
io.c * include/ruby/io.h (rb_io_t): refcnt field removed. 2008-08-27 17:19:19 +00:00
iseq.c * iseq.c (iseq_inspect): don't raise on uninitialized object. 2008-08-21 17:25:43 +00:00
keywords * parse.y (primary): make functional-style not operator to act 2008-06-25 12:55:47 +00:00
lex.c.blt * parse.y (primary): make functional-style not operator to act 2008-06-25 12:55:47 +00:00
lex.c.src * parse.y (primary): make functional-style not operator to act 2008-06-25 12:55:47 +00:00
load.c * include/ruby/ruby.h (rb_intern_const): tiny optimization. 2008-08-16 00:20:31 +00:00
main.c * configure.in (rb_cv_missing__dtos18, rb_cv_missing_fconvert), 2008-08-09 23:15:08 +00:00
marshal.c * include/ruby/ruby.h (rb_intern_const): tiny optimization. 2008-08-16 00:20:31 +00:00
math.c * math.c (math_atanh): raise EDOM on FreeBSD when atanh(1). 2008-07-28 17:42:32 +00:00
mdoc2man.rb
mkconfig.rb Simplify expression for RDoc. 2008-07-17 01:55:58 +00:00
numeric.c * include/ruby/ruby.h (rb_intern_const): tiny optimization. 2008-08-16 00:20:31 +00:00
object.c * include/ruby/ruby.h (rb_intern_const): tiny optimization. 2008-08-16 00:20:31 +00:00
opt_insn_unif.def
opt_operand.def
pack.c * pack.c (pack_unpack): upper half of hexdigits has never been used. 2008-07-31 03:23:55 +00:00
parse.y * parse.y (YYSTYPE): struct RVarmap has been no longer 2008-08-25 05:27:46 +00:00
prec.c * include/ruby/ruby.h (rb_intern_const): tiny optimization. 2008-08-16 00:20:31 +00:00
prelude.rb * prelude.rb (require_relative): move require_relative from 2008-04-12 14:50:18 +00:00
proc.c * proc.c (proc_new): use the given class. 2008-08-20 13:28:18 +00:00
process.c * process.c (pst_pid): use rb_attr_get to avoid warning on 2008-08-21 10:18:38 +00:00
random.c * random.c (struct MT): packed Mersenne Twister staffs. 2008-08-17 02:43:20 +00:00
range.c * range.c (range_initialize_copy): Range is now a Struct. 2008-08-20 21:02:54 +00:00
rational.c * complex.c (nucomp_div): now behaves as quo. 2008-08-22 12:27:54 +00:00
re.c * re.c (rb_reg_inspect): don't raise for uninitialized Regexp. 2008-08-18 15:56:38 +00:00
regcomp.c * regexec.c (stack_double): use MatchStackLimitSize atomically. 2008-07-01 08:21:44 +00:00
regenc.c * regenc.c (code_to_mbc): raise RangeError Integer#chr 2008-08-06 20:17:55 +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 (stack_double): use MatchStackLimitSize atomically. 2008-07-01 08:21:44 +00:00
regint.h * thread.c (rb_thread_check_ints): added. please note that 2008-08-13 08:21:24 +00:00
regparse.c * regparse.c (parse_exp): fix memory leak. 2008-07-30 12:30:28 +00:00
regparse.h * regexec.c (stack_double): use MatchStackLimitSize atomically. 2008-07-01 08:21:44 +00:00
regsyntax.c * regexec.c (stack_double): use MatchStackLimitSize atomically. 2008-07-01 08:21:44 +00:00
ruby.1 * ruby.1: fixed typo. 2008-04-17 15:09:06 +00:00
ruby.c * include/ruby/intern.h (rb_io_ungetbyte): added prototype. 2008-08-25 08:36:46 +00:00
rubytest.rb
runruby.rb * lib/rubygems/ext/builder.rb (Gem::Ext::Builder.make), 2008-07-01 06:01:15 +00:00
signal.c * signal.c (signal_exec, trap_handler): trap accepts a string as 2008-07-16 09:04:37 +00:00
sprintf.c * sprintf.c, util.c (quorem, nrv_alloc, dtoa): enabled floating point 2008-08-12 07:06:33 +00:00
st.c * array.c, bignum.c, cont.c, dir.c, dln.c, encoding.c, enumerator.c, 2008-06-08 10:01:40 +00:00
strftime.c * strftime.c (daylight, timezone): not provied as dllexport on cygwin, 2008-08-23 23:03:44 +00:00
string.c * include/ruby/ruby.h (rb_intern_const): tiny optimization. 2008-08-16 00:20:31 +00:00
struct.c * range.c (range_initialize_copy): Range is now a Struct. 2008-08-20 21:02:54 +00:00
thread.c * include/ruby/ruby.h (rb_intern_const): tiny optimization. 2008-08-16 00:20:31 +00:00
thread_pthread.c * thread.c, vm_core.h: add manual priority support 2008-08-13 07:53:35 +00:00
thread_pthread.h
thread_win32.c * thread.c, vm_core.h: add manual priority support 2008-08-13 07:53:35 +00:00
thread_win32.h * thread_win32.[ch] (cond_every_entry, rb_thread_cond_struct): reverted 2008-07-28 12:27:43 +00:00
time.c * time.c (time_asctime): workaround for MSVCRT's bug. 2008-08-26 13:47:17 +00:00
transcode.c * transcode.c (transcode_loop): simplified. 2008-08-26 16:14:49 +00:00
transcode_data.h * transcode_data.h (rb_transcoder_stateful_type_t): defined. 2008-08-15 23:13:01 +00:00
util.c * sprintf.c, util.c (quorem, nrv_alloc, dtoa): enabled floating point 2008-08-12 07:06:33 +00:00
variable.c * object.c (rb_obj_untrusted): new method Object#untrusted?. 2008-08-13 07:25:05 +00:00
version.c * version.c (Init_version): add RUBY_ENGINE constant. 2008-08-14 08:28:44 +00:00
version.h * 2008-08-28 2008-08-27 15:09:52 +00:00
vm.c * proc.c (proc_new): use the given class. 2008-08-20 13:28:18 +00:00
vm.h * vm.c, eval_intern.h (PASS_PASSED_BLOCK): 2008-06-10 21:46:43 +00:00
vm_core.h * proc.c (proc_new): use the given class. 2008-08-20 13:28:18 +00:00
vm_dump.c * configure.in (sizeof ptrdiff_t): check for size of ptrdiff_t. 2008-07-12 13:17:29 +00:00
vm_eval.c * vm_eval.c (vm_call_super): fixed typo, and get rid of too large 2008-08-04 08:37:48 +00:00
vm_evalbody.c * vm.c, eval_intern.h (PASS_PASSED_BLOCK): 2008-06-10 21:46:43 +00:00
vm_insnhelper.c * proc.c (proc_new): use the given class. 2008-08-20 13:28:18 +00:00
vm_method.c * include/ruby/ruby.h (rb_intern_const): tiny optimization. 2008-08-16 00:20:31 +00:00
vm_opts.h * vm_opts.h: enable "OPT_TRACE_INSTRUCTION" on default. 2008-08-23 06:18:11 +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: