rdx 0.9.0.pre

data/examples/ruby-2.0.0-p0/install/core/diffs/error.c.diff

@@ -0,0 +1,143 @@
+--- core/orig/error.c	2015-06-11 07:51:44 +0000
++++ core/patched/error.c	2015-06-18 20:20:56 +0000
+@@ -242,12 +242,13 @@
+  *    warn(msg, ...)   -> nil
+  *
+  * Displays each of the given messages followed by a record separator on
+- * STDERR unless warnings have been disabled (for example with the
++ * $stderr unless warnings have been disabled (for example with the
+  * <code>-W0</code> flag).
+- *
++ * 
+  *    warn("warning 1", "warning 2")
+  *
+- *  <em>produces:</em>
++ * <em>produces on $stderr:</em>
++ * :rdx: stderr
+  *
+  *    warning 1
+  *    warning 2
+@@ -667,7 +668,8 @@
+  *  Returns any backtrace associated with the exception. The backtrace
+  *  is an array of strings, each containing either ``filename:lineNo: in
+  *  `method''' or ``filename:lineNo.''
+- *
++ * 
++ *     # File: prog.rb
+  *     def a
+  *       raise "boom"
+  *     end
+@@ -682,11 +684,11 @@
+  *       print detail.backtrace.join("\n")
+  *     end
+  *
+- *  <em>produces:</em>
+- *
++ *  Then from the command line:
++ *     $ ruby prog.rb
+  *     prog.rb:2:in `a'
+  *     prog.rb:6:in `b'
+- *     prog.rb:10
++ *     prog.rb:10:in `<main>'
+ */
+ 
+ static VALUE
+@@ -1171,7 +1173,11 @@
+  *  The full list of operating system errors on your particular platform
+  *  are available as the constants of <code>Errno</code>.
+  *
+- *     Errno.constants   #=> :E2BIG, :EACCES, :EADDRINUSE, :EADDRNOTAVAIL, ...
++ *     Errno.constants # -> [
++ *     #   :E2BIG, :EACCES, :EADDRINUSE,
++ *     #   :EADDRNOTAVAIL,
++ *     #   # ...
++ *     # ]
+  */
+ 
+ static st_table *syserr_tbl;
+@@ -1332,7 +1338,7 @@
+  *
+  *  <em>raises the exception:</em>
+  *
+- *     LoadError: no such file to load -- does/not/exist
++ *     LoadError: cannot load such file -- does/not/exist
+  *
+  */
+ 
+@@ -1346,6 +1352,8 @@
+  *  Document-class: SignalException
+  *
+  *  Raised when a signal is received.
++ * 
++ *  :rdx: if Signal.list['HUP']
+  *
+  *     begin
+  *       Process.kill('HUP',Process.pid)
+@@ -1364,10 +1372,16 @@
+  *  Raised with the interrupt signal is received, typically because the
+  *  user pressed on Control-C (on most posix platforms). As such, it is a
+  *  subclass of +SignalException+.
+- *
++ * 
+  *     begin
+  *       puts "Press ctrl-C when you get bored"
+- *       loop {}
++ *-- rdx
++ *       raise Interrupt
++ *++
++ *       loop do
++ *         # ... do something ...
++ *       end
++ *       # meanwhile the user pressed on Control-C
+  *     rescue Interrupt => e
+  *       puts "Note: You will typically use Signal.trap instead."
+  *     end
+@@ -1375,10 +1389,9 @@
+  *  <em>produces:</em>
+  *
+  *     Press ctrl-C when you get bored
+- *
+- *  <em>then waits until it is interrupted with Control-C and then prints:</em>
+- *
+  *     Note: You will typically use Signal.trap instead.
++ *
++ *     
+  */
+ 
+ /*
+@@ -1425,7 +1438,7 @@
+  *     a = [:foo, :bar]
+  *     a.fetch(0)   #=> :foo
+  *     a[4]         #=> nil
+- *     a.fetch(4)   #=> IndexError: index 4 outside of array bounds: -2...2
++ *     a.fetch(4)   # raises IndexError: index 4 outside of array bounds: -2...2
+  *
+  */
+ 
+@@ -1437,7 +1450,7 @@
+  *
+  *     h = {"foo" => :bar}
+  *     h.fetch("foo") #=> :bar
+- *     h.fetch("baz") #=> KeyError: key not found: "baz"
++ *     h.fetch("baz") # raises KeyError: key not found: "baz"
+  *
+  */
+ 
+@@ -1473,7 +1486,7 @@
+  *
+  *  <em>raises the exception:</em>
+  *
+- *     SyntaxError: (eval):1: syntax error, unexpected '=', expecting $end
++ *     SyntaxError: (eval):1: syntax error, unexpected '=', expecting end-of-input
+  */
+ 
+ /*
+@@ -1486,7 +1499,7 @@
+  *
+  *  <em>raises the exception:</em>
+  *
+- *     LoadError: no such file to load -- this/file/does/not/exist
++ *     LoadError: cannot load such file -- this/file/does/not/exist
+  */
+ 
+ /*

data/examples/ruby-2.0.0-p0/install/core/diffs/eval.c.diff

@@ -0,0 +1,47 @@
+--- core/orig/eval.c	2015-06-11 07:51:44 +0000
++++ core/patched/eval.c	2015-06-12 23:48:06 +0000
+@@ -321,13 +321,13 @@
+  *
+  *  Returns the list of +Modules+ nested at the point of call.
+  *
+- *     module M1
++ *     nesting = module M1
+  *       module M2
+- *         $a = Module.nesting
++ *         Module.nesting   # returned to nesting
+  *       end
+  *     end
+- *     $a           #=> [M1::M2, M1]
+- *     $a[0].name   #=> "M1::M2"
++ *     nesting[0]      #=> M1::M2
++ *     nesting[1].name #=> "M1"
+  */
+ 
+ static VALUE
+@@ -357,14 +357,12 @@
+  *  This list includes the names of all modules and classes
+  *  defined in the global scope.
+  *
+- *     Module.constants.first(4)
+- *        # => [:ARGF, :ARGV, :ArgumentError, :Array]
++ *     Module.constants.sort.first(4)
++ *        # -> [:ARGF, :ARGV, :ArgumentError, :Array]
+  *
+  *     Module.constants.include?(:SEEK_SET)   # => false
+  *
+- *     class IO
+- *       Module.constants.include?(:SEEK_SET) # => true
+- *     end
++ *     IO.constants.include?(:SEEK_SET) # => true
+  *
+  *  The second form calls the instance method +constants+.
+  */
+@@ -569,6 +567,8 @@
+  *  array of callback information. Exceptions are caught by the
+  *  +rescue+ clause of <code>begin...end</code> blocks.
+  *
++ *  :rdx: off
++ *  :rdx: # the expectation "raises" is obvious here...
+  *     raise "Failed to create socket"
+  *     raise ArgumentError, "No parameters", caller
+  */

data/examples/ruby-2.0.0-p0/install/core/diffs/eval_jump.c.diff

@@ -0,0 +1,23 @@
+--- core/orig/eval_jump.c	2015-06-11 07:51:43 +0000
++++ core/patched/eval_jump.c	2015-06-11 07:51:46 +0000
+@@ -21,7 +21,8 @@
+  *  binds it at the point of call) and registers it for execution when
+  *  the program exits. If multiple handlers are registered, they are
+  *  executed in reverse order of registration.
+- *
++ * 
++ *     # File: prog.rb
+  *     def do_at_exit(str1)
+  *       at_exit { print str1 }
+  *     end
+@@ -29,8 +30,9 @@
+  *     do_at_exit("goodbye ")
+  *     exit
+  *
+- *  <em>produces:</em>
++ *  Then from the command line:
+  *
++ *     $ ruby prog.rb
+  *     goodbye cruel world
+  */
+ 

