rio 0.4.2 → 0.5.1

data/lib/rio/if/grande_entry.rb

@@ -1,6 +1,6 @@
 #--
-# =============================================================================== 
-# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
+# ===========================================================================
+# Copyright (c) 2005-2012 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -18,22 +18,9 @@
 # You should have received a copy of the GNU General Public License
 # along with Rio; if not, write to the Free Software
 # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-# =============================================================================== 
+# =========================================================================== 
 #++
 #
-# To create the documentation for Rio run the command
-#  ruby build_doc.rb
-# from the distribution directory.
-#
-# Suggested Reading
-# * RIO::Doc::SYNOPSIS
-# * RIO::Doc::INTRO
-# * RIO::Doc::HOWTO
-# * RIO::Doc::EXAMPLES
-# * RIO::Rio
-#
-
-
 module RIO
   module IF
     module GrandeEntry
@@ -119,7 +106,7 @@ module RIO
       #
       # Behaves like #entries, except that matching entries are excluded.
       #
-      # See also #entries, IF::Grande#skip
+      # See also #entries, {#skip}[rdoc-ref:IF::Grande#skip]
       #
       def skipentries(*args,&block) target.skipentries(*args,&block); self end
 
@@ -291,7 +278,7 @@ module RIO
       #
       # If a block is given behaves like <tt>ario.skipfiles(*args).each(&block)</tt>
       #
-      # See #files, IF::Grande#skip
+      # See #files, {#skip}[rdoc-ref:IF::Grande#skip]
       #
       #  rio('adir').skipfiles { |ent| ... } # iterate through everything except files
       #  rio('adir').skipfiles('*~') { |frio| ... } # iterate through files, skipping those ending with a tilde

data/lib/rio/if/grande_stream.rb

@@ -1,6 +1,6 @@
 #--
-# =============================================================================== 
-# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
+# ===========================================================================
+# Copyright (c) 2005-2012 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -18,22 +18,9 @@
 # You should have received a copy of the GNU General Public License
 # along with Rio; if not, write to the Free Software
 # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-# =============================================================================== 
+# =========================================================================== 
 #++
 #
-# To create the documentation for Rio run the command
-#  ruby build_doc.rb
-# from the distribution directory.
-#
-# Suggested Reading
-# * RIO::Doc::SYNOPSIS
-# * RIO::Doc::INTRO
-# * RIO::Doc::HOWTO
-# * RIO::Doc::EXAMPLES
-# * RIO::Rio
-#
-
-
 module RIO
   module IF
     module GrandeStream
@@ -91,9 +78,9 @@ module RIO
 
       # Sets the rio to read bytes and returns the rio
       #
-      # _n_ specifies the number of bytes to be returned on each iteration of IF::Grande#each or by IF::GrandeStream#getrec. If _args_
+      # _n_ specifies the number of bytes to be returned on each iteration of {#each}[rdoc-ref:IF::Grande#each] or by {#getrec}[rdoc-ref:IF::GrandeStream#getrec]. If _args_
       # are provided, they are treated as record selectors as if <tt>ario.bytes(n).records(*args)</tt> had been
-      # called. See also #records, #lines, IF::Grande#each, IF::Grande#[]
+      # called. See also #records, #lines, {#each}[rdoc-ref:IF::Grande#each], {#[]}[link:RIO/IF/Grande.html#method-i-5B-5D]
       # 
       # If called with a block behaves as if <tt>ario.bytes(n,*args).each(&block)</tt> had been called
       # 
@@ -115,7 +102,7 @@ module RIO
       def bytes(n=1,*args,&block) target.bytes(n,*args,&block); self end
 
 
-      # Specifies which records will be iterated through by IF::Grande#each or returned by IF::GrandeStream#getrec
+      # Specifies which records will be iterated through by {#each}[rdoc-ref:IF::Grande#each] or returned by {#getrec}[rdoc-ref:IF::GrandeStream#getrec]
       # 
       # If called with a block behaves as if <tt>records(*args).each(&block)</tt> had been called
       # 
@@ -123,11 +110,11 @@ module RIO
       #
       # If no args are provided, all records are selected. 
       # What constitutes a record is affected by #lines,#bytes,
-      # and extensions such as IF::CSV#csv and IF::YAML#yaml.
+      # and extensions such as {#csv}[rdoc-ref:IF::CSV#csv] and {#yaml}[rdoc-ref:IF::YAML#yaml].
       #
       # If args are provided they may be one or more of the following:
