1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00
The Ruby Programming Language [mirror]
Find a file
mame 4e9b6e308b merges r28623 from trunk into ruby_1_9_2.
--
* missing/close.c: keep original errno.

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/branches/ruby_1_9_2@28636 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
2010-07-14 03:46:26 +00:00
bcc32 * README: update. 2010-05-06 03:12:28 +00:00
benchmark * tool/mkconfig.rb: generate RbConfig.ruby in rbconfig.rb. 2009-12-31 15:00:04 +00:00
bin * bin/erb: removed trailing spaces. 2010-04-02 04:40:34 +00:00
bootstraptest merges r28453 and r28454 from trunk into ruby_1_9_2. 2010-07-01 02:05:28 +00:00
cygwin * cygwin/GNUmakefile.in (RUBYDEF): uses mkexports.rb on cygwin too. 2009-02-02 23:18:30 +00:00
defs removes the dtrace support. reverts r26239, r26238 and r26235. 2010-01-05 05:59:23 +00:00
doc * ext/pty: moved documents and samples to the appropriate places. 2010-06-23 08:25:12 +00:00
enc * enc/Makefile.in (realclean): has been missing. necessary 2010-06-17 16:35:06 +00:00
ext merges r28550,r28551,r28554 and r28558 from trunk into ruby_1_9_2. 2010-07-10 04:05:52 +00:00
include merges r28561 from trunk into ruby_1_9_2. 2010-07-10 04:06:05 +00:00
lib * gem_prelude.rb: provide workaround for gem activation. Currently, 2010-07-13 15:53:05 +00:00
man * man/*.1: suppressed warnings. 2009-10-26 06:44:31 +00:00
misc * misc/ruby-mode.el (ruby-mode-set-encoding): skip shebang line 2010-05-31 09:22:25 +00:00
missing merges r28623 from trunk into ruby_1_9_2. 2010-07-14 03:46:26 +00:00
sample * ext/pty: moved documents and samples to the appropriate places. 2010-06-23 08:25:12 +00:00
spec * spec/default.mspec (config): . is no longer in $:. 2010-05-08 10:05:36 +00:00
symbian * symbian/setup (config.h): RUBY_EXEC_PREFIX defined. 2010-03-21 15:02:19 +00:00
template * template/fake.rb.in: no need for hook if extmk. 2010-04-24 07:20:28 +00:00
test * gem_prelude.rb: provide workaround for gem activation. Currently, 2010-07-13 15:53:05 +00:00
tool * Makefile.in ({|dist-|real-}clean-ext): fixes the previous 2010-07-11 06:15:13 +00:00
win32 merge revision(s) 27667: 2010-06-08 13:14:51 +00:00
.cvsignore
.document * prelude.rb, .document: Stuff in prelude.rb should be documented 2010-03-29 12:48:43 +00:00
.gdbinit merges r28086,r28162 and r28173 from trunk into ruby_1_9_2. 2010-06-10 15:58:46 +00:00
.gitignore * .gitignore: ignoring fiddle build files 2010-05-07 04:45:27 +00:00
.indent.pro * .indent.pro: added for ruby-style. 2010-03-11 21:50:56 +00:00
array.c merges r28187 and r28189 from trunk into ruby_1_9_2. 2010-06-11 04:21:18 +00:00
bignum.c * removed trailing spaces. 2010-05-29 18:51:39 +00:00
ChangeLog merges r28623 from trunk into ruby_1_9_2. 2010-07-14 03:46:26 +00:00
class.c merges r28453 and r28454 from trunk into ruby_1_9_2. 2010-07-01 02:05:28 +00:00
common.mk * common.mk (test-knownbug): ignore known bugs. 2010-07-01 04:00:56 +00:00
compar.c * array.c: Documentation: change => in call-seq to ->. 2010-05-17 21:50:00 +00:00
compile.c merges r28123 from trunk into ruby_1_9_2. 2010-06-11 04:20:27 +00:00
complex.c * complex.c, rational.c, lib/cmath.rb, lib/date.rb lib/date/delta*: 2010-04-26 11:14:40 +00:00
configure.in merges r28561 from trunk into ruby_1_9_2. 2010-07-10 04:06:05 +00:00
cont.c * cont.c: revert FIBER_USE_NATIVE feature. 2010-05-21 21:51:15 +00:00
COPYING
COPYING.ja
debug.c merges r27944 from trunk into ruby_1_9_2. 2010-05-23 12:18:51 +00:00
debug.h
dir.c merges r28158 from trunk into ruby_1_9_2. 2010-06-11 04:21:07 +00:00
dln.c merges r27944 from trunk into ruby_1_9_2. 2010-05-23 12:18:51 +00:00
dln.h * dln.c (init_funcname_len, dln_find_exe_r, dln_find_file_r): use 2009-03-14 01:56:15 +00:00
dln_find.c * dln_find.c: split from dln.c. 2010-02-24 00:55:03 +00:00
dmydln.c * dln_find.c: split from dln.c. 2010-02-24 00:55:03 +00:00
dmyencoding.c
dmyext.c
dmyversion.c * dmyversion.c: empty load path in miniruby. 2010-02-08 07:28:00 +00:00
encoding.c merge revision(s) 28103: 2010-06-05 17:56:55 +00:00
enum.c merge r28448 from trunk into ruby_1_9_2: 2010-06-27 03:11:44 +00:00
enumerator.c * removed trailing spaces. 2010-05-29 18:51:39 +00:00
error.c merge from trunk (r28333) 2010-06-16 06:45:28 +00:00
eval.c merges r27848 from trunk into ruby_1_9_2. 2010-05-23 10:24:29 +00:00
eval_error.c backport r28368: 2010-06-21 15:14:21 +00:00
eval_intern.h * load.c (ruby_init_ext): statically linked extensions have no 2010-06-03 09:58:32 +00:00
eval_jump.c * eval_error.c (error_print): use volatile to suppress warnings. 2009-02-28 11:12:36 +00:00
file.c * io.c (argf_inplace_mode_set): prohibits an assignment 2010-07-02 10:14:05 +00:00
gc.c * gc.c (heaps_slot, assign_heap_slot, gc_sweep): skip sweep if 2010-06-06 14:46:39 +00:00
gc.h * cont.c: revert FIBER_USE_NATIVE feature. 2010-05-21 21:51:15 +00:00
gem_prelude.rb * gem_prelude.rb: provide workaround for gem activation. Currently, 2010-07-13 15:53:05 +00:00
golf_prelude.rb make ./goruby -e 'p "abc".gs(/a/) { $& }' prints "abc". 2009-03-17 06:40:20 +00:00
goruby.c stripped trailing spaces. 2009-02-22 14:23:33 +00:00
GPL
hash.c * array.c: Documentation: change => in call-seq to ->. 2010-05-17 21:50:00 +00:00
ia64.s
id.c * compile.c (iseq_specialized_instruction), insns.def (opt_size): 2009-09-06 08:39:57 +00:00
inits.c * inits.c (rb_call_inits): do not repeat. 2008-11-07 13:52:07 +00:00
insns.def merges r28146 from trunk into ruby_1_9_2. 2010-06-11 04:20:54 +00:00
io.c merges r28537 and r28555 from trunk into ruby_1_9_2. 2010-07-10 04:05:59 +00:00
iseq.c * iseq.c (iseq_load): allow filepath to be nil. 2010-05-02 03:06:44 +00:00
iseq.h * compile.c (ADD_TRACE): fire coverage event in ensure clause. 2009-10-08 16:11:30 +00:00
KNOWNBUGS.rb indented. 2010-02-20 03:17:44 +00:00
LEGAL * LEGAL: separated the section for parse.c. contributed by Paul 2010-04-12 12:47:43 +00:00
lex.c.blt * defs/keywords (reserved_word): made inline function static. 2009-05-16 00:30:16 +00:00
load.c * load.c (ruby_init_ext): statically linked extensions have no 2010-06-03 09:58:32 +00:00
main.c
Makefile.in * Makefile.in ({|dist-|real-}clean-ext): fixes the previous 2010-07-11 06:15:13 +00:00
marshal.c * marshal.c (w_object, r_bytes0, marshal_load): suppress warnings. 2010-06-27 15:13:25 +00:00
math.c * array.c: Documentation: change => in call-seq to ->. 2010-05-17 21:50:00 +00:00
method.h * vm_method.c (rb_unlink_method_entry, rb_sweep_method_entry): 2010-05-05 17:51:21 +00:00
NEWS * NEWS (YAML, Psych, DL, fiddle): new entries 2010-07-01 11:38:51 +00:00
node.c * node.c (dump_node): fixed for long members. 2009-12-09 15:46:45 +00:00
node.h * bignum.c, node.h, strftime.c, enc/trans/utf8_mac.trans: added explicit casts for supplessing warnings. 2010-03-25 03:08:28 +00:00
numeric.c merges r27953 from trunk into ruby_1_9_2. 2010-05-23 12:19:02 +00:00
object.c merges r28357 from trunk into ruby_1_9_2. 2010-06-29 14:48:05 +00:00
pack.c update doc. 2010-06-28 13:05:07 +00:00
parse.y merges r28123 from trunk into ruby_1_9_2. 2010-06-11 04:20:27 +00:00
prelude.rb Fix :nodoc: definition. [ruby-dev:40949] 2010-04-10 22:09:09 +00:00
proc.c * removed trailing spaces. 2010-05-29 18:51:39 +00:00
process.c * process.c (rb_f_spawn): use correct command name for the error 2010-05-23 23:16:09 +00:00
random.c * random.c (random_rand): add the result of random to the 2010-05-26 11:19:30 +00:00
range.c * array.c: Documentation: change => in call-seq to ->. 2010-05-17 21:50:00 +00:00
rational.c * complex.c, rational.c, lib/cmath.rb, lib/date.rb lib/date/delta*: 2010-04-26 11:14:40 +00:00
re.c merge revision(s) 28174:28178: 2010-06-05 14:16:05 +00:00
README * README: add a note about linking a library whose license is not 2010-06-11 13:38:18 +00:00
README.EXT Add more description about Fixnum's size. [ruby-core:27333] 2009-12-30 11:45:32 +00:00
README.EXT.ja * blockinlining.c: removed. 2009-09-17 06:03:39 +00:00
README.ja * README: update. 2010-05-06 03:12:28 +00:00
regcomp.c * regcomp.c (noname_disable_map): add NT_ANCHOR case. 2010-03-02 09:40:27 +00:00
regenc.c * regenc.h (PosixBracketEntryType): constified. 2009-09-22 07:28:43 +00:00
regenc.h * include/ruby/oniguruma.h: updated to follow Oniguruma 5.9.2. 2010-03-01 21:54:59 +00:00
regerror.c * removed spaces just before tabs. 2009-11-26 05:25:08 +00:00
regexec.c * include/ruby/oniguruma.h: updated to follow Oniguruma 5.9.2. 2010-03-01 21:54:59 +00:00
regint.h * include/ruby/oniguruma.h: updated to follow Oniguruma 5.9.2. 2010-03-01 21:54:59 +00:00
regparse.c * regparse.c (onig_syntax_warn): do not use external strings as 2010-05-31 10:26:01 +00:00
regparse.h *regparse.c (CC_DUP_WARN): use rb_compile_warn if ScanEnv has source 2009-08-30 08:00:31 +00:00
regsyntax.c stripped trailing spaces. 2009-02-22 14:23:33 +00:00
ruby.c * include/ruby/io.h, io.c: reverted r21709. 2010-06-27 14:31:19 +00:00
safe.c * file.c (rb_get_path_check): check with given safe level. 2009-06-23 12:28:16 +00:00
signal.c * array.c: Documentation: change => in call-seq to ->. 2010-05-17 21:50:00 +00:00
sprintf.c * array.c: Documentation: change => in call-seq to ->. 2010-05-17 21:50:00 +00:00
st.c * st.c (st_foreach): don't access ptr->hash after func call. 2010-02-15 13:45:52 +00:00
strftime.c * time.c: less bignum allocations. 2010-03-31 12:34:31 +00:00
string.c merges r28577 from trunk into ruby_1_9_2. 2010-07-10 04:06:12 +00:00
struct.c * array.c: Documentation: change => in call-seq to ->. 2010-05-17 21:50:00 +00:00
thread.c merges r28457 from trunk into ruby_1_9_2. 2010-07-01 07:41:55 +00:00
thread_pthread.c merge revision(s) 28507: 2010-07-01 07:26:51 +00:00
thread_pthread.h * thread_pthread.c (native_thread_init_stack): use get_stack. 2010-02-04 07:17:03 +00:00
thread_win32.c * vm.c (Init_BareVM): call Init_native_thread here. 2010-06-05 23:26:43 +00:00
thread_win32.h
time.c * time.c (num_exact): fix for mathn. [ruby-dev:41599] 2010-06-22 14:13:09 +00:00
timev.h * timev.h (TIME_SCALE): defined as 1000000000. 2009-08-29 19:06:29 +00:00
ToDo
transcode.c merge from trunk (r28349) 2010-06-17 09:55:46 +00:00
transcode_data.h * transcode_data.h, transcode.c, tool/transcode-tblgen.rb: Added 2009-12-10 11:59:12 +00:00
util.c * io.c (argf_inplace_mode_set): prohibits an assignment 2010-07-02 10:14:05 +00:00
variable.c * array.c: Documentation: change => in call-seq to ->. 2010-05-17 21:50:00 +00:00
version.c * vm.c (vm_backtrace_each): get rid of use of malloc from signal 2010-04-15 05:38:07 +00:00
version.h * 2010-07-14 2010-07-13 15:53:08 +00:00
vm.c merges r28548 from trunk into ruby_1_9_2. 2010-07-05 16:14:55 +00:00
vm_core.h merges r27789 from trunk into ruby_1_9_2. 2010-05-16 12:15:59 +00:00
vm_dump.c merge frrom trunk (r27729) 2010-05-12 07:34:23 +00:00
vm_eval.c * removed trailing spaces. 2010-05-29 18:51:39 +00:00
vm_exec.c * vm_exec.c (DECL_SC_REG): use __clang__. 2009-10-27 00:29:06 +00:00
vm_exec.h removes the dtrace support. reverts r26239, r26238 and r26235. 2010-01-05 05:59:23 +00:00
vm_insnhelper.c * removed trailing spaces. 2010-05-29 18:51:39 +00:00
vm_insnhelper.h * vm_insnhelper.h (GET_BLOCK_PTR): return 0 when in class frame. 2010-01-11 09:33:37 +00:00
vm_method.c * removed trailing spaces. 2010-05-29 18:51:39 +00:00
vm_opts.h
vsnprintf.c * removed trailing spaces. 2010-05-29 18:51:39 +00:00

* 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://redmine.ruby-lang.org/wiki/ruby-19/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

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'

     This command will create following directories and install files
     onto 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.

DO NOT LINK Ruby WITH A LIBRARY WHOSE LICENSE IS NOT COMPATIBLE WITH Ruby
License (see COPYING).
For example, currently you cannot link with readline6, which is under GPLv3.


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