diff options
author | gsinclair <gsinclair@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2003-08-21 09:07:57 +0000 |
---|---|---|
committer | gsinclair <gsinclair@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2003-08-21 09:07:57 +0000 |
commit | f3f7c40c492b791eecae4980eb817eb1aae02442 (patch) | |
tree | 844775c08c836e280e9e434f4c1fed8dc9dab59e /lib/net/ftp.rb | |
parent | ed8152d68cd47d4f481c6cc6055bd5a56cfe8fd5 (diff) |
Small changes to documentation; mainly hiding things from RDoc.
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@4417 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Diffstat (limited to 'lib/net/ftp.rb')
-rw-r--r-- | lib/net/ftp.rb | 28 |
1 files changed, 22 insertions, 6 deletions
diff --git a/lib/net/ftp.rb b/lib/net/ftp.rb index 585c14b004..3baa5d02e7 100644 --- a/lib/net/ftp.rb +++ b/lib/net/ftp.rb @@ -14,13 +14,15 @@ require "socket" require "monitor" -module Net +module Net # :nodoc: + # :stopdoc: class FTPError < StandardError; end class FTPReplyError < FTPError; end - class FTPTempError < FTPError; end - class FTPPermError < FTPError; end + class FTPTempError < FTPError; end + class FTPPermError < FTPError; end class FTPProtoError < FTPError; end + # :startdoc: # # This class implements the File Transfer Protocol. If you have used a @@ -31,6 +33,8 @@ module Net # == Example # # require 'net/ftp' + # + # === Example 1 # # ftp = Net::FTP.new('ftp.netlab.co.jp') # ftp.login @@ -39,6 +43,15 @@ module Net # ftp.getbinaryfile('nif.rb-0.91.gz', 'nif.gz', 1024) # ftp.close # + # === Example 2 + # + # Net::FTP.open('ftp.netlab.co.jp') do |ftp| + # ftp.login + # files = ftp.chdir('pub/lang/ruby/contrib') + # files = ftp.list('n*') + # ftp.getbinaryfile('nif.rb-0.91.gz', 'nif.gz', 1024) + # end + # # == Major Methods # # The following are the methods most likely to be useful to users: @@ -56,10 +69,11 @@ module Net class FTP include MonitorMixin + # :stopdoc: FTP_PORT = 21 CRLF = "\r\n" - DEFAULT_BLOCKSIZE = 4096 + # :startdoc: # When +true+, transfers are performed in binary mode. Default: +true+. attr_accessor :binary @@ -123,11 +137,13 @@ module Net end end + # Obsolete def return_code $stderr.puts("warning: Net::FTP#return_code is obsolete and do nothing") return "\n" end + # Obsolete def return_code=(s) $stderr.puts("warning: Net::FTP#return_code= is obsolete and do nothing") end @@ -524,7 +540,7 @@ module Net # data in +blocksize+ chunks. # def putbinaryfile(localfile, remotefile = File.basename(localfile), - blocksize = DEFAULT_BLOCKSIZE, &block) # :yield: line/data + blocksize = DEFAULT_BLOCKSIZE, &block) # :yield: data if @resume begin rest_offset = size(remotefile) @@ -670,7 +686,7 @@ module Net return resp[3..-1].strip.to_i end - MDTM_REGEXP = /^(\d\d\d\d)(\d\d)(\d\d)(\d\d)(\d\d)(\d\d)$/ + MDTM_REGEXP = /^(\d\d\d\d)(\d\d)(\d\d)(\d\d)(\d\d)(\d\d)$/ # :nodoc: # # Returns the last modification time of the (remote) file. If +local+ is |