-      # Regexp::  any matching record will be iterated over by IF::Grande#each or returned by IF::GrandeStream#getrec
-      # Integer:: specifies a record-number (zero-based) to be iterated over by IF::Grande#each or returned by IF::GrandeStream#getrec
+      # Regexp::  any matching record will be iterated over by {#each}[rdoc-ref:IF::Grande#each] or returned by {#getrec}[rdoc-ref:IF::GrandeStream#getrec]
+      # Integer:: specifies a record-number (zero-based) to be iterated over by {#each}[rdoc-ref:IF::Grande#each] or returned by {#getrec}[rdoc-ref:IF::GrandeStream#getrec]
       # Range::   specifies a range of records (zero-based) to included in the iteration
       # Proc::    a proc which will be called for each record, records are included unless nil or false is returned
       # Symbol::  a symbol which will _sent_ to each record, records are included unless nil or false is returned
@@ -157,17 +144,17 @@ module RIO
       def records(*args,&block) target.records(*args,&block); self end
 
 
-      # Specifies records which should *not* be iterated through by IF::Grande#each or returned by IF::GrandeStream#getrec
+      # Specifies records which should *not* be iterated through by {#each}[rdoc-ref:IF::Grande#each] or returned by {#getrec}[rdoc-ref:IF::GrandeStream#getrec]
       # 
       # If called with a block behaves as if <tt>skiprecords(*args).each(&block)</tt>
       # had been called
       # 
       # Returns the Rio
       #
-      # See also #records, #skiplines, #lines, IF::Grande#skip
+      # See also #records, #skiplines, #lines, {#skip}[rdoc-ref:IF::Grande#skip]
       #
       # If no args are provided, no records are rejected. What constitutes a record is affected by #lines,#bytes,
-      # and extensions such as IF::CSV#csv and IF::YAML#yaml.
+      # and extensions such as {#csv}[rdoc-ref:IF::CSV#csv] and {#yaml}[rdoc-ref:IF::YAML#yaml].
       #
       # If args are provided they may be one or more of the following:
       # Regexp::  any matching record will not be processed
@@ -189,14 +176,14 @@ module RIO
       def skiprecords(*args,&block) target.skiprecords(*args,&block); self end
 
 
-      # Sets the Rio to read lines and specifies lines which should *not* be iterated through by IF::Grande#each or 
-      # returned by IF::GrandeStream#getrec
+      # Sets the Rio to read lines and specifies lines which should *not* be iterated through by {#each}[rdoc-ref:IF::Grande#each] or 
+      # returned by {#getrec}[rdoc-ref:IF::GrandeStream#getrec]
       # 
       # If called with a block behaves as if <tt>skiplines(*args).each(&block)</tt> had been called
       # 
       # Returns the Rio
       #
-      # See also #lines, #records, IF::Grande#skip
+      # See also #lines, #records, {#skip}[rdoc-ref:IF::Grande#skip]
       #
       # If no args are provided, no lines are rejected.
       #
@@ -217,36 +204,36 @@ module RIO
 
 
       # Sets the Rio to read rows and specifies rows which should be iterated through 
-      # by IF::Grande#each or returned by IF::GrandeStream#getrec.
+      # by {#each}[rdoc-ref:IF::Grande#each] or returned by {#getrec}[rdoc-ref:IF::GrandeStream#getrec].
       # #rows is intended for use by extensions, where the concept of a row is reasonable. 
       # In the absensence of an extension behaves like #records.
       def rows(*args,&block) target.rows(*args,&block); self end
 
 
       # Sets the Rio to read rows and specifies lines which should *not* be iterated 
-      # through by IF::Grande#each or returned by IF::GrandeStream#getrec
+      # through by {#each}[rdoc-ref:IF::Grande#each] or returned by {#getrec}[rdoc-ref:IF::GrandeStream#getrec]
       # #skiprows is intended for use by extensions, where the concept of a row is 
       # reasonable. In the absence of an extension behaves like #skiprecords
       def skiprows(*args,&block) target.skiprows(*args,&block); self end
 
 
-      # Temporarily set the Rio to read records, and call IF::Grande#get
+      # Temporarily set the Rio to read records, and call {#get}[rdoc-ref:IF::Grande#get]
       #
