8 files changed, 2087 insertions, 0 deletions
diff --git a/doc/NEWS b/doc/NEWS
new file mode 100644
index 0000000000..703508ae2e
--- /dev/null
+++ b/doc/NEWS
@@ -0,0 +1,285 @@
+Summary of the changes since 1.6.3:
+
+: Hash#replace
+
+  Fixed so the following code does not fail in core dump.
+
+    h  = { 10 => 100, 20 => 200 }
+    h2 = { }
+
+    h.each { |k, v|
+      if (k == 10)
+        h.delete(10)
+        h2.replace(h)  # => Abort core dumped
+      end
+    }
+
+: File::unlink
+
+  Changed to be forbidden under $SAFE >= 2.
+
+: ruby -T4
+
+  Fixed.  ARGV is now properly marked as tainted so ruby -T4 no longer
+  fails in SecurityError.
+
+: Regexp
+
+  Fixed.  Now \1 .. \9 always mean backreferences, and referring to
+  unclosed/unmatched parentheses always fails.
+
+: String taint infection
+
+  Fixed for the following cases.  [ruby-dev:13340]
+
+  # []=
+  s1 = "abc"
+  s2 = "cde".taint
+  s1[0]= s2
+  p s1.tainted?             # => false
+
+  # crypt
+  s = "abc".taint
+  p s.crypt("cd").tainted?  # => false
+
+  # ljust
+  s = "abc".taint
+  p s.ljust(10).tainted?    # => false
+
+  # rjust
+  s = "abc".taint
+  p s.rjust(10).tainted?    # => false
+
+  # center
+  s = "abc".taint
+  p s.center(10).tainted?   # => false
+
+  Now they will all be marked as tainted.
+
+: rb_yield_0()
+
+  Fixed so it adjusts a 1-element array when yielded from C API, as
+  well.  Previously, the following code produced a wrong result:
+
+    class X
+      include Enumerable
+
+      def each(&block)
+        block.call(1)
+        block.call(2)
+        block.call(3)
+      end
+    end
+
+    x = X.new
+    p x.to_a #=> [[1], [2], [3]]
+
+  Now it properly produces [1, 2, 3].
+
+: $SAFE
+
+  Fixed so aliasing global valiables is disallowed under $SAFE = 4.
+ ((<ruby-dev:13287>))
+
+: Open3::popen3
+
+  Fixed to do exit! instead of exit so the dying process does not
+  invoke at_exit. ((<ruby-dev:13170>))
+
+: SizedQueue#pop
+
+  Fixed so the following code does not cause a dead lock.
+  ((<ruby-dev:13169>))
+
+    ruby -r thread -e 'q = SizedQueue.new(1); q.push(1);'
+                   -e 'Thread.new{sleep 1; q.pop}; q.push(1);'
+
+: SizedQueue#max=
+
+  Fixed so it really works. ((<ruby-dev:13170>))
+
+: Queue
+: SizedQueue
+
+  Fixed to rescue ThreadError in case the thread is dead just before
+  calling Thread#run. ((<ruby-dev:13194>))
+
+: Array#&
+: Array#|
+: Array#uniq
+
+  Fixed so they do not freeze the elements. ((<ruby-list:29665>))
+
+    (%w(foo bar) & %w(foo baz))[0].upcase!
+    => -:1:in `upcase!': can't modify frozen string (TypeError)
+
+    %w(foo bar bar baz).uniq[0].upcase!
+    => -:1:in `upcase!': can't modify frozen string (TypeError)
+
+: shell.rb
+
+    shell.rb 0.6 is newly imported as a standard library, along with
+    documents.
+
+: forwardable.rb
+
+    forwardable.rb 1.1 is newly imported as a standard library, along with
+    documents.
+
+: irb & irb-tools
+
+    irb and irb-tolls are updated to 0.7.4 and 0.7.1, respectively.
+
+: Daylight saving time
+
+  Fixed so it is handled correctly. [ruby-bugs-ja (PR#46)]
+
+    env TZ=America/Managua ruby -e 'p Time.local(1998,12,1,0,59,59)'
+    => Mon Nov 30 01:59:59 EST 1998
+    env TZ=America/Managua ruby -e 'p Time.local(1998,12,1,0,59,59).tv_sec'   
+    => 912409199
+
+: SIGINFO
+
+  Support SIGINFO of 4.4BSD.  [ruby-bugs-ja (PR#45)]
+
+: Modifier rescue
+
+  Fixed so the following code does not emit a parse error any more.
+  ((<ruby-dev:13073>)), ((<ruby-dev:13292>))
+
+    raise "" rescue []
+    raise "" rescue (p "foo"; true)
+    raise "" rescue -1
+    raise "" rescue (-1)
+
+: Thread
+
+  Fixed so the following code does not cause a dead lock any more.
+
+    Thread.start { Thread.stop }
+    sleep
+
+    => deadlock 0x40199b58: 2:0  - -:1
+       deadlock 0x401a2528: 2:4 (main) - -:2
+       -:2:in `sleep': Thread: deadlock (fatal)
+               from -:2
+       ruby 1.6.3 (2001-03-19) [i586-linux]
+
+: Module#const_defined?
+: Module#const_get
+: Module#const_set
+
+  Fixed so they do not access to anything other than constants.
+  ((<ruby-dev:13019>))
+
+: Marshal.dump
+
+  Improved so it dumps Float with better precision: "%.12g" -> "%.16g"
+  ((<ruby-list:29349>))
+
+: Fixnum#[]
+
+  Fixed a bug on the platforms which sizeof(long) > sizeof(int).
+
+: Regular Expression
+
+  Fixed a couple of minor bugs. ((<ruby-talk:13658>)), ((<ruby-talk:13744>))
+
+: retry
+
+  Fixed so the following code works correctly again. ((<ruby-talk:13957>))
+
+        def WHILE(cond)
+          return if not cond
+          yield
+          retry
+        end
+
+        i=0
+        WHILE(i<3) {
+          print i
+          i+=1
+        }
+
+        ruby 1.6.2 (2000-12-25) [i586-linux]
+        => 012
+
+        ruby 1.6.3 (2001-03-19) [i586-linux]
+        => 0
+
+        ruby 1.6.4 (2001-05-02) [i586-linux]
+        => 012
+
+: ((<File::Stat>))#size
+
+  Fixed to return a correct value for files larger than 1G bytes.
+
+        File.open("/tmp/1GB", "w") {|f|
+          f.seek(2**30-1, 0)
+          f.puts
+          f.flush
+          p f.stat.size
+        }
+
+        # => ruby 1.6.3 (2001-04-03) [i586-linux]
+             -1073741824
+        # => ruby 1.6.4 (2001-04-19) [i586-linux]
+             1073741824
+
+: ((<Float>))#modulo, ((<Float>))#divmod
+
+  Fixed. ((<ruby-dev:12718>))
+
+: ((<ObjectSpace>))#_id2ref
+
+  Fixed so it does not raise a  exception.
+
+: recursive malloc problem
+
+  Fixed by preallocating a buffer for stdio using setvbuf().
+  ((<ruby-dev:12795>))
+
+: ((<File>))#flock
+
+  Fixed so it does not raise Errno::EACCES when the file to flock is
+  already locked. (only applicable to the platforms which lack
+  flock())
+
+: ((<File::Stat>)).new(filename)
+
+  Added. ((<ruby-dev:12803>))
+
+: ((<Bignum>))#% miscalculation
+
+  (Re-)Fixed.
+
+        a = 677330545177305025495135714080
+        b = 14269972710765292560
+        p a % b  #=> 0
+        p -a % b #=> 
+
+        => ruby 1.6.3 (2001-04-02) [i386-cygwin]
+           0
+           14269972710765292560
+
+        => ruby 1.6.4 (2001-04-19) [i586-linux]
+           0
+           0
+
+: ((<Marshal>))
+
+  Fixed so a Bignum is properly restored through dump & load.
+
+: Universal Naming Convention(UNC) support (win32)
+
+  Added.  Now the UNC form (//host/share) is supported.  Use slash
+  (`(({/}))') instead of backslash (`(({\}))') for separating
+  components.
+
+: ((<Dir>)).glob (win32)
+
+  Fixed so it works for the current directory as well.
+
+        p Dir["./*.c"]
+        => []
diff --git a/doc/forwardable.rd b/doc/forwardable.rd
new file mode 100644
index 0000000000..7272c374b6
--- /dev/null
+++ b/doc/forwardable.rd
@@ -0,0 +1,84 @@
+ -- forwardable.rb
+						
+                                                $Release Version: 1.1 $
+                                                $Revision$
+                                                $Date$
+						Original version by Tosh
+
+=begin
+
+= Forwardable
+
+A Module to define delegations for selected methods to a class.
+
+== Usage
+
+Using through extending the class.
+  
+  class Foo
+    extend Forwardable
+
+    def_delegators("@out", "printf", "print")
+    def_delegators(:@in, :gets)
+    def_delegator(:@contents, :[], "content_at")
+  end
+  f = Foo.new
+  f.printf ...
+  f.gets
+  f.content_at(1)
+
+== Methods
+
+--- Forwardable#def_instance_delegators(accessor, *methods)
+
+      adding the delegations for each method of ((|methods|)) to
+      ((|accessor|)).
+
+--- Forwardable#def_instance_delegator(accessor, method, ali = method)
+      
+      adding the delegation for ((|method|)) to ((|accessor|)). When
+      you give optional argument ((|ali|)), ((|ali|)) is used as the
+      name of the delegation method, instead of ((|method|)).
+
+--- Forwardable#def_delegators(accessor, *methods)
+
+      the alias of ((|Forwardable#def_instance_delegators|)).
+
+--- Forwardable#def_delegator(accessor, method, ali = method)
+      
+      the alias of ((|Forwardable#def_instance_delegator|)).
+
+= SingleForwardable
+
+a Module to define delegations for selected methods to an object.
+
+== Usage
+
+Using through extending the object.
+
+  g = Goo.new
+  g.extend SingleForwardable
+  g.def_delegator("@out", :puts)
+  g.puts ...
+
+== Methods
+
+--- SingleForwardable#def_singleton_delegators(accessor, *methods)
+
+      adding the delegations for each method of ((|methods|)) to
+      ((|accessor|)).
+
+--- SingleForwardable#def_singleton_delegator(accessor, method, ali = method)
+
+      adding the delegation for ((|method|)) to ((|accessor|)). When
+      you give optional argument ((|ali|)), ((|ali|)) is used as the
+      name of the delegation method, instead of ((|method|)).
+
+--- SingleForwardable#def_delegators(accessor, *methods)
+
+      the alias of ((|SingleForwardable#def_instance_delegators|)).
+
+--- SingleForwardable#def_delegator(accessor, method, ali = method)
+
+      the alias of ((|SingleForwardable#def_instance_delegator|)).
+=end
diff --git a/doc/forwardable.rd.jp b/doc/forwardable.rd.jp
new file mode 100644
index 0000000000..d928fddc5e
--- /dev/null
+++ b/doc/forwardable.rd.jp
@@ -0,0 +1,81 @@
+  -- forwatable.rb
+                                                $Release Version: 1.1 $
+                                                $Revision$
+                                                $Date$
+
+=begin
+= Forwardable
+
+���饹���Ф��᥽�åɤΰѾ���ǽ��������ޤ�.
+
+== �Ȥ���
+
+���饹���Ф���extend���ƻȤ��ޤ�. 
+  
+  class Foo
+    extend Forwardable
+
+    def_delegators("@out", "printf", "print")
+    def_delegators(:@in, :gets)
+    def_delegator(:@contents, :[], "content_at")
+  end
+  f = Foo.new
+  f.printf ...
+  f.gets
+  f.content_at(1)
+
+== �᥽�å�
+
+--- Forwardable#def_instance_delegators(accessor, *methods)
+
+      ((|methods|))���Ϥ��줿�᥽�åɤΥꥹ�Ȥ�((|accessor��|))�Ѿ�����
+      �褦�ˤ��ޤ�.
+
+--- Forwardable#def_instance_delegator(accessor, method, ali = method)
+
+      ((||method|))���Ϥ��줿�᥽�åɤ�((|accessor|))�˰Ѿ�����褦�ˤ�
+      �ޤ�. ((|ali|))�������Ȥ����Ϥ��줿�Ȥ���, �᥽�å�((|ali|))���Ƥ�
+      �줿�Ȥ��ˤ�, ((|accessor|))���Ф�((|method|))��ƤӽФ��ޤ�.
+
+--- Forwardable#def_delegators(accessor, *methods)
+
+      ((|Forwardable#def_instance_delegators|))����̾�Ǥ�.
+
+--- Forwardable#def_delegator(accessor, method, ali = method)
+
+      ((|Forwardable#def_instance_delegator|))����̾�Ǥ�.
+
+= SingleForwardable
+
+���֥������Ȥ��Ф�, �᥽�åɤΰѾ���ǽ��������ޤ�.
+
+== �Ȥ���
+
+���֥������Ȥ��Ф���((|extend|))���ƻȤ��ޤ�. 
+
+  g = Goo.new
+  g.extend SingleForwardable
+  g.def_delegator("@out", :puts)
+  g.puts ...
+
+== �᥽�å�
+
+--- SingleForwardable#def_singleton_delegators(accessor, *methods)
+
+      ((|methods|))���Ϥ��줿�᥽�åɤΥꥹ�Ȥ�((|accessor|))�˰Ѿ�����
+      �褦�ˤ��ޤ�.
+
+--- SingleForwardable#def_singleton_delegator(accessor, method, ali = method)
+
+      ((|method|))���Ϥ��줿�᥽�åɤ�((|accessor|))�˰Ѿ�����褦�ˤ���
+      ��. ((|ali|))�������Ȥ����Ϥ��줿�Ȥ���, �᥽�å�((|ali|))���ƤФ�
+      ���Ȥ��ˤ�, ((|accessor|))���Ф�((|method|))��ƤӽФ��ޤ�.
+
+--- SingleForwardable#def_delegators(accessor, *methods)
+
+      ((|SingleForwardable#def_singleton_delegators|))����̾�Ǥ�.
+
+--- SingleForwardable#def_delegator(accessor, method, ali = method)
+
+      ((|SingleForwardable#def_singleton_delegator|))����̾�Ǥ�.
+=end
diff --git a/doc/irb/irb-tools.rd.jp b/doc/irb/irb-tools.rd.jp
new file mode 100644
index 0000000000..64d9ab29c8
--- /dev/null
+++ b/doc/irb/irb-tools.rd.jp
@@ -0,0 +1,185 @@
+irb��Ϣ���ޤ����ޥ�ɤȥ饤�֥��
+				$Release Version: 0.7.1 $
+			   	$Revision$
+			   	$Date$
+			   	by Keiju ISHITSUKA(Nihon Rational Co.,Ltd.)
+
+=begin
+
+:���ޥ��:
+* rtags		-- ruby tags command
+
+:�ؿ��饤�֥��:
+* xmp		-- irb version of gotoken xmp-function
+
+:���饹�饤�֥��:
+* frame.rb      -- frame tracer
+* completion.rb -- irb completor
+
+= rtags
+
+rtags��emacs�ڤ�vi�Ѥ�, TAG�ե������Ĥ��륳�ޥ�ɤǤ�.
+
+== �Ȥ���
+
+   rtags [-vi] file....
+
+�����ȥǥ��쥯�ȥ��emacs�Ѥ�TAGS�ե����뤬�Ǥ��ޤ�. -vi���ץ�����
+�Ĥ������ˤ�vi�Ѥ�tags�ե������������ޤ�.
+
+emacs�ξ��, �̾��etags.el�����Τޤ޻Ȥ��ޤ�. ������ǽ�ʤΤ�,
+
+* ���饹
+* �᥽�å�
+* �ðۥ᥽�å�
+* alias
+* attr��������줿��������(�ѥ�᡼��������ܥ뤫ʸ�����ƥ��˸¤�)
+* attr_XXX��������줿��������(�ѥ�᡼��������ܥ뤫ʸ�����ƥ��˸¤�)
+
+�Ǥ�.
+
+C�ʤɤǻȤäƤ���ΤȰ㤦�Τ�, ����ץ꡼�����˴ؤ�����ʬ��,
+
+�ؿ�̾��,
+
+  �ؿ�̾(
+
+���饹��,
+
+  ::���饹̾::....::���饹̾
+
+�᥽�åɤ�,
+
+  ::���饹̾::....::���饹̾#�᥽�å�̾
+
+�ðۥ᥽�å�(���饹�᥽�å�)��
+
+  ::���饹̾::....::���饹̾.�᥽�å�̾
+
+�ǥ���ץ꡼������Ԥʤ��Ȥ����Ǥ�.
+
+= xmp.rb
+
+���Ȥ���xmp�ξ�̸ߴ��С������Ǥ�. ����, ���˽Ť��ΤǤ��Ȥ���xmp��
+���б��Ǥ��ʤ�����, ���Ѥ�����ɤ��Ǥ��礦.
+
+== �Ȥ���
+
+=== �ؿ��Ȥ��ƻȤ�.
+
+    require "irb/xmp"
+    xmp <<END
+    foo = 1
+    foo
+    END
+    ---
+    foo = 1
+        ==>1
+    foo
+	==>1
+
+=== XMP���󥹥��󥹤��Ѥ���.
+
+���ξ���, XMP������ƥ����Ⱦ������ĤΤ�, �ѿ����ͤʤɤ��ݻ����Ƥ�
+�ޤ�.
+
+  require "irb/xmp"
+  xmp = XMP.new
+  xmp.puts <<END
+  foo = 1
+  foo
+  END
+  xmp.puts <<END
+  foo
+  END
+  ===
+  foo = 1
+      ==>1
+  foo
+      ==>1
+  foo
+      ==>1
+
+== ����ƥ����Ȥ˴ؤ���
+
+XMP�᥽�åɷ��Υ���ƥ����Ȥ�, �ƤӽФ����Υ���ƥ����Ȥ�ɾ������ޤ�.
+����Ū�˥���ƥ����Ȥ���ꤹ��Ȥ��Υ���ƥ����Ȥ�ɾ�����ޤ�.
+
+��:
+
+  xmp "foo", an_binding
+
+:��:
+�ޥ������åɤˤ��б����Ƥ��ޤ���.
+
+= frame.rb
+���߼¹���Υե졼�������갷������Υ��饹�Ǥ�. 
+
+* IRB::Frame.top(n = 0)
+  �夫��n���ܤΥ���ƥ����Ȥ���Ф��ޤ�. n��0���Ǿ�̤ˤʤ�ޤ�.
+* IRB::Frame.bottom(n = 0)
+  ������n���ܤΥ���ƥ����Ȥ���Ф��ޤ�. n��0���ǲ��̤ˤʤ�ޤ�.
+* IRB::Frame.sender
+  ������ˤʤäƤ��륪�֥������Ȥ���Ф��ޤ�. ������Ȥ�, ���Υ᥽��
+  �ɤ�ƤӽФ���¦��self�Τ��ȤǤ�.
+
+:��:
+set_trace_func���Ѥ���Ruby�μ¹Ԥ�ȥ졼�����Ƥ��ޤ�. �ޥ������åɤ�
+���б����Ƥ��ޤ���.
+
+= completion.rb
+irb��completion��ǽ���󶡤����ΤǤ�. 
+
+== �Ȥ���
+
+   % irb -r irb/completion
+
+�Ȥ��뤫, ~/.irbrc ���
+
+   require "irb/completion"
+
+������Ƥ�������. irb�¹���� require "irb/completion" ���Ƥ�褤�Ǥ�.
+
+irb�¹���� (TAB) �򲡤��ȥ���ץ졼����󤷤ޤ�.
+
+�ȥåץ�٥��(TAB)�򲡤��Ȥ��٤Ƥι�ʸ����, ���饹, �᥽�åɤθ��䤬��
+�ޤ�. ���䤬ͣ��ʤ�д������䴰���ޤ�.
+
+  irb(main):001:0> in    
+  in                    inspect               instance_eval
+  include               install_alias_method  instance_of?
+  initialize            install_aliases       instance_variables
+  irb(main):001:0> inspect
+  "main"
+  irb(main):002:0> foo = Object.new
+  #<Object:0x4027146c>
+
+  ((|�ѿ�̾.|))�θ��(TAB)�򲡤���, ���Υ��֥������ȤΥ᥽�åɰ������Ǥ�
+  ��.
+
+  irb(main):003:0> foo.
+  foo.==                  foo.frozen?             foo.protected_methods
+  foo.===                 foo.hash                foo.public_methods
+  foo.=~                  foo.id                  foo.respond_to?
+  foo.__id__              foo.inspect             foo.send
+  foo.__send__            foo.instance_eval       foo.singleton_methods
+  foo.class               foo.instance_of?        foo.taint
+  foo.clone               foo.instance_variables  foo.tainted?
+  foo.display             foo.is_a?               foo.to_a
+  foo.dup                 foo.kind_of?            foo.to_s
+  foo.eql?                foo.method              foo.type
+  foo.equal?              foo.methods             foo.untaint
+  foo.extend              foo.nil?                
+  foo.freeze              foo.private_methods     
+
+=end
+
+% Begin Emacs Environment
+% Local Variables:
+% mode: text
+% comment-column: 0
+% comment-start: "%"
+% comment-end: "\n"
+% End:
+%
+
diff --git a/doc/irb/irb.rd b/doc/irb/irb.rd
new file mode 100644
index 0000000000..a1daa1ed6b
--- /dev/null
+++ b/doc/irb/irb.rd
@@ -0,0 +1,377 @@
+irb -- interactive ruby
+				$Release Version: 0.5 $
+			   	$Revision$
+			   	$Date$
+			   	by Keiju ISHITSUKA(keiju@ishitsuka.com)
+				translate from japanese by gotoken-san
+
+=begin
+= What is irb?
+
+irb stands for `interactive ruby'. irb is a tool to execute interactively
+ruby expressions read from stdin. 
+
+= Invoking
+
+  % ruby -r irb -e0
+  % irb
+
+Either of the aboves. In the former style, options can be specified
+as follows:
+
+  % ruby -r irb -e0 -- -v
+
+= Usage
+
+Use of irb is easy if you know ruby.  Executing irb, prompts are 
+displayed as follows. Then, enter expression of ruby. A input is
+executed when it is syntacticaly completed. 
+
+  dim% irb
+  irb(main):001:0> 1+2
+  3
+  irb(main):002:0> class Foo
+  irb(main):003:1>  def foo
+  irb(main):004:2>    print 1
+  irb(main):005:2>  end
+  irb(main):006:1> end
+  nil
+  irb(main):007:0> 
+
+And, Readline extesion module can be used with irb. Using Readline
+is the standard default action if Readline is installed. 
+
+= Command line option
+
+  irb.rb [options] file_name opts
+  options:
+  -f		    suppress read ~/.irbrc 
+  -m		    bc mode (fraction or matrix are available)
+  -d                set $DEBUG  to true (same as `ruby -d')
+  -r load-module    same as `ruby -r'
+  --inspect	    uses `inspect' for output (the default except bc mode)
+  --noinspect	    doesn't uses inspect for output
+  --readline	    uses Readline extension module
+  --noreadline	    doesn't use Readline extension module
+  --prompt prompt-mode
+  --prompt-mode prompt-mode
+		    switches prompt mode. Pre-defined prompt modes are
+		    `default', `simple', `xmp' and `inf-ruby'
+			    
+  --inf-ruby-mode   uses prompt appreciate for inf-ruby-mode on emacs. 
+		    Suppresses --readline. 
+  --simple-prompt   simple prompt mode
+  --noprompt	    no prompt
+  --tracer	    display trace for each execution of commands.
+  --back-trace-limit n
+		    displayes backtrace top n and tail n. The default
+		    value is 16. 
+  --irb_debug n	    sets internal debug level to n (It shouldn't be used)
+  -v, --version	    prints the version of irb
+
+
+
+= Configurations
+
+irb reads `~/.irbrc' when it is invoked. If `~/.irbrb' doesn't exist
+irb try to read in the order `.irbrc', `irb.rc', `_irbrc' then `$irbrc'. 
+
+The following is altanative to the command line option. To use them
+type as follows in an irb session. 
+
+  IRB.conf[:IRB_NAME]="irb"
+  IRB.conf[:MATH_MODE]=false
+  IRB.conf[:USE_TRACER]=false
+  IRB.conf[:USE_LOADER]=false
+  IRB.conf[:IGNORE_SIGINT]=true
+  IRB.conf[:IGNORE_EOF]=false
+  IRB.conf[:INSPECT_MODE]=nil
+  IRB.conf[:IRB_RC] = nil
+  IRB.conf[:BACK_TRACE_LIMIT]=16
+  IRB.conf[:USE_LOADER] = false
+  IRB.conf[:USE_READLINE] = nil
+  IRB.conf[:USE_TRACER] = false
+  IRB.conf[:IGNORE_SIGINT] = true
+  IRB.conf[:IGNORE_EOF] = false
+  IRB.conf[:PROMPT_MODE] = :DEFALUT
+  IRB.conf[:PROMPT] = {...}
+  IRB.conf[:DEBUG_LEVEL]=0
+  IRB.conf[:VERBOSE]=true
+
+== Customizing prompt
+
+To costomize the prompt you set a variable
+
+  IRB.conf[:PROMPT]
+
+For example, describe as follows in `.irbrc'. 
+
+  IRB.conf[:PROMPT][:MY_PROMPT] = { # name of prompt mode
+    :PROMPT_I => nil,		  # normal prompt
+    :PROMPT_S => nil,		  # prompt for continuated strings
+    :PROMPT_C => nil,		  # prompt for continuated statement
+    :RETURN => "    ==>%s\n"	  # format to return value
+  }
+
+Then, invoke irb with the above prompt mode by
+
+  % irb --prompt my-prompt
+
+Or add the following in `.irbrc'. 
+
+  IRB.conf[:PROMPT_MODE] = :MY_PROMPT
+
+Constants PROMPT_I, PROMPT_S and PROMPT_C specifies the format. 
+In the prompt specification, some special strings are available. 
+
+  %N	command name which is running
+  %m	to_s of main object (self)
+  %M	inspect of main object (self)
+  %l	type of string(", ', /, ]), `]' is inner %w[...]
+  %NNi	indent level. NN is degits and means as same as printf("%NNd"). 
+        It can be ommited
+  %NNn	line number. 
+  %%    %
+
+For instance, the default prompt mode is defined as follows:
+
+IRB.conf[:PROMPT_MODE][:DEFAULT] = {
+      :PROMPT_I => "%N(%m):%03n:%i> ",
+      :PROMPT_S => "%N(%m):%03n:%i%l ",
+      :PROMPT_C => "%N(%m):%03n:%i* ",
+      :RETURN => "%s\n"
+} 
+
+RETURN is used to printf. 
+
+== Configurating subirb
+
+The command line option or IRB.conf specify the default behavior of
+(sub)irb. On the other hand, each conf of in the next sction `6. Command' 
+is used to individually configurate (sub)irb. 
+
+If proc is set to IRB.conf[:IRB_RC], its subirb will be invoked after
+execution of that proc under giving the context of irb as its
+aregument. By this mechanism each subirb can be configurated. 
+
+= Command
+
+For irb commands, both simple name and `irb_'-prefixed name are prepared. 
+
+--- exit, quit, irb_exit	
+    Quits (sub)irb. 
+    if you've done cb (see below), exit from the binding mode.
+
+--- conf, irb_context
+    Displays current configuration. Modifing the configuration is
+    achieved by sending message to `conf'. 
+
+--- conf.back_trace_limit
+    Sets display lines of backtrace as top n and tail n. 
+    The default value is 16.
+    
+--- conf.debug_level = N
+    Sets debug level of irb. 
+
+--- conf.ignore_eof = true/false
+    Whether ^D (control-d) will be ignored or not. 
+    If false is set, ^D means quit. 
+
+--- conf.ignore_sigint= true/false
+    Whether ^C (control-c) will be ignored or not. 
+    If false is set, ^D means quit.  If true, 
+      during input:   cancel inputing then return to top level. 
+      during execute: abondon current execution. 
+
+--- conf.inf_ruby_mode = true/false
+    Whether inf-ruby-mode or not. The default value is false.
+
+--- conf.inspect_mode = true/false/nil
+    Specifies inspect mode. 
+    true:  display inspect
+    false: display to_s
+    nil:   inspect mode in non math mode, 
+           non inspect mode in math mode. 
+
+--- conf.irb_level
+    The level of cb. 
+
+--- conf.math_mode
+    Whether bc mode or not. 
+
+--- conf.use_loader = true/false
+    Whether irb's own file reader method is used when load/require or not. 
+    This mode is globaly affected (irb wide). 
+
+--- conf.prompt_c
+    prompt for a continuating statement (e.g, immediately after of `if')
+
+--- conf.prompt_i
+    standard prompt
+
+--- conf.prompt_s
+    prompt for a continuating string
+
+--- conf.rc
+    Whether ~/.irbrc is read or not. 
+
+--- conf.use_prompt = true/false
+    Prompting or not. 
+
+--- conf.use_readline = true/false/nil
+    Whether readline is used or not. 
+    true: uses 
+    false: doen't use
+    nil: intends to use readline except for inf-reuby-mode (default)
+
+--- conf.verbose=T/F
+    Whether verbose messages are display or not. 
+
+--- cb, irb_change_binding [obj]
+    Enter new binding which has a distinct scope of local variables. 
+    If obj is given, obj will be self. 
+
+--- irb [obj]
+    Invoke subirb. If obj is given, obj will be self. 
+
+--- jobs, irb_jobs
+    List of subirb
+
+--- fg n, irb_fg n
+    Switch into specified subirb. The following is candidates of n:
+
+      irb number
+      thhread
+      irb object
+      self(obj which is specified of irb obj)
+
+--- kill n, irb_kill n
+    Kill subirb. The means of n is as same as the case of irb_fg. 
+
+= System variable
+
+   _  The latest value of evaluation (it is local)
+
+
+= Session Example
+
+  dim% ruby irb.rb
+  irb(main):001:0> irb                        # invoke subirb
+  irb#1(main):001:0> jobs                     # list of subirbs
+  #0->irb on main (#<Thread:0x400fb7e4> : stop)
+  #1->irb#1 on main (#<Thread:0x40125d64> : running)
+  nil
+  irb#1(main):002:0> fg 0                     # switch job
+  nil
+  irb(main):002:0> class Foo;end
+  nil
+  irb(main):003:0> irb Foo                    # invoke subirb which has the 
+					      #              context of Foo
+  irb#2(Foo):001:0> def foo                   # define Foo#foo
+  irb#2(Foo):002:1>   print 1
+  irb#2(Foo):003:1> end
+  nil
+  irb#2(Foo):004:0> fg 0                      # switch job
+  nil
+  irb(main):004:0> jobs                       # list of job
+  #0->irb on main (#<Thread:0x400fb7e4> : running)
+  #1->irb#1 on main (#<Thread:0x40125d64> : stop)
+  #2->irb#2 on Foo (#<Thread:0x4011d54c> : stop)
+  nil
+  irb(main):005:0> Foo.instance_methods       # Foo#foo is defined asurely
+  ["foo"]
+  irb(main):006:0> fg 2                       # switch job
+  nil
+  irb#2(Foo):005:0> def bar                   # define Foo#bar
+  irb#2(Foo):006:1>  print "bar"
+  irb#2(Foo):007:1> end
+  nil
+  irb#2(Foo):010:0>  Foo.instance_methods
+  ["bar", "foo"]
+  irb#2(Foo):011:0> fg 0                      
+  nil
+  irb(main):007:0> f = Foo.new
+  #<Foo:0x4010af3c>
+  irb(main):008:0> irb f                      # invoke subirb which has the
+					      #  context of f (instance of Foo)
+  irb#3(#<Foo:0x4010af3c>):001:0> jobs
+  #0->irb on main (#<Thread:0x400fb7e4> : stop)
+  #1->irb#1 on main (#<Thread:0x40125d64> : stop)
+  #2->irb#2 on Foo (#<Thread:0x4011d54c> : stop)
+  #3->irb#3 on #<Foo:0x4010af3c> (#<Thread:0x4010a1e0> : running)
+  nil
+  irb#3(#<Foo:0x4010af3c>):002:0> foo         # evaluate f.foo
+  1nil
+  irb#3(#<Foo:0x4010af3c>):003:0> bar         # evaluate f.bar
+  barnil
+  irb#3(#<Foo:0x4010af3c>):004:0> kill 1, 2, 3# kill job
+  nil
+  irb(main):009:0> jobs
+  #0->irb on main (#<Thread:0x400fb7e4> : running)
+  nil
+  irb(main):010:0> exit                       # exit
+  dim% 
+
+= Restrictions
+
+Because irb evaluates the inputs immediately after the imput is
+syntactically completed, irb gives slight different result than
+directly use ruby. Known difference is pointed out here. 
+
+
+== Declaration of the local variable
+
+The following causes an error in ruby:
+
+  eval "foo = 0"
+  foo
+  --
+  -:2: undefined local variable or method `foo' for #<Object:0x40283118> (NameError)
+  ---
+  NameError
+
+Though, the above will successfully done by irb. 
+
+  >> eval "foo = 0"
+ => 0
+ >> foo
+ => 0
+
+Ruby evaluates a code after reading entire of code and determination
+of the scope of local variables. On the other hand, irb do
+immediately. More precisely, irb evaluate at first
+
+  evel "foo = 0" 
+
+then foo is defined on this timing. It is because of this
+incompatibility.
+
+If you'd like to detect those differences, begin...end can be used:
+
+  >> begin
+  ?>   eval "foo = 0"
+  >>   foo
+  >> end
+  NameError: undefined local variable or method `foo' for #<Object:0x4013d0f0>
+  (irb):3
+  (irb_local_binding):1:in `eval'
+
+== Here-document
+
+Implementation of Here-document is incomplete. 
+
+== Symbol
+
+Irb can not always recognize a symbol as to be Symbol. Concretely, an
+expression have completed, however Irb regard it as continuation line.
+
+=end
+
+% Begin Emacs Environment
+% Local Variables:
+% mode: text
+% comment-column: 0
+% comment-start: "%"
+% comment-end: "\n"
+% End:
+%
diff --git a/doc/irb/irb.rd.jp b/doc/irb/irb.rd.jp
new file mode 100644
index 0000000000..5068f4536f
--- /dev/null
+++ b/doc/irb/irb.rd.jp
@@ -0,0 +1,391 @@
+irb -- interactive ruby
+				$Release Version: 0.6 $
+			   	$Revision$
+			   	$Date$
+			   	by Keiju ISHITSUKA(keiju@ishitsuka.com)
+=begin
+= irb�Ȥ�?
+
+irb��interactive ruby��ά�Ǥ�. ruby�μ���ɸ�����Ϥ����ñ������/�¹Ԥ�
+�뤿��Υġ���Ǥ�.
+
+= ��ư
+
+  % ruby -r irb -e0
+  % irb
+
+�Τ����줫�ǹԤʤ��ޤ�. ���Ԥξ��irb�ؤΥ��ץ��������, �ʲ��Τ褦��
+�ʤ�ޤ�.
+
+  % ruby -r irb -e0 -- -v
+
+= �Ȥ���
+
+irb�λȤ�����, Ruby�����ΤäƤ���Ф����äƴ�ñ�Ǥ�. ����Ū�ˤ� irb ��
+�������ޥ�ɤ�¹Ԥ�������Ǥ�. irb��¹Ԥ����, �ʲ��Τ褦�ʥץ����
+�Ȥ�ɽ��Ƥ��ޤ�. ���, ruby�μ�������Ʋ�����. �������뤷�������Ǽ¹�
+����ޤ�.
+
+  dim% irb
+  irb(main):001:0> 1+2
+  3
+  irb(main):002:0> class Foo
+  irb(main):003:1>  def foo
+  irb(main):004:2>    print 1
+  irb(main):005:2>  end
+  irb(main):006:1> end
+  nil
+  irb(main):007:0> 
+
+�ޤ�, irb��Readline�⥸�塼��ˤ��б����Ƥ��ޤ�. Readline�⥸�塼�뤬
+���󥹥ȡ��뤵��Ƥ�����ˤ�, �����Ȥ��Τ�ɸ���ư��ˤʤ�ޤ�.
+
+= ���ޥ�ɥ��ץ����
+
+  irb.rb [options] file_name opts
+  options:
+  -f		    ~/.irbrc ���ɤ߹��ޤʤ�.
+  -m		    bc�⡼��(ʬ��, ����η׻����Ǥ���)
+  -d                $DEBUG ��true�ˤ���(ruby -d ��Ʊ��)
+  -r load-module    ruby -r ��Ʊ��.
+  --inspect	    ��̽��Ϥ�inspect���Ѥ���(bc�⡼�ɰʳ��ϥǥե����). 
+  --noinspect	    ��̽��Ϥ�inspect���Ѥ��ʤ�.
+  --readline	    readline�饤�֥������Ѥ���.
+  --noreadline	    readline�饤�֥������Ѥ��ʤ�. �ǥե���Ȥ�ư���,
+		    inf-reuby-mode�ʳ���readline�饤�֥������Ѥ��褦
+		    �Ȥ���. 
+  --prompt prompt-mode
+  --prompt-mode prompt-mode
+		    �ץ���ץȥ⡼�ɤ����ؤ��ޤ�. �����������Ƥ����
+		    ����ץȥ⡼�ɤ�, default, simple, xmp, inf-ruby��
+		    �Ѱդ���Ƥ��ޤ�. �ǥե���Ȥ�default�ץ���ץȥ⡼
+		    �ɤˤʤäƤ��ޤ�.
+			    
+  --inf-ruby-mode   emacs��inf-ruby-mode�ѤΥץ���ץ�ɽ����Ԥʤ�. ��
+		    �˻��꤬�ʤ��¤�, readline�饤�֥��ϻȤ�ʤ��ʤ�.
+  --simple-prompt
+		    ���˥���ץ�ʥץ���ץȤ��Ѥ���⡼�ɤǤ�.
+  --noprompt	    �ץ���ץ�ɽ����Ԥʤ�ʤ�.
+  --tracer	    ���ޥ�ɼ¹Ի��˥ȥ졼����Ԥʤ�.
+  --back-trace-limit n
+		    �Хå��ȥ졼��ɽ����Хå��ȥ졼����Ƭ���� n, ���
+		    ����n�����Ԥʤ�. �ǥե���Ȥ�16 
+  --irb_debug n	    irb�ΥǥХå��ǥХå���٥��n�����ꤹ��(���Ѥ���
+		    ������̵��Ǥ��礦).
+  -v, --version	    irb�ΥС�������ɽ������
+
+= ����ե�����졼�����
+
+irb��ư����``~/.irbrc''���ɤ߹��ߤޤ�. �⤷¸�ߤ��ʤ�����,
+``.irbrc'', ``irb.rc'', ``_irbrc'', ``$irbrc''�ν��load���ߤޤ�.
+
+���ץ��������ꤹ�������, �ʲ��Υ��ޥ�ɤǤ�ǥե���Ȥ�ư�������
+�Ǥ��ޤ�.
+
+  IRB.conf[:IRB_NAME]="irb"
+  IRB.conf[:MATH_MODE]=false
+  IRB.conf[:USE_TRACER]=false
+  IRB.conf[:USE_LOADER]=false
+  IRB.conf[:IGNORE_SIGINT]=true
+  IRB.conf[:IGNORE_EOF]=false
+  IRB.conf[:INSPECT_MODE]=nil
+  IRB.conf[:IRB_RC] = nil
+  IRB.conf[:BACK_TRACE_LIMIT]=16
+  IRB.conf[:USE_LOADER] = false
+  IRB.conf[:USE_READLINE] = nil
+  IRB.conf[:USE_TRACER] = false
+  IRB.conf[:IGNORE_SIGINT] = true
+  IRB.conf[:IGNORE_EOF] = false
+  IRB.conf[:PROMPT_MODE] = :DEFALUT
+  IRB.conf[:PROMPT] = {...}
+  IRB.conf[:DEBUG_LEVEL]=0
+  IRB.conf[:VERBOSE]=true
+
+== �ץ���ץȤ�����
+
+�ץ���ץȤ򥫥����ޥ������������ˤ�, 
+
+   IRB.conf[:PROMPT]
+
+���Ѥ��ޤ�. �㤨��, .irbrc����ǲ��Τ褦�ʼ��򵭽Ҥ��ޤ�:
+
+   IRB.conf[:PROMPT][:MY_PROMPT] = { # �ץ���ץȥ⡼�ɤ�̾��
+     :PROMPT_I => nil,		  # �̾�Υץ���ץ�
+     :PROMPT_S => nil,		  # ʸ����ʤɤη�³�ԤΥץ���ץ�
+     :PROMPT_C => nil,		  # ������³���Ƥ�����Υץ���ץ�
+     :RETURN => "    ==>%s\n"	  # �꥿������Υץ���ץ�
+   }
+
+�ץ���ץȥ⡼�ɤ���ꤷ�������ˤ�,
+
+  irb --prompt my-prompt
+
+�Ǥ��Υץ���ץȥ⡼�ɤǵ�ư����ޤ�. �ޤ���, .irbrc�˲����򵭽Ҥ��Ƥ�
+OK�Ǥ�.
+
+  IRB.conf[:PROMPT_MODE] = :MY_PROMPT
+
+PROMPT_I, PROMPT_S, PROMPT_C��, �ե����ޥåȤ���ꤷ�ޤ�.
+
+  %N	��ư���Ƥ��륳�ޥ��̾�����Ϥ����.
+  %m	main���֥�������(self)��to_s�ǽ��Ϥ����.
+  %M	main���֥�������(self)��inspect����ƽ��Ϥ����.
+  %l	ʸ������Υ����פ�ɽ��(", ', /, ], `]'��%w����λ�)
+  %NNi	����ǥ�ȤΥ�٥��ɽ��. NN�Ͽ���������printf��%NNd��Ʊ��. ��
+	ά��ǽ
+  %NNn	���ֹ��ɽ���ޤ�.
+  %%    %
+
+�㤨��, �ǥե���ȤΥץ���ץȥ⡼�ɤ�:
+
+  IRB.conf[:PROMPT_MODE][:DEFAULT] = {
+      :PROMPT_I => "%N(%m):%03n:%i> ",
+      :PROMPT_S => "%N(%m):%03n:%i%l ",
+      :PROMPT_C => "%N(%m):%03n:%i* ",
+      :RETURN => "%s\n"
+  } 
+
+�ȤʤäƤ��ޤ�.
+
+RETURN��, ���ߤΤȤ���printf�����Ǥ�. ������ͤ��Ѥ�뤫���Τ�ޤ���.
+
+== ����irb������
+
+���ޥ�ɥ饤�󥪥ץ���󤪤��IRB.conf��(����)irb��ư���Υǥե���Ȥ�
+���������Τ�, `5. ���ޥ��'�ˤ���conf�Ǹ��̤�(����)irb�����꤬��
+����褦�ˤʤäƤ��ޤ�.
+
+IRB.conf[:IRB_RC]��proc�����ꤵ��Ƥ����, ����irb��ư������ˤ���
+proc��irb�Υ���ƥ����Ȥ�����Ȥ��ƸƤӽФ��ޤ�. ����ˤ�äƸ��̤Υ�
+��irb���Ȥ�������Ѥ��뤳�Ȥ��Ǥ���褦�ˤʤ�ޤ�.
+
+
+= ���ޥ��
+
+irb��ĥ���ޥ�ɤ�, ��ñ��̾����Ƭ��`irb_'��Ĥ���̾����ξ����������
+���ޤ�. �����, ��ñ��̾����override���줿���Τ���Ǥ�.
+
+--- exit, quit, irb_exit	
+    ��λ����. 
+    ����irb�ξ��, ���Υ���irb��λ����.
+    cb���Ƥ�����, ���ΥХ���ǥ��󥰤Υ⡼�ɤ�λ����.
+
+--- conf, irb_context
+    irb�θ��ߤ������ɽ������. ������ѹ���, conf�˥�å����������뤳
+    �Ȥˤ�äƹԤʤ���. 
+
+--- conf.back_trace_limit
+    �Хå��ȥ졼��ɽ����Хå��ȥ졼����Ƭ����n, �������n�����Ԥʤ�.
+    �ǥե���Ȥ�16
+    
+--- conf.debug_level = N
+    irb�ѤΥǥХå���٥������
+
+--- conf.ignore_eof = true/false
+    ^D�����Ϥ��줿����ư������ꤹ��. true�λ���^D��̵�뤹��, false��
+    ����irb��λ����. 
+
+--- conf.ignore_sigint= true/false
+    ^C�����Ϥ��줿����ư������ꤹ��. false����, irb��λ����. true��
+    ����ư��ϰʲ��Τ褦�ˤʤ�:
+      ������: ����ޤ����Ϥ�����Τ򥭥�󥻥뤷�ȥåץ�٥�����. 
+      �¹���: �¹Ԥ���ߤ���.
+
+--- conf.inf_ruby_mode = true/false
+    inf-ruby-mode�ѤΥץ���ץ�ɽ����Ԥʤ�. �ǥե���Ȥ�false.
+
+--- conf.inspect_mode = true/false/nil
+    ���󥹥ڥ��ȥ⡼�ɤ����ꤹ��.
+    true: ���󥹥ڥ��Ȥ���ɽ������.
+    false: �̾��print��ɽ������.
+    nil: �̾�⡼�ɤǤ����, inspect mode�Ȥʤ�, math�⡼�ɤλ���, non
+	 inspect mode�Ȥʤ�.   
+
+--- conf.irb_level
+    ���ȤΤ�. irb������cb���Ƥ��뤫?
+
+--- conf.math_mode
+    ���ȤΤ�. bc�⡼��(ʬ��, ����η׻����Ǥ��ޤ�)���ɤ���?
+
+--- conf.use_loader = true/false
+    load/require����irb��file�ɤ߹��ߵ�ǽ���Ѥ���⡼�ɤΥ����å�(�ǥե�
+    ��Ȥ��Ѥ��ʤ�). ���Υ⡼�ɤ�IRB���Τ�ȿ�Ǥ����.
+
+--- conf.prompt_c
+    if��ľ��ʤ�, �Ԥ���³���Ƥ�����Υץ���ץ�.
+
+--- conf.prompt_i
+    �̾�Υץ���ץ�.
+
+--- conf.prompt_s
+    ʸ������ʤɤ�ɽ���ץ���ץ�.
+
+--- conf.rc
+    ~/.irbrc���ɤ߹�������ɤ���?
+
+--- conf.use_prompt = true/false
+    �ץ���ץ�ɽ�����뤫�ɤ���? �ǥե���ȤǤϥץ���ץȤ�ɽ������.
+
+--- conf.use_readline = true/false/nil
+    readline��Ȥ����ɤ���?
+    true: readline��Ȥ�.
+    false: readline��Ȥ�ʤ�.
+    nil: (�ǥե����)inf-reuby-mode�ʳ���readline�饤�֥������Ѥ���
+         ���Ȥ���.  
+
+--- conf.verbose=T/F
+    irb���餤�������ʥ�å���������Ϥ��뤫?
+
+--- cb, irb_change_binding [obj]
+    ���������ѿ��Υ������פ��㤦������binding�˰ܤ�.  obj�����ꤵ�줿
+    ����, ����obj��self�Ȥ���. 
+
+--- irb [obj]
+    ����irb��Ω��������. obj�����ꤵ�줿����, ����obj��self�Ȥ���.
+
+--- jobs, irb_jobs
+    ����irb�Υꥹ��
+
+--- fg n, irb_fg n
+    ���ꤷ������irb�˥����å�����. n��, ���Τ�Τ���ꤹ��.
+
+      irb�ֹ�
+      ����å�
+      irb���֥�������
+      self(irb obj�ǵ�ư��������obj)
+
+--- kill n, irb_kill n
+      ����irb��kill����. n��fg��Ʊ��.
+
+
+= �����ƥ��ѿ�
+
+   _  ���η׻��μ¹Է�̤�Ф��Ƥ���(���������ѿ�).
+
+=  ������
+
+�ʲ��Τ褦�ʴ����Ǥ�.
+
+  dim% ruby irb.rb
+  irb(main):001:0> irb                        # ����irb��Ω������
+  irb#1(main):001:0> jobs                     # ����irb�Υꥹ��
+  #0->irb on main (#<Thread:0x400fb7e4> : stop)
+  #1->irb#1 on main (#<Thread:0x40125d64> : running)
+  nil
+  irb#1(main):002:0> fg 0                     # job�Υ����å�
+  nil
+  irb(main):002:0> class Foo;end
+  nil
+  irb(main):003:0> irb Foo                    # Foo�򥳥�ƥ����Ȥ���irb
+					      # Ω������
+  irb#2(Foo):001:0> def foo                   # Foo#foo�����
+  irb#2(Foo):002:1>   print 1
+  irb#2(Foo):003:1> end
+  nil
+  irb#2(Foo):004:0> fg 0                      # job�򥹥��å�
+  nil
+  irb(main):004:0> jobs                       # job�Υꥹ��
+  #0->irb on main (#<Thread:0x400fb7e4> : running)
+  #1->irb#1 on main (#<Thread:0x40125d64> : stop)
+  #2->irb#2 on Foo (#<Thread:0x4011d54c> : stop)
+  nil
+  irb(main):005:0> Foo.instance_methods       # Foo#foo�������������
+					      # ��Ƥ���
+  ["foo"]
+  irb(main):006:0> fg 2                       # job�򥹥��å�
+  nil
+  irb#2(Foo):005:0> def bar                   # Foo#bar�����
+  irb#2(Foo):006:1>  print "bar"
+  irb#2(Foo):007:1> end
+  nil
+  irb#2(Foo):010:0>  Foo.instance_methods
+  ["bar", "foo"]
+  irb#2(Foo):011:0> fg 0                      
+  nil
+  irb(main):007:0> f = Foo.new
+  #<Foo:0x4010af3c>
+  irb(main):008:0> irb f                      # Foo�Υ��󥹥��󥹤�irb��
+					      # Ω��������.
+  irb#3(#<Foo:0x4010af3c>):001:0> jobs
+  #0->irb on main (#<Thread:0x400fb7e4> : stop)
+  #1->irb#1 on main (#<Thread:0x40125d64> : stop)
+  #2->irb#2 on Foo (#<Thread:0x4011d54c> : stop)
+  #3->irb#3 on #<Foo:0x4010af3c> (#<Thread:0x4010a1e0> : running)
+  nil
+  irb#3(#<Foo:0x4010af3c>):002:0> foo         # f.foo�μ¹�
+  nil
+  irb#3(#<Foo:0x4010af3c>):003:0> bar         # f.bar�μ¹�
+  barnil
+  irb#3(#<Foo:0x4010af3c>):004:0> kill 1, 2, 3# job��kill
+  nil
+  irb(main):009:0> jobs
+  #0->irb on main (#<Thread:0x400fb7e4> : running)
+  nil
+  irb(main):010:0> exit                       # ��λ
+  dim% 
+
+= ���Ѿ������
+
+irb��, ɾ���Ǥ������(�����Ĥ�������)�Ǥ��༡�¹Ԥ�Ԥʤ��ޤ�. ��������
+��, ruby��ľ�ܻȤä�����, �㴳�ۤʤ�ư���Ԥʤ���礬����ޤ�.
+
+�������餫�ˤʤäƤ������������������ޤ�.
+
+== ���������ѿ������
+
+ruby�Ǥ�, �ʲ��Υץ������ϥ��顼�ˤʤ�ޤ�.
+
+  eval "foo = 0"
+  foo
+  --
+  -:2: undefined local variable or method `foo' for #<Object:0x40283118> (NameError)
+  ---
+  NameError
+
+�Ȥ�����, irb���Ѥ����
+
+  >> eval "foo = 0"
+  => 0
+  >> foo
+  => 0
+
+�Ȥʤ�, ���顼�򵯤����ޤ���. �����, ruby���ǽ�˥�����ץ����Τ򥳥�
+�ѥ��뤷�ƥ��������ѿ�����ꤹ�뤫��Ǥ�. ������Ф�, irb�ϼ¹Բ�ǽ��
+�ʤ�(�����Ĥ���)�ȼ�ưŪ��ɾ�����Ƥ��뤫��Ǥ�. �嵭����Ǥ�, 
+
+  evel "foo = 0" 
+
+��Ԥʤä�������ɾ����Ԥʤ�, ���λ������ѿ����������뤿��, ������ 
+�ѿ�foo���������Ƥ��뤫��Ǥ�.
+
+���Τ褦��ruby��irb��ư��ΰ㤤���褷��������, begin...end�ǳ�ä�
+�Хå�Ū�˼¹Ԥ��Ʋ�����:
+
+  >> begin
+  ?>   eval "foo = 0"
+  >>   foo
+  >> end
+  NameError: undefined local variable or method `foo' for #<Object:0x4013d0f0>
+  (irb):3
+  (irb_local_binding):1:in `eval'
+
+== �ҥ��ɥ������
+
+���ߤΤȤ����ҥ��ɥ�����Ȥμ������Դ����Ǥ�. 
+
+== ����ܥ�
+
+����ܥ�Ǥ��뤫�ɤ�����Ƚ�Ǥ�ְ㤨�뤳�Ȥ�����ޤ�. ����Ū�ˤϼ�����λ
+���Ƥ���Τ˷�³�Ԥȸ��ʤ����Ȥ�����ޤ�.
+
+=end
+
+% Begin Emacs Environment
+% Local Variables:
+% mode: text
+% comment-column: 0
+% comment-start: "%"
+% comment-end: "\n"
+% End:
+%
+
diff --git a/doc/shell.rd b/doc/shell.rd
new file mode 100644
index 0000000000..02ee1b020a
--- /dev/null
+++ b/doc/shell.rd
@@ -0,0 +1,348 @@
+ -- shell.rb
+				$Release Version: 0.6.0 $
+			   	$Revision$
+			   	$Date$
+			   	by Keiju ISHITSUKA(keiju@ishitsuka.com)
+
+=begin
+
+= What's shell.rb?
+
+It realizes a wish to do execution of commands with filters and pipes
+like sh/csh by using just native facilities of ruby.
+
+= Main classes
+
+== Shell
+
+Every shell object has its own current working directory, and executes
+each command as if it stands in the directory.
+
+--- Shell#cwd
+--- Shell#dir
+--- Shell#getwd
+--- Shell#pwd
+
+      Returns the current directory
+
+--- Shell#system_path
+
+      Returns the command search path in an array
+
+--- Shell#umask
+
+      Returns the umask
+
+== Filter
+
+Any result of command exection is a Filter.  Filter include
+Enumerable, therefore a Filter object can use all Enumerable
+facilities.
+
+= Main methods
+
+== Command definitions
+
+In order to execute a command on your OS, you need to define it as a
+Shell method.
+
+Alternatively, you can execute any command via Shell#system even if it
+is not defined.
+
+--- Shell.def_system_command(command, path = command)
+
+      Defines a command.  Registers <path> as a Shell method
+      <command>.
+
+      ex)
+      Shell.def_system_command "ls"
+        Defines ls.
+
+      Shell.def_system_command "sys_sort", "sort"
+        Defines sys_sort as sort.
+
+--- Shell.undef_system_command(command)
+
+      Undefines a commmand
+
+--- Shell.alias_command(ali, command, *opts) {...}
+
+      Aliases a command.
+
+      ex)
+        Shell.alias_command "lsC", "ls", "-CBF", "--show-control-chars"
+        Shell.alias_command("lsC", "ls"){|*opts| ["-CBF", "--show-control-chars", *opts]}
+
+--- Shell.unalias_command(ali)
+
+      Unaliases a command.
+
+--- Shell.install_system_commands(pre = "sys_")
+
+      Defines all commands in the default_system_path as Shell method,
+      all with <pre> prefixed to their names.
+
+== Creation
+
+--- Shell.new
+
+      Creates a Shell object which current directory is set to the
+      process current directory.
+
+--- Shell.cd(path)
+
+      Creates a Shell object which current directory is set to
+      <path>.
+
+== Process management
+
+--- Shell#jobs
+
+      Returns a list of scheduled jobs.
+
+--- Shell#kill sig, job
+
+      Sends a signal <sig> to <job>.
+
+== Current directory operations
+
+--- Shell#cd(path, &block)
+--- Shell#chdir
+
+      Changes the current directory to <path>.  If a block is given,
+      it restores the current directory when the block ends.
+
+--- Shell#pushd(path = nil, &block)
+--- Shell#pushdir
+
+      Pushes the current directory to the directory stack, changing
+      the current directory to <path>.  If <path> is omitted, it
+      exchanges its current directory and the top of its directory
+      stack.  If a block is given, it restores the current directory
+      when the block ends.
+
+--- Shell#popd
+--- Shell#popdir
+
+      Pops a directory from the directory stack, and sets the current
+      directory to it.
+
+== File and directory operations
+
+--- Shell#foreach(path = nil, &block)
+
+      Same as:
+        File#foreach (when path is a file)
+        Dir#foreach (when path is a directory)
+
+--- Shell#open(path, mode)
+
+      Same as:
+        File#open (when path is a file)
+        Dir#open (when path is a directory)
+
+--- Shell#unlink(path)
+
+      Same as:
+        Dir#open (when path is a file)
+        Dir#unlink (when path is a directory)
+
+--- Shell#test(command, file1, file2)
+--- Shell#[command, file1, file2]
+
+      Same as test().
+      ex)
+          sh[?e, "foo"]
+          sh[:e, "foo"]
+          sh["e", "foo"]
+          sh[:exists?, "foo"]
+          sh["exists?", "foo"]
+
+--- Shell#mkdir(*path)
+
+      Same as Dir.mkdir (with multiple directories allowed)
+
+--- Shell#rmdir(*path)
+
+      Same as Dir.rmdir (with multiple directories allowed)
+
+== Command execution
+
+--- System#system(command, *opts)
+
+      Executes <command> with <opts>.
+
+      ex)
+        print sh.system("ls", "-l")
+        sh.system("ls", "-l") | sh.head > STDOUT
+
+--- System#rehash
+
+      Does rehash.
+
+--- Shell#transact &block
+
+      Executes a block as self.
+      ex)
+        sh.transact{system("ls", "-l") | head > STDOUT}
+
+--- Shell#out(dev = STDOUT, &block)
+
+      Does transact, with redirecting the result output to <dev>.
+
+== Internal commands
+
+--- Shell#echo(*strings)
+--- Shell#cat(*files)
+--- Shell#glob(patten)
+--- Shell#tee(file)
+
+      Return Filter objects, which are results of their execution.
+
+--- Filter#each &block
+
+      Iterates a block for each line of it.
+
+--- Filter#<(src)
+
+      Inputs from <src>, which is either a string of a file name or an
+      IO.
+
+--- Filter#>(to)
+
+      Outputs to <to>, which is either a string of a file name or an
+      IO.
+
+--- Filter#>>(to)
+
+      Appends the ouput to <to>, which is either a string of a file
+      name or an IO.
+
+--- Filter#|(filter)
+
+      Processes a pipeline.
+
+--- Filter#+(filter)
+
+      (filter1 + filter2) outputs filter1, and then outputs filter2.
+
+--- Filter#to_a
+--- Filter#to_s
+
+== Built-in commands
+
+--- Shell#atime(file)
+--- Shell#basename(file, *opt)
+--- Shell#chmod(mode, *files)
+--- Shell#chown(owner, group, *file)
+--- Shell#ctime(file)
+--- Shell#delete(*file)
+--- Shell#dirname(file)
+--- Shell#ftype(file)
+--- Shell#join(*file)
+--- Shell#link(file_from, file_to)
+--- Shell#lstat(file)
+--- Shell#mtime(file)
+--- Shell#readlink(file)
+--- Shell#rename(file_from, file_to)
+--- Shell#split(file)
+--- Shell#stat(file)
+--- Shell#symlink(file_from, file_to)
+--- Shell#truncate(file, length)
+--- Shell#utime(atime, mtime, *file)
+
+      Equivalent to the class methods of File with the same names.
+
+--- Shell#blockdev?(file)
+--- Shell#chardev?(file)
+--- Shell#directory?(file)
+--- Shell#executable?(file)
+--- Shell#executable_real?(file)
+--- Shell#exist?(file)/Shell#exists?(file)
+--- Shell#file?(file)
+--- Shell#grpowned?(file)
+--- Shell#owned?(file)
+--- Shell#pipe?(file)
+--- Shell#readable?(file)
+--- Shell#readable_real?(file)
+--- Shell#setgid?(file)
+--- Shell#setuid?(file)
+--- Shell#size(file)/Shell#size?(file)
+--- Shell#socket?(file)
+--- Shell#sticky?(file)
+--- Shell#symlink?(file)
+--- Shell#writable?(file)
+--- Shell#writable_real?(file)
+--- Shell#zero?(file)
+
+      Equivalent to the class methods of FileTest with the same names.
+
+--- Shell#syscopy(filename_from, filename_to)
+--- Shell#copy(filename_from, filename_to)
+--- Shell#move(filename_from, filename_to)
+--- Shell#compare(filename_from, filename_to)
+--- Shell#safe_unlink(*filenames)
+--- Shell#makedirs(*filenames)
+--- Shell#install(filename_from, filename_to, mode)
+
+      Equivalent to the class methods of FileTools with the same
+      names.
+
+      And also, there are some aliases for convenience:
+
+--- Shell#cmp	<- Shell#compare
+--- Shell#mv	<- Shell#move
+--- Shell#cp	<- Shell#copy
+--- Shell#rm_f	<- Shell#safe_unlink
+--- Shell#mkpath	<- Shell#makedirs
+
+= Samples
+
+== ex1
+
+  sh = Shell.cd("/tmp")
+  sh.mkdir "shell-test-1" unless sh.exists?("shell-test-1")
+  sh.cd("shell-test-1")
+  for dir in ["dir1", "dir3", "dir5"]
+    if !sh.exists?(dir)
+      sh.mkdir dir
+      sh.cd(dir) do
+	f = sh.open("tmpFile", "w")
+	f.print "TEST\n"
+	f.close
+      end
+      print sh.pwd
+    end
+  end
+
+== ex2
+
+  sh = Shell.cd("/tmp")
+  sh.transact do
+    mkdir "shell-test-1" unless exists?("shell-test-1")
+    cd("shell-test-1")
+    for dir in ["dir1", "dir3", "dir5"]
+      if !exists?(dir)
+	mkdir dir
+	cd(dir) do
+	  f = open("tmpFile", "w")
+	  f.print "TEST\n"
+	  f.close
+	end
+	print pwd
+      end
+    end
+  end
+
+== ex3
+
+  sh.cat("/etc/printcap") | sh.tee("tee1") > "tee2"
+  (sh.cat < "/etc/printcap") | sh.tee("tee11") > "tee12"
+  sh.cat("/etc/printcap") | sh.tee("tee1") >> "tee2"
+  (sh.cat < "/etc/printcap") | sh.tee("tee11") >> "tee12"
+
+== ex4
+
+  print sh.cat("/etc/passwd").head.collect{|l| l =~ /keiju/}
+
+=end
diff --git a/doc/shell.rd.jp b/doc/shell.rd.jp
new file mode 100644
index 0000000000..073e71ea42
--- /dev/null
+++ b/doc/shell.rd.jp
@@ -0,0 +1,336 @@
+ -- shell.rb
+				$Release Version: 0.6.0 $
+			   	$Revision$
+			   	$Date$
+			   	by Keiju ISHITSUKA(keiju@ishitsuka.com)
+
+=begin
+
+= ��Ū
+
+ruby���sh/csh�Τ褦�˥��ޥ�ɤμ¹Եڤӥե��륿��󥰤��ڤ˹Ԥ�.
+sh/csh������ʸ��ruby�ε�ǽ���Ѥ��Ƽ¸�����.
+
+= ��ʥ��饹����
+
+== Shell
+
+Shell���֥������Ȥϥ����ȥǥ��쥯�ȥ�����, ���ޥ�ɼ¹ԤϤ��������
+���Хѥ��ˤʤ�ޤ�.
+
+--- Shell#cwd
+--- Shell#dir
+--- Shell#getwd
+--- Shell#pwd
+
+      �����ȥǥ��쥯�ȥ���֤���
+
+--- Shell#system_path
+
+      ���ޥ�ɥ������ѥ���������֤���
+
+--- Shell#umask
+
+      umask���֤���
+
+== Filter
+
+���ޥ�ɤμ¹Է�̤Ϥ��٤�Filter�Ȥ��Ƥ�����ޤ�. Enumerable��include��
+�Ƥ��ޤ�.
+
+= ��ʥ᥽�åɰ���
+
+== ���ޥ�����
+
+OS��Υ��ޥ�ɤ�¹Ԥ���ˤϤޤ�, Shell�Υ᥽�åɤȤ���������ޤ�.
+
+��) ���ޥ�ɤ�������ʤ��Ȥ�ľ�ܼ¹ԤǤ���Shell#system���ޥ�ɤ⤢��ޤ�.
+
+--- Shell.def_system_command(command, path = command)
+
+      Shell�Υ᥽�åɤȤ���command����Ͽ���ޤ�. 
+
+      ��)
+      Shell.def_system_command "ls"
+        ls �����
+
+      Shell.def_system_command "sys_sort", "sort"
+        sort���ޥ�ɤ�sys_sort�Ȥ������
+
+--- Shell.undef_system_command(command)
+
+      command�������ޤ�.
+
+--- Shell.alias_command(ali, command, *opts) {...}
+
+      command��alias�򤷤ޤ�. 
+
+      ��)
+        Shell.alias_command "lsC", "ls", "-CBF", "--show-control-chars"
+        Shell.alias_command("lsC", "ls"){|*opts| ["-CBF", "--show-control-chars", *opts]}
+
+--- Shell.unalias_command(ali)
+
+      command��alias�������ޤ�.
+
+--- Shell.install_system_commands(pre = "sys_")
+
+      system_path��ˤ������Ƥμ¹Բ�ǽ�ե������Shell���������. �᥽��
+      ��̾�ϸ��Υե�����̾��Ƭ��pre��Ĥ�����ΤȤʤ�.
+
+== ����
+
+--- Shell.new
+
+      �ץ������Υ����ȥǥ��쥯�ȥ�򥫥��ȥǥ��쥯�ȥ�Ȥ���Shell��
+      �֥������Ȥ��������ޤ�.
+
+--- Shell.cd(path)
+
+      path�򥫥��ȥǥ��쥯�ȥ�Ȥ���Shell���֥������Ȥ��������ޤ�.
+
+== �ץ���������
+
+--- Shell#jobs
+
+      �������塼��󥰤���Ƥ���job�ΰ������֤�.
+
+--- Shell#kill sig, job
+
+      job�˥����ʥ�sig������
+
+== �����ȥǥ��쥯�ȥ����
+
+--- Shell#cd(path, &block)
+--- Shell#chdir
+
+      �����ȥǥ��쥯�ȥ��path�ˤ���. ���ƥ졼���Ȥ��ƸƤФ줿�Ȥ��ˤ�
+      �֥��å��¹���Τߥ����ȥǥ��쥯�ȥ���ѹ�����.
+
+--- Shell#pushd(path = nil, &block)
+--- Shell#pushdir
+
+      �����ȥǥ��쥯�ȥ��ǥ��쥯�ȥꥹ���å��ˤĤ�, �����ȥǥ��쥯
+      �ȥ��path�ˤ���. path����ά���줿�Ȥ��ˤ�, �����ȥǥ��쥯�ȥ��
+      �ǥ��쥯�ȥꥹ���å��Υȥåפ�򴹤���. ���ƥ졼���Ȥ��ƸƤФ줿��
+      ���ˤ�, �֥��å��¹���Τ�pushd����.
+
+--- Shell#popd
+--- Shell#popdir
+
+      �ǥ��쥯�ȥꥹ���å�����ݥåפ�, ����򥫥��ȥǥ��쥯�ȥ�ˤ���.
+
+== �ե�����/�ǥ��쥯�ȥ����
+
+--- Shell#foreach(path = nil, &block)
+
+      path���ե�����ʤ�, File#foreach
+      path���ǥ��쥯�ȥ�ʤ�, Dir#foreach
+
+--- Shell#open(path, mode)
+
+      path���ե�����ʤ�, File#open
+      path���ǥ��쥯�ȥ�ʤ�, Dir#open
+
+--- Shell#unlink(path)
+
+      path���ե�����ʤ�, File#unlink
+      path���ǥ��쥯�ȥ�ʤ�, Dir#unlink
+
+--- Shell#test(command, file1, file2)
+--- Shell#[command, file1, file2]
+
+      �ե�����ƥ��ȴؿ�test��Ʊ��. 
+      ��)
+          sh[?e, "foo"]
+          sh[:e, "foo"]
+          sh["e", "foo"]
+          sh[:exists?, "foo"]
+          sh["exists?", "foo"]
+
+--- Shell#mkdir(*path)
+
+      Dir.mkdir��Ʊ��(ʣ����)
+
+--- Shell#rmdir(*path)
+
+      Dir.rmdir��Ʊ��(ʣ����)
+
+== ���ޥ�ɼ¹�
+
+--- System#system(command, *opts)
+
+      command��¹Ԥ���.
+      ��)
+        print sh.system("ls", "-l")
+        sh.system("ls", "-l") | sh.head > STDOUT
+
+--- System#rehash
+
+      ��ϥå��夹��
+
+--- Shell#transact &block
+
+      �֥��å���Ǥ�shell��self�Ȥ��Ƽ¹Ԥ���.
+      ��)
+        sh.transact{system("ls", "-l") | head > STDOUT}
+
+--- Shell#out(dev = STDOUT, &block)
+
+      transact��ƤӽФ����η�̤�dev�˽��Ϥ���.
+
+== �������ޥ��
+
+--- Shell#echo(*strings)
+--- Shell#cat(*files)
+--- Shell#glob(patten)
+--- Shell#tee(file)
+
+      �����ϼ¹Ԥ����, ���������ƤȤ���Filter���֥������Ȥ��֤��ޤ�. 
+
+--- Filter#each &block
+
+      �ե��륿�ΰ�Ԥ��Ĥ�block���Ϥ�.
+
+--- Filter#<(src)
+
+      src��ե��륿�����ϤȤ���. src��, ʸ����ʤ�Хե������, IO�Ǥ���
+      �Ф���򤽤Τޤ����ϤȤ���.
+
+--- Filter#>(to)
+
+      src��ե��륿�ν��ϤȤ���. to��, ʸ����ʤ�Хե������, IO�Ǥ���
+      �Ф���򤽤Τޤ޽��ϤȤ���.
+
+--- Filter#>>(to)
+
+      src��ե��륿���ɲä���. to��, ʸ����ʤ�Хե������, IO�Ǥ����
+      ����򤽤Τޤ޽��ϤȤ���.
+
+--- Filter#|(filter)
+
+      �ѥ��׷��
+
+--- Filter#+(filter)
+
+      filter1 + filter2 �� filter1�ν��Ϥθ�, filter2�ν��Ϥ�Ԥ�.
+
+--- Filter#to_a
+--- Filter#to_s
+
+== �ȹ��ߥ��ޥ��
+
+--- Shell#atime(file)
+--- Shell#basename(file, *opt)
+--- Shell#chmod(mode, *files)
+--- Shell#chown(owner, group, *file)
+--- Shell#ctime(file)
+--- Shell#delete(*file)
+--- Shell#dirname(file)
+--- Shell#ftype(file)
+--- Shell#join(*file)
+--- Shell#link(file_from, file_to)
+--- Shell#lstat(file)
+--- Shell#mtime(file)
+--- Shell#readlink(file)
+--- Shell#rename(file_from, file_to)
+--- Shell#split(file)
+--- Shell#stat(file)
+--- Shell#symlink(file_from, file_to)
+--- Shell#truncate(file, length)
+--- Shell#utime(atime, mtime, *file)
+
+      ������File���饹�ˤ���Ʊ̾�Υ��饹�᥽�åɤ�Ʊ���Ǥ�.
+
+--- Shell#blockdev?(file)
+--- Shell#chardev?(file)
+--- Shell#directory?(file)
+--- Shell#executable?(file)
+--- Shell#executable_real?(file)
+--- Shell#exist?(file)/Shell#exists?(file)
+--- Shell#file?(file)
+--- Shell#grpowned?(file)
+--- Shell#owned?(file)
+--- Shell#pipe?(file)
+--- Shell#readable?(file)
+--- Shell#readable_real?(file)
+--- Shell#setgid?(file)
+--- Shell#setuid?(file)
+--- Shell#size(file)/Shell#size?(file)
+--- Shell#socket?(file)
+--- Shell#sticky?(file)
+--- Shell#symlink?(file)
+--- Shell#writable?(file)
+--- Shell#writable_real?(file)
+--- Shell#zero?(file)
+
+      ������FileTest���饹�ˤ���Ʊ̾�Υ��饹�᥽�åɤ�Ʊ���Ǥ�.
+
+--- Shell#syscopy(filename_from, filename_to)
+--- Shell#copy(filename_from, filename_to)
+--- Shell#move(filename_from, filename_to)
+--- Shell#compare(filename_from, filename_to)
+--- Shell#safe_unlink(*filenames)
+--- Shell#makedirs(*filenames)
+--- Shell#install(filename_from, filename_to, mode)
+
+      ������FileTools���饹�ˤ���Ʊ̾�Υ��饹�᥽�åɤ�Ʊ���Ǥ�.
+
+      ����¾, �ʲ��Τ�Τ������ꥢ������Ƥ��ޤ�.
+
+--- Shell#cmp	<- Shell#compare
+--- Shell#mv	<- Shell#move
+--- Shell#cp	<- Shell#copy
+--- Shell#rm_f	<- Shell#safe_unlink
+--- Shell#mkpath	<- Shell#makedirs
+
+= ����ץ�
+
+== ex1
+
+  sh = Shell.cd("/tmp")
+  sh.mkdir "shell-test-1" unless sh.exists?("shell-test-1")
+  sh.cd("shell-test-1")
+  for dir in ["dir1", "dir3", "dir5"]
+    if !sh.exists?(dir)
+      sh.mkdir dir
+      sh.cd(dir) do
+	f = sh.open("tmpFile", "w")
+	f.print "TEST\n"
+	f.close
+      end
+      print sh.pwd
+    end
+  end
+
+== ex2
+
+  sh = Shell.cd("/tmp")
+  sh.transact do
+    mkdir "shell-test-1" unless exists?("shell-test-1")
+    cd("shell-test-1")
+    for dir in ["dir1", "dir3", "dir5"]
+      if !exists?(dir)
+	mkdir dir
+	cd(dir) do
+	  f = open("tmpFile", "w")
+	  f.print "TEST\n"
+	  f.close
+	end
+	print pwd
+      end
+    end
+  end
+
+== ex3
+
+  sh.cat("/etc/printcap") | sh.tee("tee1") > "tee2"
+  (sh.cat < "/etc/printcap") | sh.tee("tee11") > "tee12"
+  sh.cat("/etc/printcap") | sh.tee("tee1") >> "tee2"
+  (sh.cat < "/etc/printcap") | sh.tee("tee11") >> "tee12"
+
+== ex4
+
+  print sh.cat("/etc/passwd").head.collect{|l| l =~ /keiju/}
+
+=end