drbrain	2011-10-08 03:21:01 +0900 (Sat, 08 Oct 2011)

  New Revision: 33427

  http://svn.ruby-lang.org/cgi-bin/viewvc.cgi?view=rev&revision=33427

  Log:
    * lib/shell.rb:  Document some methods of Shell.  Patch by Carol
      Nichols.  [Ruby 1.9 - Bug #5417]

  Modified files:
    trunk/ChangeLog
    trunk/lib/shell.rb

Index: ChangeLog
===================================================================
--- ChangeLog	(revision 33426)
+++ ChangeLog	(revision 33427)
@@ -1,3 +1,8 @@
+Sat Oct  8 03:17:51 2011  Eric Hodel  <drbrain@s...>
+
+	* lib/shell.rb:  Document some methods of Shell.  Patch by Carol
+	  Nichols.  [Ruby 1.9 - Bug #5417]
+
 Fri Oct  7 17:54:28 2011  Nobuyoshi Nakada  <nobu@r...>
 
 	* lib/test/unit/assertions.rb (assert_send, assert_not_send):
Index: lib/shell.rb
===================================================================
--- lib/shell.rb	(revision 33426)
+++ lib/shell.rb	(revision 33427)
@@ -19,6 +19,7 @@
 require "shell/command-processor"
 require "shell/process-controller"
 
+# Shell implements an idiomatic Ruby interface for common UNIX shell commands.
 class Shell
   @RCS_ID='-$Id: shell.rb,v 1.9 2002/03/04 12:01:10 keiju Exp keiju $-'
 
@@ -51,10 +52,25 @@
       @verbose = val if val
     end
 
+    # Creates a new Shell instance with the current working directory
+    # set to +path+.
     def cd(path)
       new(path)
     end
 
+    # Returns the directories in the current shell's PATH environment variable
+    # as an array of directory names. This sets the system_path for all
+    # instances of Shell.
+    #
+    # Example: If in your current shell, you did:
+    #
+    #   $ echo $PATH
+    #   /usr/bin:/bin:/usr/local/bin
+    #
+    # Running this method in the above shell would then return:
+    #
+    #   ["/usr/bin", "/bin", "/usr/local/bin"]
+    #
     def default_system_path
       if @default_system_path
         @default_system_path
@@ -63,6 +79,10 @@
       end
     end
 
+    # Sets the system_path that new instances of Shell should have as their
+    # initial system_path.
+    #
+    # +path+ should be an array of directory name strings.
     def default_system_path=(path)
       @default_system_path = path
     end
@@ -104,6 +124,9 @@
 
   attr_reader :system_path
 
+  # Sets the system path (the Shell instance's PATH environment variable).
+  #
+  # +path+ should be an array of directory name strings.
   def system_path=(path)
     @system_path = path
     rehash
@@ -139,6 +162,7 @@
   # Shell#mkdir
   # Shell#rmdir
 
+  # Returns the current working directory.
   attr_reader :cwd
   alias dir cwd
   alias getwd cwd

--
ML: ruby-changes@q...
Info: http://www.atdot.net/~ko1/quickml/