data/examples/ruby-2.0.0-p0/install/core/diffs/file.c.diff

@@ -0,0 +1,752 @@
+--- core/orig/file.c	2015-06-11 07:51:44 +0000
++++ core/patched/file.c	2015-06-28 11:41:02 +0000
+@@ -267,7 +267,10 @@
+  *  not normalize the name.
+  *
+  *     File.new("testfile").path               #=> "testfile"
+- *     File.new("/tmp/../tmp/xxx", "w").path   #=> "/tmp/../tmp/xxx"
++ *-- rdx
++ *     Dir.mkdir 'tmp'
++ *++
++ *     File.new("tmp/../tmp/xxx", "w").path   #=> "tmp/../tmp/xxx"
+  *
+  */
+ 
+@@ -329,6 +332,7 @@
+  *  Compares <code>File::Stat</code> objects by comparing their
+  *  respective modification times.
+  *
++ *  :rdx: is_slow
+  *     f1 = File.new("f1", "w")
+  *     sleep 1
+  *     f2 = File.new("f2", "w")
+@@ -371,7 +375,7 @@
+  *  Returns an integer representing the device on which <i>stat</i>
+  *  resides.
+  *
+- *     File.stat("testfile").dev   #=> 774
++ *     File.stat("testfile").dev   #-> 774
+  */
+ 
+ static VALUE
+@@ -387,8 +391,10 @@
+  *  Returns the major part of <code>File_Stat#dev</code> or
+  *  <code>nil</code>.
+  *
+- *     File.stat("/dev/fd1").dev_major   #=> 2
+- *     File.stat("/dev/tty").dev_major   #=> 5
++ *  :rdx: if File.exist?("/dev/fd1")
++ *     File.stat("/dev/fd1").dev_major   # -> 2
++ *  :rdx: if File.exist?("/dev/tty")
++ *     File.stat("/dev/tty").dev_major   # -> 5
+  */
+ 
+ static VALUE
+@@ -408,8 +414,10 @@
+  *  Returns the minor part of <code>File_Stat#dev</code> or
+  *  <code>nil</code>.
+  *
+- *     File.stat("/dev/fd1").dev_minor   #=> 1
+- *     File.stat("/dev/tty").dev_minor   #=> 0
++ *  :rdx: if File.exist?("/dev/fd1")
++ *     File.stat("/dev/fd1").dev_minor   # -> 1
++ *  :rdx: if File.exist?("/dev/tty")
++ *     File.stat("/dev/tty").dev_minor   # -> 0
+  */
+ 
+ static VALUE
+@@ -428,7 +436,7 @@
+  *
+  *  Returns the inode number for <i>stat</i>.
+  *
+- *     File.stat("testfile").ino   #=> 1083669
++ *     File.stat("testfile").ino   # -> 1083669
+  *
+  */
+ 
+@@ -450,7 +458,7 @@
+  *  <i>stat</i>. The meaning of the bits is platform dependent; on
+  *  Unix systems, see <code>stat(2)</code>.
+  *
+- *     File.chmod(0644, "testfile")   #=> 1
++ *     File.chmod(0644, "testfile")
+  *     s = File.stat("testfile")
+  *     sprintf("%o", s.mode)          #=> "100644"
+  */
+@@ -469,6 +477,7 @@
+  *
+  *     File.stat("testfile").nlink             #=> 1
+  *     File.link("testfile", "testfile.bak")   #=> 0
++ *  :rdx: bug   on x64-mingw32 I obtained 1
+  *     File.stat("testfile").nlink             #=> 2
+  *
+  */
+@@ -485,7 +494,7 @@
+  *
+  *  Returns the numeric user id of the owner of <i>stat</i>.
+  *
+- *     File.stat("testfile").uid   #=> 501
++ *     File.stat("testfile").uid   #-> 501
+  *
+  */
+ 
+@@ -501,7 +510,7 @@
+  *
+  *  Returns the numeric group id of the owner of <i>stat</i>.
+  *
+- *     File.stat("testfile").gid   #=> 500
++ *     File.stat("testfile").gid   #-> 500
+  *
+  */
+ 
+@@ -519,8 +528,10 @@
+  *  <i>stat</i> resides. Returns <code>nil</code> if the operating
+  *  system doesn't support this feature.
+  *
+- *     File.stat("/dev/fd1").rdev   #=> 513
+- *     File.stat("/dev/tty").rdev   #=> 1280
++ *  :rdx: if File.exist?("/dev/fd1")
++ *     File.stat("/dev/fd1").rdev   # -> 513
++ *  :rdx: if File.exist?("/dev/tty")
++ *     File.stat("/dev/tty").rdev   # -> 1280
+  */
+ 
+ static VALUE
+@@ -540,8 +551,10 @@
+  *  Returns the major part of <code>File_Stat#rdev</code> or
+  *  <code>nil</code>.
+  *
+- *     File.stat("/dev/fd1").rdev_major   #=> 2
+- *     File.stat("/dev/tty").rdev_major   #=> 5
++ *  :rdx: if File.exist?("/dev/fd1")
++ *     File.stat("/dev/fd1").rdev_major   # -> 2
++ *  :rdx: if File.exist?("/dev/tty")
++ *     File.stat("/dev/tty").rdev_major   # -> 5
+  */
+ 
+ static VALUE
+@@ -561,8 +574,10 @@
+  *  Returns the minor part of <code>File_Stat#rdev</code> or
+  *  <code>nil</code>.
+  *
+- *     File.stat("/dev/fd1").rdev_minor   #=> 1
+- *     File.stat("/dev/tty").rdev_minor   #=> 0
++ *  :rdx: if File.exist?("/dev/fd1")
++ *     File.stat("/dev/fd1").rdev_minor   # -> 1
++ *  :rdx: if File.exist?("/dev/tty")
++ *     File.stat("/dev/tty").rdev_minor   # -> 0
+  */
+ 
+ static VALUE
+@@ -581,7 +596,7 @@
+  *
+  *  Returns the size of <i>stat</i> in bytes.
+  *
+- *     File.stat("testfile").size   #=> 66
++ *     File.stat("testfile").size   #-> 66
+  */
+ 
+ static VALUE
+@@ -597,7 +612,7 @@
+  *  Returns the native file system's block size. Will return <code>nil</code>
+  *  on platforms that don't support this information.
+  *
+- *     File.stat("testfile").blksize   #=> 4096
++ *     File.stat("testfile").blksize   # -> 4096
+  *
+  */
+ 
+@@ -619,7 +634,7 @@
+  *  file, or <code>nil</code> if the operating system doesn't
+  *  support this feature.
+  *
+- *     File.stat("testfile").blocks   #=> 2
++ *     File.stat("testfile").blocks   # -> 2
+  */
+ 
+ static VALUE
+@@ -715,7 +730,7 @@
+  *  Returns the last access time for this file as an object of class
+  *  <code>Time</code>.
+  *
+- *     File.stat("testfile").atime   #=> Wed Dec 31 18:00:00 CST 1969
++ *     File.stat("testfile").atime   #-> Time.new(1969,12,31, 18,0,0)
+  *
+  */
+ 
+@@ -731,7 +746,7 @@
+  *
+  *  Returns the modification time of <i>stat</i>.
+  *
+- *     File.stat("testfile").mtime   #=> Wed Apr 09 08:53:14 CDT 2003
++ *     File.stat("testfile").mtime   #-> Time.new(2003,4,9, 8,53,14)
+  *
+  */
+ 
+@@ -751,7 +766,7 @@
+  *
+  *  Note that on Windows (NTFS), returns creation time (birth time).
+  *
+- *     File.stat("testfile").ctime   #=> Wed Apr 09 08:53:14 CDT 2003
++ *     File.stat("testfile").ctime   #-> Time.new(2003,4,9, 8,53,14)
+  *
+  */
+ 
+@@ -767,8 +782,8 @@
+  *
+  * Produce a nicely formatted description of <i>stat</i>.
+  *
+- *   File.stat("/etc/passwd").inspect
+- *      #=> "#<File::Stat dev=0xe000005, ino=1078078, mode=0100644,
++ *   File.stat("testfile").inspect
++ *      #-> "#<File::Stat dev=0xe000005, ino=1078078, mode=0100644,
+  *      #    nlink=1, uid=0, gid=0, rdev=0x0, size=1374, blksize=4096,
+  *      #    blocks=8, atime=Wed Dec 10 10:16:12 CST 2003,
+  *      #    mtime=Fri Sep 12 15:41:41 CDT 2003,
+@@ -901,7 +916,8 @@
+  *  Returns a <code>File::Stat</code> object for the named file (see
+  *  <code>File::Stat</code>).
+  *
+- *     File.stat("testfile").mtime   #=> Tue Apr 08 12:58:04 CDT 2003
++ *  :rdx: no_warnings result_instance_of
++ *     File.stat("testfile")  #=> #<File::Stat dev=0xe000005, ino=1078078 ... >
+  *
+  */
+ 
+@@ -925,11 +941,12 @@
+  *  Returns status information for <em>ios</em> as an object of type
+  *  <code>File::Stat</code>.
+  *
++ *  :rdx: skip IO class needed
+  *     f = File.new("testfile")
+  *     s = f.stat
+- *     "%o" % s.mode   #=> "100644"
+- *     s.blksize       #=> 4096
+- *     s.atime         #=> Wed Apr 09 08:53:54 CDT 2003
++ *     "%o" % s.mode   #-> "100644"
++ *     s.blksize       #-> 4096
++ *     s.atime         # Wed Apr 09 08:53:54 CDT 2003
+  *
+  */
+ 
+@@ -953,10 +970,14 @@
+  *  Same as <code>File::stat</code>, but does not follow the last symbolic
+  *  link. Instead, reports on the link itself.
+  *
+- *     File.symlink("testfile", "link2test")   #=> 0
+- *     File.stat("testfile").size              #=> 66
+- *     File.lstat("link2test").size            #=> 8
+- *     File.stat("link2test").size             #=> 66
++ *  :rdx: if File.respond_to?(:symlink)
++ *     File.symlink("testfile", "link2test")
++ *     File.stat("testfile").size              #-> 66
++ *     File.lstat("link2test").size            #-> 8
++ *     File.stat("link2test").size             #-> 66
++ *-- rdx
++ *     File.unlink("link2test")
++ *++
+  *
+  */
+ 
+@@ -985,11 +1006,12 @@
+  *  Same as <code>IO#stat</code>, but does not follow the last symbolic
+  *  link. Instead, reports on the link itself.
+  *
+- *     File.symlink("testfile", "link2test")   #=> 0
+- *     File.stat("testfile").size              #=> 66
++ *  :rdx: if File.respond_to?(:symlink)
++ *     File.symlink("testfile", "link2test")
++ *     File.stat("testfile").size              #-> 66
+  *     f = File.new("link2test")
+- *     f.lstat.size                            #=> 8
+- *     f.stat.size                             #=> 66
++ *     f.lstat.size                            #-> 8
++ *     f.stat.size                             #-> 66
+  */
+ 
+ static VALUE
+@@ -1114,8 +1136,6 @@
+  */
+ 
+ /*
+- * Document-method: directory?
+- *
+  * call-seq:
+  *   File.directory?(file_name)   ->  true or false
+  *
+@@ -1123,7 +1143,7 @@
+  * or a symlink that points at a directory, and <code>false</code>
+  * otherwise.
+  *
+- *    File.directory?(".")
++ *    File.directory?(".") #=> true
+  */
+ 
+ VALUE
+@@ -1354,9 +1374,10 @@
+  * <code>nil</code> otherwise. The meaning of the bits is platform
+  * dependent; on Unix systems, see <code>stat(2)</code>.
+  *
+- *    File.world_readable?("/etc/passwd")	    #=> 420
++ * :rdx: if File.exist?("/etc/passwd")
++ *    File.world_readable?("/etc/passwd")	    # -> 420
+  *    m = File.world_readable?("/etc/passwd")
+- *    sprintf("%o", m)				    #=> "644"
++ *    sprintf("%o", m)				    #-> "644"
+  */
+ 
+ static VALUE
+@@ -1418,9 +1439,10 @@
+  * <code>nil</code> otherwise. The meaning of the bits is platform
+  * dependent; on Unix systems, see <code>stat(2)</code>.
+  *
+- *    File.world_writable?("/tmp")		    #=> 511
++ * :rdx: if File.exist?("/tmp")
++ *    File.world_writable?("/tmp")		    # -> 511
+  *    m = File.world_writable?("/tmp")
+- *    sprintf("%o", m)				    #=> "777"
++ *    sprintf("%o", m)				    #-> "777"
+  */
+ 
+ static VALUE
+@@ -1654,14 +1676,16 @@
+  * Returns <code>true</code> if the named files are identical.
+  *
+  *     open("a", "w") {}
+- *     p File.identical?("a", "a")      #=> true
+- *     p File.identical?("a", "./a")    #=> true
++ *     File.identical?("a", "a")      #=> true
++ *     File.identical?("a", "./a")    #=> true
+  *     File.link("a", "b")
+- *     p File.identical?("a", "b")      #=> true
++ *     File.identical?("a", "b")      #=> true
++ * :rdx: if File.respond_to?(:symlink)
+  *     File.symlink("a", "c")
+- *     p File.identical?("a", "c")      #=> true
++ *     File.identical?("a", "c")      #=> true
++ * :rdx:
+  *     open("d", "w") {}
+- *     p File.identical?("a", "d")      #=> false
++ *     File.identical?("a", "d")      #=> false
+  */
+ 
+ static VALUE
+@@ -1783,7 +1807,9 @@
+  *  ``<code>socket</code>'', or ``<code>unknown</code>''.
+  *
+  *     File.ftype("testfile")            #=> "file"
++ *  :rdx: if File.exist? "/dev/tty"
+  *     File.ftype("/dev/tty")            #=> "characterSpecial"
++ *  :rdx: if File.exist? "/tmp/.X11-unix/X0"
+  *     File.ftype("/tmp/.X11-unix/X0")   #=> "socket"
+  */
+ 
+@@ -1808,7 +1834,7 @@
+  *
+  *  Returns the last access time for the named file as a Time object).
+  *
+- *     File.atime("testfile")   #=> Wed Apr 09 08:51:48 CDT 2003
++ *     File.atime("testfile")   #-> Time.new(1969,12,31, 18,0,0)
+  *
+  */
+ 
+@@ -1829,9 +1855,9 @@
+  *     file.atime    -> time
+  *
+  *  Returns the last access time (a <code>Time</code> object)
+- *   for <i>file</i>, or epoch if <i>file</i> has not been accessed.
++ *  for <i>file</i>, or epoch if <i>file</i> has not been accessed.
+  *
+- *     File.new("testfile").atime   #=> Wed Dec 31 18:00:00 CST 1969
++ *     File.new("testfile").atime   #-> Time.new(1969,12,31, 18,0,0)
+  *
+  */
+ 
+@@ -1854,7 +1880,7 @@
+  *
+  *  Returns the modification time for the named file as a Time object.
+  *
+- *     File.mtime("testfile")   #=> Tue Apr 08 12:58:04 CDT 2003
++ *     File.mtime("testfile")   #-> Time.new(2003,4,9, 8,53,14)
+  *
+  */
+ 
+@@ -1876,7 +1902,7 @@
+  *
+  *  Returns the modification time for <i>file</i>.
+  *
+- *     File.new("testfile").mtime   #=> Wed Apr 09 08:53:14 CDT 2003
++ *     File.new("testfile").mtime   #-> Time.new(2003,4,9, 8,53,14)
+  *
+  */
+ 
+@@ -1903,7 +1929,7 @@
+  *
+  *  Note that on Windows (NTFS), returns creation time (birth time).
+  *
+- *     File.ctime("testfile")   #=> Wed Apr 09 08:53:13 CDT 2003
++ *     File.ctime("testfile")   #-> Time.new(2003,4,9, 8,53,14)
+  *
+  */
+ 
+@@ -1928,7 +1954,7 @@
+  *
+  *  Note that on Windows (NTFS), returns creation time (birth time).
+  *
+- *     File.new("testfile").ctime   #=> Wed Apr 09 08:53:14 CDT 2003
++ *     File.new("testfile").ctime   #-> Time.new(2003,4,9, 8,53,14)
+  *
+  */
+ 
+@@ -1951,7 +1977,7 @@
+  *
+  *  Returns the size of <i>file</i> in bytes.
+  *
+- *     File.new("testfile").size   #=> 66
++ *     File.new("testfile").size   #-> 66
+  *
+  */
+ 
+@@ -1988,6 +2014,9 @@
+  *  <code>chmod(2)</code> for details. Returns the number of files
+  *  processed.
+  *
++ *-- rdx
++ *     File.write 'out', 'content'
++ *++
+  *     File.chmod(0644, "testfile", "out")   #=> 2
+  */
+ 
+@@ -2016,7 +2045,7 @@
+  *  dependent; on Unix systems, see <code>chmod(2)</code> for details.
+  *  Follows symbolic links. Also see <code>File#lchmod</code>.
+  *
+- *     f = File.new("out", "w");
++ *     f = File.new("testfile")
+  *     f.chmod(0644)   #=> 0
+  */
+ 
+@@ -2106,7 +2135,7 @@
+  *  belongs. A <code>nil</code> or -1 owner or group id is ignored.
+  *  Returns the number of files processed.
+  *
+- *     File.chown(nil, 100, "testfile")
++ *     File.chown(nil, 100, "testfile") #=> 1
+  *
+  */
+ 
+@@ -2147,7 +2176,7 @@
+  *  <code>nil</code> or -1 owner or group id is ignored. Follows
+  *  symbolic links. See also <code>File#lchown</code>.
+  *
+- *     File.new("testfile").chown(502, 1000)
++ *     File.new("testfile").chown(502, 1000) #=> 0
+  *
+  */
+ 
+@@ -2390,8 +2419,11 @@
+  *  overwrite <i>new_name</i> if it already exists (raising a subclass
+  *  of <code>SystemCallError</code>). Not available on all platforms.
+  *
++ *  :rdx: if File.respond_to? :link
+  *     File.link("testfile", ".testfile")   #=> 0
+- *     IO.readlines(".testfile")[0]         #=> "This is line one\n"
++ *     first_line      = IO.readlines("testfile")[0]
++ *     first_line_link = IO.readlines(".testfile")[0]
++ *     first_line == first_line_link #=> true
+  */
+ 
+ static VALUE
+@@ -2421,6 +2453,7 @@
+  *  <i>old_name</i>. Raises a <code>NotImplemented</code> exception on
+  *  platforms that do not support symbolic links.
+  *
++ *  :rdx: if File.respond_to? :symlink
+  *     File.symlink("testfile", "link2test")   #=> 0
+  *
+  */
+@@ -2453,6 +2486,7 @@
+  *  Returns the name of the file referenced by the given link.
+  *  Not available on all platforms.
+  *
++ *  :rdx: if File.respond_to? :readlink
+  *     File.symlink("testfile", "link2test")   #=> 0
+  *     File.readlink("link2test")              #=> "testfile"
+  */
+@@ -2528,7 +2562,13 @@
+  *  Renames the given file to the new name. Raises a
+  *  <code>SystemCallError</code> if the file cannot be renamed.
+  *
++ *-- rdx
++ *     File.write 'afile', 'content'
++ *++
+  *     File.rename("afile", "afile.bak")   #=> 0
++ *-- rdx
++ *     File.delete "afile.bak"
++ *++
+  */
+ 
+ static VALUE
+@@ -2577,7 +2617,8 @@
+  *  default permissions, so a umask of <code>0222</code> would make a
+  *  file read-only for everyone.
+  *
+- *     File.umask(0006)   #=> 18
++ *  :rdx: off
++ *     File.umask(0006)   #-> 18
+  *     File.umask         #=> 6
+  */
+ 
+@@ -3286,8 +3327,18 @@
+  *  correctly). ``<code>~</code><i>user</i>'' expands to the named
+  *  user's home directory.
+  *
+- *     File.expand_path("~oracle/bin")           #=> "/home/oracle/bin"
+- *     File.expand_path("../../bin", "/tmp/x")   #=> "/bin"
++ *-- rdx
++ *     orig_home = ENV['HOME']
++ *     ENV['HOME'] = Dir.pwd
++ *++
++ *     File.expand_path("~/oracle/bin")           #=> "#{ENV['HOME']}/oracle/bin"
++ *-- rdx
++ *     ENV['HOME'] = orig_home
++ *++
++ *     File.expand_path("../../bin", "tmp/x")    #=> "#{Dir.pwd}/bin"
++ *     File.expand_path("../../bin", "/tmp/x")   #=> File.expand_path 'bin', '/'
++ *     # which is '/bin' on unix systems, something like 'C:\bin' on windows
++ * 
+  */
+ 
+ VALUE
+@@ -3320,7 +3371,7 @@
+  *  starting point. If the given pathname starts with a ``<code>~</code>''
+  *  it is NOT expanded, it is treated as a normal directory name.
+  *
+- *     File.absolute_path("~oracle/bin")       #=> "<relative_path>/~oracle/bin"
++ *     File.absolute_path("~oracle/bin")       #=> "#{Dir.pwd}/~oracle/bin"
+  */
+ 
+ VALUE
+@@ -3861,7 +3912,7 @@
+  *
+  *     File.extname("test.rb")         #=> ".rb"
+  *     File.extname("a/b/d/test.rb")   #=> ".rb"
+- *     File.extname("foo.")	       #=> ""
++ *     File.extname("foo.")            #=> ""
+  *     File.extname("test")            #=> ""
+  *     File.extname(".profile")        #=> ""
+  *     File.extname(".profile.sh")     #=> ".sh"
+@@ -3893,6 +3944,7 @@
+  *  Returns the string representation of the path
+  *
+  *     File.path("/dev/null")          #=> "/dev/null"
++ *     require 'pathname'
+  *     File.path(Pathname.new("/tmp")) #=> "/tmp"
+  *
+  */
+@@ -4034,6 +4086,7 @@
+  *  Truncates the file <i>file_name</i> to be at most <i>integer</i>
+  *  bytes long. Not available on all platforms.
+  *
++ *  :rdx: if File.respond_to? :truncate
+  *     f = File.new("out", "w")
+  *     f.write("1234567890")     #=> 10
+  *     f.close                   #=> nil
+@@ -4083,6 +4136,7 @@
+  *  Truncates <i>file</i> to at most <i>integer</i> bytes. The file
+  *  must be opened for writing. Not available on all platforms.
+  *
++ *  :rdx: if File.respond_to? :truncate
+  *     f = File.new("out", "w")
+  *     f.syswrite("1234567890")   #=> 10
+  *     f.truncate(5)              #=> 0
+@@ -4162,6 +4216,7 @@
+  *  available on all platforms.
+  *
+  *  Locking constants (in class File):
++ *  :rdx: off -
+  *
+  *     LOCK_EX   | Exclusive lock. Only one process may hold an
+  *               | exclusive lock for a given file at a time.
+@@ -4175,8 +4230,15 @@
+  *     LOCK_UN   | Unlock.
+  *
+  *  Example:
++ * 
++ *  :rdx: if File.respond_to?(:flock)
++ *  :rdx: in_tmpdir
+  *
+  *     # update a counter using write lock
++ * 
++ *     # initial state:
++ *     File.write "counter", "12\n"
++ * 
+  *     # don't use "w" because it truncates the file before lock.
+  *     File.open("counter", File::RDWR|File::CREAT, 0644) {|f|
+  *       f.flock(File::LOCK_EX)
+@@ -4190,8 +4252,8 @@
+  *     # read the counter using read lock
+  *     File.open("counter", "r") {|f|
+  *       f.flock(File::LOCK_SH)
+- *       p f.read
+- *     }
++ *       f.read.to_i
++ *     } #=> 13
+  *
+  */
+ 
+@@ -4265,6 +4327,8 @@
+  *
+  *  File tests on a single file:
+  *
++ *  :rdx: off
++ * 
+  *    Test   Returns   Meaning
+  *    "A"  | Time    | Last access time for file1
+  *    "b"  | boolean | True if file1 is a block device
+@@ -4465,6 +4529,15 @@
+  *  <code>File#lstat</code>, and <code>File::lstat</code>. Many of these
+  *  methods return platform-specific values, and not all values are
+  *  meaningful on all systems. See also <code>Kernel#test</code>.
++ * 
++ *  In the following examples we assume that we are located in a temporary
++ *  directory where already exists a regular file named <code>"testfile"</code>.
++ * 
++ *-- rdx
++ *  :rdx: in_tmpdir!!
++ *  :rdx: setup
++ *    File.write 'testfile', 'c'*66
++ *++
+  */
+ 
+ static VALUE
+@@ -4534,6 +4607,7 @@
+  *  ``<code>fifo</code>'', ``<code>link</code>'',
+  *  ``<code>socket</code>'', or ``<code>unknown</code>''.
+  *
++ *  :rdx: if File.exist?("/dev/tty")
+  *     File.stat("/dev/tty").ftype   #=> "characterSpecial"
+  *
+  */
+@@ -4591,7 +4665,8 @@
+  *  <code>false</code> for an object returned by
+  *  <code>File::stat</code>.
+  *
+- *     File.symlink("testfile", "alink")   #=> 0
++ *  :rdx: if File.respond_to? :symlink
++ *     File.symlink("testfile", "alink")
+  *     File.stat("alink").symlink?         #=> false
+  *     File.lstat("alink").symlink?        #=> true
+  *
+@@ -4637,7 +4712,8 @@
+  *  support this feature.
+  *
+  *     File.stat("testfile").blockdev?    #=> false
+- *     File.stat("/dev/hda1").blockdev?   #=> true
++ *  :rdx: if File.exist?("/dev/hda1")
++ *     File.stat("/dev/hda1").blockdev?   #-> true
+  *
+  */
+ 
+@@ -4659,7 +4735,8 @@
+  *  <code>false</code> if it isn't or if the operating system doesn't
+  *  support this feature.
+  *
+- *     File.stat("/dev/tty").chardev?   #=> true
++ *  :rdx: if File.exist?("/dev/tty")
++ *     File.stat("/dev/tty").chardev?   #-> true
+  *
+  */
+ 
+@@ -4679,7 +4756,8 @@
+  *  the same as the owner of <i>stat</i>.
+  *
+  *     File.stat("testfile").owned?      #=> true
+- *     File.stat("/etc/passwd").owned?   #=> false
++ *  :rdx: if File.exist?("/etc/passwd")
++ *     File.stat("/etc/passwd").owned?   #-> false
+  *
+  */
+ 
+@@ -4704,8 +4782,9 @@
+  *  Returns true if the effective group id of the process is the same as
+  *  the group id of <i>stat</i>. On Windows NT, returns <code>false</code>.
+  *
+- *     File.stat("testfile").grpowned?      #=> true
+- *     File.stat("/etc/passwd").grpowned?   #=> false
++ *     File.stat("testfile").grpowned?      #-> true
++ *  :rdx: if File.exist?("/etc/passwd")
++ *     File.stat("/etc/passwd").grpowned?   #-> false
+  *
+  */
+ 
+@@ -4793,8 +4872,9 @@
+  * <code>nil</code> otherwise. The meaning of the bits is platform
+  * dependent; on Unix systems, see <code>stat(2)</code>.
+  *
+- *    m = File.stat("/etc/passwd").world_readable?  #=> 420
+- *    sprintf("%o", m)				    #=> "644"
++ * :rdx: off
++ *    m = File.stat("/etc/passwd").world_readable?  #-> 420
++ *    sprintf("%o", m)				    #-> "644"
+  */
+ 
+ static VALUE
+@@ -4885,8 +4965,9 @@
+  * <code>nil</code> otherwise. The meaning of the bits is platform
+  * dependent; on Unix systems, see <code>stat(2)</code>.
+  *
+- *    m = File.stat("/tmp").world_writable?	    #=> 511
+- *    sprintf("%o", m)				    #=> "777"
++ * :rdx: if File.directory?("/tmp")
++ *    m = File.stat("/tmp").world_writable?	    #-> 511
++ *    sprintf("%o", m)				    #-> "777"
+  */
+ 
+ static VALUE
+@@ -5013,7 +5094,7 @@
+  *
+  *  Returns the size of <i>stat</i> in bytes.
+  *
+- *     File.stat("testfile").size   #=> 66
++ *     File.stat("testfile").size   #-> 66
+  *
+  */
+ 
+@@ -5034,6 +5115,7 @@
+  *  permission bit set, <code>false</code> if it doesn't or if the
+  *  operating system doesn't support this feature.
+  *
++ *  :rdx: if File.file?("/bin/su")
+  *     File.stat("/bin/su").setuid?   #=> true
+  */
+ 
+@@ -5054,7 +5136,8 @@
+  *  permission bit set, <code>false</code> if it doesn't or if the
+  *  operating system doesn't support this feature.
+  *
+- *     File.stat("/usr/sbin/lpc").setgid?   #=> true
++ *  :rdx: if File.exist?("/usr/sbin/lpc")
++ *     File.stat("/usr/sbin/lpc").setgid?   #-> true
+  *
+  */
+ 
+@@ -5432,8 +5515,17 @@
+  *  <code>0644</code>, which means read/write for owner, read-only for
+  *  all others. The only change that can be made is to make the file
+  *  read-only, which is reported as <code>0444</code>.
++ * 
++ *  In the following examples we assume that we are located in a temporary
++ *  directory where already exists a regular file named <code>"testfile"</code>.
++ * 
++ *-- rdx
++ *  :rdx: in_tmpdir!!
++ *  :rdx: setup
++ *    File.write 'testfile', 'c'*66
++ *++
++ * 
+  */
+-
+ void
+ Init_File(void)
+ {