-      # See also IF::GrandeStream#records, IF::GrandeStream#lines, IF::Grande#each, IF::Grande#[]
+      # See also {#records}[rdoc-ref:IF::GrandeStream#records], {#lines}[rdoc-ref:IF::GrandeStream#lines], {#each}[rdoc-ref:IF::Grande#each], {#[]}[link:RIO/IF/Grande.html#method-i-5B-5D]
       #
       def getrec() target.getrec() end
 
 
-      # Temporarily set the Rio to read rows, and call IF::Grande#get
+      # Temporarily set the Rio to read rows, and call {#get}[rdoc-ref:IF::Grande#get]
       #
-      # See also IF::GrandeStream#rows, IF::GrandeStream#lines, IF::Grande#each, IF::Grande#[]
+      # See also {#rows}[rdoc-ref:IF::GrandeStream#rows], {#lines}[rdoc-ref:IF::GrandeStream#lines], {#each}[rdoc-ref:IF::Grande#each], {#[]}[link:RIO/IF/Grande.html#method-i-5B-5D]
       #
       def getrow() target.getrow() end
 
 
-      # Temporarily set the Rio to read lines, and call IF::Grande#get
+      # Temporarily set the Rio to read lines, and call {#get}[rdoc-ref:IF::Grande#get]
       #
-      # See also IF::GrandeStream#records, IF::GrandeStream#lines, IF::Grande#each, IF::Grande#[]
+      # See also {#records}[rdoc-ref:IF::GrandeStream#records], {#lines}[rdoc-ref:IF::GrandeStream#lines], {#each}[rdoc-ref:IF::Grande#each], {#[]}[link:RIO/IF/Grande.html#method-i-5B-5D]
       #
       def getline() target.getline() end
 
@@ -269,13 +256,13 @@ module RIO
       # Rios normally don't need to be opened or have their open mode specified. A Rio determines the mode
       # based on the file system object and on the action specified. For instance when a Rio encounters
       # a +read+ on a file it opens the file for reading using File#open and calls IO#read; when it encounters
-      # a +read+ on a directory it knows to use Dir#open and call Dir#read. When it encounters a IF::RubyIO#puts, it knows
+      # a +read+ on a directory it knows to use Dir#open and call Dir#read. When it encounters a {#puts}[rdoc-ref:IF::RubyIO#puts], it knows
       # to perform a File#open, and call IO#puts on the returned handle. By default when a method requires
       # a file be opened for writing the file is opened with a mode of 'w'. #a changes this implicit 
       # output mode to 'a'. 
       #
       # Note that this is not the same as setting the output mode *explicitly*, as in rio('afile').mode('a').
-      # When the mode is set explicitly using IF::RubyIO#mode, the mode specified will be used regardless of
+      # When the mode is set explicitly using {#mode}[rdoc-ref:IF::RubyIO#mode], the mode specified will be used regardless of
       # the operation being performed. The #a method only affects how Rio opens a file when
       # it sees an operator that requires writing, and must determine for itself how to open it.
       #
@@ -372,7 +359,7 @@ module RIO
       #
       # +closeoneof+ causes a Rio to be closed automatically whenever the end of
       # file is reached. This affects# all methods that read from 
-      # a rio (IF::RubyIO#readlines, #to_a, IF::Grande#each IF::RubyIO#gets etc.)
+      # a rio ({#readlines}[rdoc-ref:IF::RubyIO#readlines], #to_a, {#each}[rdoc-ref:IF::Grande#each] {#gets}[rdoc-ref:IF::RubyIO#gets] etc.)
       # Because +closeoneof+ must be on for many of Rio's most useful idioms,
       # it is on by default. +closeoneof+ can be turned off using #nocloseoneof.
       # 
@@ -473,7 +460,7 @@ module RIO
       # 
       #  dest = rio('destfile')
       #  dest.print(rio('srcfile').contents)
-      #  dest.closed?   #=> false (IF::RubyIO#print is not a copy operator)
+      #  dest.closed?   #=> false ({#print}[rdoc-ref:IF::RubyIO#print] is not a copy operator)
       #  dest.close
       #
       #
@@ -486,7 +473,7 @@ module RIO
       #    file < a_string
       #    file.closed?  #=> false
       #  }
-      #  # The file is now closed. See IF::GrandeStream#rio for more informatioin
+      #  # The file is now closed. See {#rio}[rdoc-ref:IF::GrandeStream#rio] for more informatioin
       # 
       # ==== Why?
       #
@@ -671,7 +658,7 @@ module RIO
       #  
       #  rio('/etc/passwd').split(':').columns(0,2).to_a #=> [[user1,uid1],[user2,uid2]]
       #
