ruby-changes:27065
From: zzak <ko1@a...>
Date: Wed, 6 Feb 2013 23:33:38 +0900 (JST)
Subject: [ruby-changes:27065] zzak:r39117 (trunk): * doc/pty/README.expect: Removed static documentation file
zzak 2013-02-06 23:31:32 +0900 (Wed, 06 Feb 2013) New Revision: 39117 http://svn.ruby-lang.org/cgi-bin/viewvc.cgi?view=rev&revision=39117 Log: * doc/pty/README.expect: Removed static documentation file * ext/pty/lib/expect.rb: Documentation for IO#expect Removed files: trunk/doc/pty/README.expect Modified files: trunk/ChangeLog trunk/ext/pty/lib/expect.rb Index: doc/pty/README.expect =================================================================== --- doc/pty/README.expect (revision 39116) +++ doc/pty/README.expect (revision 39117) @@ -1,22 +0,0 @@ https://github.com/ruby/ruby/blob/trunk/doc/pty/README.expect#L0 - README for expect - by A. Ito, 28 October, 1998 - - Expect library adds IO class a method called expect(), which -does similar act to tcl's expect extension. - -The usage of the method is: - - IO#expect(pattern,timeout=9999999) - -where `pattern' is an instance of String or Regexp and `timeout' -is Fixnum, which can be omitted. - When the method is called without block, it waits until the -input which matches the pattern is obtained from the IO or the time -specified as the timeout passes. When the pattern is obtained from the -IO, the method returns an array. The first element of the array is the -entire string obtained from the IO until the pattern matches. The -following elements indicates the specific pattern which matched to the -anchor in the regular expression. If the method ends because of -timeout, it returns nil. - When the method is called with block, the array is passed as -the block parameter. Index: ChangeLog =================================================================== --- ChangeLog (revision 39116) +++ ChangeLog (revision 39117) @@ -1,3 +1,8 @@ https://github.com/ruby/ruby/blob/trunk/ChangeLog#L1 +Wed Feb 6 23:30:00 2013 Zachary Scott <zachary@z...> + + * doc/pty/README.expect: Removed static documentation file + * ext/pty/lib/expect.rb: Documentation for IO#expect + Wed Feb 6 22:25:00 2013 Charlie Somerville <charlie@c...> * hash.c (env_reject_bang): hide keys array from ObjectSpace Index: ext/pty/lib/expect.rb =================================================================== --- ext/pty/lib/expect.rb (revision 39116) +++ ext/pty/lib/expect.rb (revision 39117) @@ -1,10 +1,30 @@ https://github.com/ruby/ruby/blob/trunk/ext/pty/lib/expect.rb#L1 $expect_verbose = false +# Expect library adds the IO instance method #expect, which does similar act to +# tcl's expect extension. +# +# In order to use this method, you must require expect: +# +# require 'expect' +# +# Please see #expect for usage. class IO - # Reads from the IO until pattern +pat+ matches or the +timeout+ is over. + # call-seq: + # IO#expect(pattern,timeout=9999999) -> Array + # IO#expect(pattern,timeout=9999999) { |result| ... } -> nil + # + # Reads from the IO until the given +pattern+ matches or the +timeout+ is over. + # # It returns an array with the read buffer, followed by the matches. # If a block is given, the result is yielded to the block and returns nil. # + # When called without a block, it waits until the input that matches the + # given +pattern+ is obtained from the IO or the time specified as the + # timeout passes. An array is returned when the pattern is obtained from the + # IO. The first element of the array is the entire string obtained from the + # IO until the pattern matches, followed by elements indicating which the + # pattern which matched to the anchor in the regular expression. + # # The optional timeout parameter defines, in seconds, the total time to wait # for the pattern. If the timeout expires or eof is found, nil is returned # or yielded. However, the buffer in a timeout session is kept for the next -- ML: ruby-changes@q... Info: http://www.atdot.net/~ko1/quickml/