lib/rio/constructor.rb in rio-0.3.1 vs lib/rio/constructor.rb in rio-0.3.2

@@ -133,9 +133,26 @@
   #
   # <tt>rio(??)</tt> (mnemonic: '?' you don't know its name)
   #  rio(??)
   #  rio(??,basename='rio',tmpdir=Dir::tmpdir)
   #
+  # To create a temporary object that will become a file
+  # or a directory, depending on how you use it:
+  #  rio(??)
+  #  rio(??,basename='rio',tmpdir=Dir::tmpdir)
+  #
+  # To force it to become a file
+  #  rio(??).file
+  # or just write to it.
+  #
+  # To force it to become a directory:
+  #  rio(??).dir
+  # or
+  #  rio(??).mkdir
+  # or
+  #  rio(??).chdir
+  #
+  #
   # ===== Creating a Rio that refers to an arbitrary TCPSocket
   #
   #  rio('tcp:',hostname,port)
   # or
   #  rio('tcp://hostname:port')