-      # See also IF::Grande#split
+      # See also {#split}[rdoc-ref:IF::Grande#split]
       #  
       def splitlines(*args,&block) target.splitlines(*args,&block) end
 

data/lib/rio/if/internal.rb

@@ -1,6 +1,6 @@
 #--
-# =============================================================================== 
-# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
+# ===========================================================================
+# Copyright (c) 2005-2012 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -18,22 +18,9 @@
 # You should have received a copy of the GNU General Public License
 # along with Rio; if not, write to the Free Software
 # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-# =============================================================================== 
+# =========================================================================== 
 #++
 #
-# To create the documentation for Rio run the command
-#  ruby build_doc.rb
-# from the distribution directory.
-#
-# Suggested Reading
-# * RIO::Doc::SYNOPSIS
-# * RIO::Doc::INTRO
-# * RIO::Doc::HOWTO
-# * RIO::Doc::EXAMPLES
-# * RIO::Rio
-#
-
-
 module RIO
   class Rio
     # This is an internal function and is not needed in client code.
@@ -52,6 +39,18 @@ module RIO
       target.rl() 
     end
 
+    # This is an internal function and is not needed in client code.
+    # It assigns the internal 'Rio Resource Locator' object.
+    def rl=(arg) # :nodoc:
+      target.rl = arg 
+    end
+
+    # This is an internal function and is not needed in client code.
+    # It returns the internal URI object.
+    def uri() # :nodoc:
+      target.uri() 
+    end
+
     # This is an internal function and is not needed in client code.
     # It returns the internal 'Rio Resource Locator' object.
     def to_rl() # :nodoc:

data/lib/rio/if/path.rb

@@ -1,6 +1,7 @@
+# -*- coding: utf-8 -*-
 #--
-# =============================================================================== 
-# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
+# ===========================================================================
+# Copyright (c) 2005-2012 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -18,22 +19,9 @@
 # You should have received a copy of the GNU General Public License
 # along with Rio; if not, write to the Free Software
 # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-# =============================================================================== 
+# =========================================================================== 
 #++
 #
-# To create the documentation for Rio run the command
-#  ruby build_doc.rb
-# from the distribution directory.
-#
-# Suggested Reading
-# * RIO::Doc::SYNOPSIS
-# * RIO::Doc::INTRO
-# * RIO::Doc::HOWTO
-# * RIO::Doc::EXAMPLES
-# * RIO::Rio
-#
-
-
 module RIO
   module IF
     module Path
@@ -42,8 +30,8 @@ module RIO
       # Returns the path for the Rio, which is defined differently for different types of Rios.
       #
       # For Rios representing paths on the underlying file system this is an alias 
-      # IF::Path#fspath. For Rios with paths that are not on the file system this is an
-      # alias for IF::Path#urlpath.
+      # {#fspath}[rdoc-ref:IF::Path#fspath]. For Rios with paths that are not on the file system this is an
+      # alias for {#urlpath}[rdoc-ref:IF::Path#urlpath].
       # 
       # Otherwise this returns nil.
       # 
@@ -80,9 +68,9 @@ module RIO
       # Converts a pathname to an absolute pathname. 
       # Relative paths are referenced from the current working directory of the process 
       # unless dir_string is given, in which case it will be used as the starting point. 
-      # The given pathname may start with a ``~��, which expands to the process owner�s 
+      # The given pathname may start with a ``~��, which expands to the process owner�s 
       # home directory (the environment variable HOME must be set correctly). 
-      # ``~user�� expands to the named user�s home directory.
+      # ``~user�� expands to the named user�s home directory.
       #
       # Returns a Rio representing the returned path
       #
@@ -105,18 +93,18 @@ module RIO
 
 
       # Returns a new Rio whose path is the base path that is used by 
-      # IF::Path#abs to create an absolute Rio from a relative one.
+      # {#abs}[rdoc-ref:IF::Path#abs] to create an absolute Rio from a relative one.
       #
       #  rio('/tmp').chdir
       #  rio('afile').base # => rio('/tmp/')
       #
-      # See IF::Path#abs.
+      # See {#abs}[rdoc-ref:IF::Path#abs].
       #
       def base() target.base()  end
 
 
       # Sets the string that the Rio considers an extension. The value will be used by
-      # subsequent calls to IF::Path#basename. If called with no arguments resets its value
+      # subsequent calls to {#basename}[rdoc-ref:IF::Path#basename]. If called with no arguments resets its value
       # to the value returned by File#extname. Returns the Rio.
       #
       #  ario = rio('afile.tar.gz')
@@ -131,25 +119,25 @@ module RIO
       #  ario.ext.basename                #=> rio('afile')
       #  ario.ext('').basename            #=> rio('afile.txt')
       #
-      # See also IF::Path#ext?,IF::Path#noext,IF::Path#basename,
+      # See also {#ext?}[rdoc-ref:IF::Path#ext?],{#noext}[rdoc-ref:IF::Path#noext],{#basename}[rdoc-ref:IF::Path#basename],
       #
       def ext(arg=nil) target.ext(arg); self end
 
 
-      # Identical to IF::Path#ext('')
+      # Identical to {#ext}[rdoc-ref:IF::Path#ext]('')
       #
       #  ario.basename                  #=> rio('afile')
       #  ario.noext.basename            #=> rio('afile.txt')
       #
-      # See also IF::Path#ext
+      # See also {#ext}[rdoc-ref:IF::Path#ext]
       #
       def noext() target.noext(); self end
 
 
       # Returns the value of the Rio's 'ext' variable
-      # This defaults to the value returned by IF::Path#extname and may be set by either calling IF::Path#ext 
-      # or by passing an argument IF::Path#basename
-      # See also IF::Path#basename, IF::Path#ext, IF::Path#extname, IF::Path#noext
+      # This defaults to the value returned by {#extname}[rdoc-ref:IF::Path#extname] and may be set by either calling {#ext}[rdoc-ref:IF::Path#ext] 
+      # or by passing an argument {#basename}[rdoc-ref:IF::Path#basename]
+      # See also {#basename}[rdoc-ref:IF::Path#basename], {#ext}[rdoc-ref:IF::Path#ext], {#extname}[rdoc-ref:IF::Path#extname], {#noext}[rdoc-ref:IF::Path#noext]
       #
       #  ario = rio('afile.txt')
       #  ario.ext?                        #=> '.txt'
@@ -187,7 +175,7 @@ module RIO
       #  rio('afile.txt').basename('.txt')                    #=> same thing
       #  rio('afile.txt').ext('.txt').basename                #=> same thing
       #
-      # See also IF::Path#ext,IF::Path#ext?,IF::Path#filename,
+      # See also {#ext}[rdoc-ref:IF::Path#ext],{#ext?}[rdoc-ref:IF::Path#ext?],{#filename}[rdoc-ref:IF::Path#filename],
       #
       def basename(*args) target.basename(*args) end
 
@@ -201,14 +189,14 @@ module RIO
 
 
       # Returns a new Rio with all path information stripped away. This is similar to
-      # IF::Path#basename, except that it always includes an extension if one exists
+      # {#basename}[rdoc-ref:IF::Path#basename], except that it always includes an extension if one exists
       #
       #  rio('apath/afile.txt').filename #=> rio('afile.txt')
       #
       def filename() target.filename() end
 
 
-      # Replace the part of the path returned by IF::Path#extname. If in +rename+
+      # Replace the part of the path returned by {#extname}[rdoc-ref:IF::Path#extname]. If in +rename+
       # mode, also renames the referenced filesystem object.
       #
       # Returns the extension
@@ -218,12 +206,12 @@ module RIO
       #
       #   rio('adir/afile.txt').rename.extname  = '.rb'      # adir/afile.txt => adir/afile.rb
       #
-      # See aslo IF::Path#extname, IF::FileOrDir#rename
+      # See aslo {#extname}[rdoc-ref:IF::Path#extname], {#rename}[rdoc-ref:IF::FileOrDir#rename]
       #
       def extname=(arg) target.extname = arg end
 
 
-      # Replace the part of the path returned by IF::Path#basename. If in +rename+
+      # Replace the part of the path returned by {#basename}[rdoc-ref:IF::Path#basename]. If in +rename+
       # mode, also renames the referenced filesystem object.
       # 
       # Returns the new value of +basename+
@@ -239,12 +227,12 @@ module RIO
       #   rio('adir/afile.txt').rename.extname  = '.rb'      # adir/afile.txt => adir/afile.rb
       #   rio('adir/afile.txt').rename.dirname =  'b/c'      # adir/afile.txt => b/c/afile.txt
       #
-      # See IF::Path#basename, IF::FileOrDir#rename
+      # See {#basename}[rdoc-ref:IF::Path#basename], {#rename}[rdoc-ref:IF::FileOrDir#rename]
       #
       def basename=(arg) target.basename = arg end
 
 
-      # Replace the part of the path returned by IF::Path#dirname. If in +rename+
+      # Replace the part of the path returned by {#dirname}[rdoc-ref:IF::Path#dirname]. If in +rename+
       # mode, also renames the referenced filesystem object.
       # 
       # Returns the new value of +dirname+
@@ -260,13 +248,13 @@ module RIO
       #   rio('adir/afile.txt').rename.extname  = '.rb'      # adir/afile.txt => adir/afile.rb
       #   rio('adir/afile.txt').rename.dirname =  'b/c'      # adir/afile.txt => b/c/afile.txt
       #
-      # See IF::Path#dirname, IF::FileOrDir#rename
+      # See {#dirname}[rdoc-ref:IF::Path#dirname], {#rename}[rdoc-ref:IF::FileOrDir#rename]
       #
       def dirname=(arg) target.dirname  = arg end
 
 
 
-      # Replace the part of the path returned by IF::Path#filename. If in +rename+
+      # Replace the part of the path returned by {#filename}[rdoc-ref:IF::Path#filename]. If in +rename+
       # mode, also renames the referenced filesystem object.
       # 
       # Returns the new value of +filename+
@@ -282,7 +270,7 @@ module RIO
       #   rio('adir/afile.txt').rename.extname  = '.rb'      # adir/afile.txt => adir/afile.rb
       #   rio('adir/afile.txt').rename.dirname =  'b/c'      # adir/afile.txt => b/c/afile.txt
       #
-      # See IF::Path#filename, IF::FileOrDir#rename
+      # See {#filename}[rdoc-ref:IF::Path#filename], {#rename}[rdoc-ref:IF::FileOrDir#rename]
       #
       def filename=(arg) target.filename = arg end
 
@@ -315,14 +303,14 @@ module RIO
       #  ary[1] = rio('d')
       #  ary.to_rio           #=> rio('a/d/c')
       #
-      # See also IF::Path#join, IF::Path#/
+      # See also {#join}[rdoc-ref:IF::Path#join], IF::Path#/
       #
       def splitpath() target.splitpath() end
 
 
       # Subdirectory operator.
       #
-      # Effectively the same as IF::Path#join(arg)
+      # Effectively the same as {#join}[rdoc-ref:IF::Path#join](arg)
       #
       #   a = rio('a')
       #   b = rio('b')
@@ -352,11 +340,11 @@ module RIO
       #def catpath(*args) target.catpath(*args) end
 
 
-      # Changes a Rio inplace by adding args as additional directory components like IF::Path#join,
+      # Changes a Rio inplace by adding args as additional directory components like {#join}[rdoc-ref:IF::Path#join],
       #
       def join!(*args) target.join!(*args); self end
 
-      # IF::GrandeStream#rootpath
+      # {#rootpath}[rdoc-ref:IF::GrandeStream#rootpath]
       #
       #
       def rootpath(*args) # :nodoc:
@@ -364,7 +352,7 @@ module RIO
       end
 
 
-      # IF::GrandeStream#root
+      # {#root}[rdoc-ref:IF::GrandeStream#root]
       #
       #
       ##def root(*args,&block) target.root(*args,&block) end
@@ -376,7 +364,7 @@ module RIO
       ##def cwd(*args,&block) target.cwd(*args,&block) end
 
 
-      # IF::Grande#getwd
+      # {#getwd}[rdoc-ref:IF::Grande#getwd]
       #
       #
       ##def getwd(*args,&block) target.getwd(*args,&block) end
@@ -420,14 +408,14 @@ module RIO
       # Calls URI#route_from
       #
       # Returns a new rio representing the path to this Rio from the perspective of _other_.
-      # URI#route_from requires that absolute URIs be used. IF::Path#route_from does not.
+      # URI#route_from requires that absolute URIs be used. {#route_from}[rdoc-ref:IF::Path#route_from] does not.
       #
       def route_from(other) target.route_from(other)  end
 
       # Calls URI#route_to
       #
       # Returns a new rio representing the path to _other_ from the perspective of this Rio.
-      # URI#route_to requires that absolute URIs be used. IF::Path#route_to does not.
+      # URI#route_to requires that absolute URIs be used. {#route_to}[rdoc-ref:IF::Path#route_to] does not.
       #
       def route_to(other) target.route_to(other)  end