summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authoraamine <aamine@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>2002-03-26 11:17:13 +0000
committeraamine <aamine@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>2002-03-26 11:17:13 +0000
commit04168e7e3e4bc412c16c68f565b84dca5cdf93a7 (patch)
tree41be9a448a7a003ce68f27460bfd2d0b3ff0a3e4
parentce0de3f67b573957d15e8945784a0d4413c32734 (diff)
* doc/net/protocol.rd.ja, smtp.rd.ja, pop.rd.ja: removed.
* MANIFEST: remove doc/net/* entries. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@2289 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
-rw-r--r--ChangeLog6
-rw-r--r--doc/net/http.rd.ja433
-rw-r--r--doc/net/pop.rd.ja326
-rw-r--r--doc/net/smtp.rd.ja194
4 files changed, 6 insertions, 953 deletions
diff --git a/ChangeLog b/ChangeLog
index b1d84a9039..c7b82920a7 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+Tue Mar 26 20:25:28 2002 Minero Aoki <[email protected]>
+
+ * doc/net/protocol.rd.ja, smtp.rd.ja, pop.rd.ja: removed.
+
+ * MANIFEST: remove doc/net/* entries.
+
Tue Mar 26 18:45:15 2002 WATANABE Hirofumi <[email protected]>
* configure.in (FILE_READPTR): check bufread instead of bufend
diff --git a/doc/net/http.rd.ja b/doc/net/http.rd.ja
deleted file mode 100644
index 1bdb898b80..0000000000
--- a/doc/net/http.rd.ja
+++ /dev/null
@@ -1,433 +0,0 @@
-=begin
-
-= net/http.rb
-
-== ���Υ饤�֥��ˤĤ���
-
-���ѥǡ���ž���ץ��ȥ��� HTTP �򰷤��饤�֥��Ǥ���
-������ [RFC2616] ((<URL:http://www.ietf.org/rfc/rfc2616.txt>)) ��
-�𤤤Ƥ��ޤ���
-
-== ������
-
-=== �����֥����Ф���ɥ�����Ȥ����� (GET)
-
- require 'net/http'
- Net::HTTP.start( 'some.www.server', 80 ) {|http|
- response , = http.get('/index.html')
- puts response.body
- }
-
-�ޤ��ʲ���Ʊ����̣��û���񤤤���ΤǤ���
-
- require 'net/http'
- Net::HTTP.get_print 'some.www.server', '/index.html'
-
-=== �ե�����ξ������������ (POST)
-
- require 'net/http'
- Net::HTTP.start( 'some.www.server', 80 ) {|http|
- response , = http.post( '/cgi-bin/any.rhtml',
- 'querytype=subject&target=ruby' )
- }
-
-=== �ץ�������ͳ�Υ�������
-
-Net::HTTP �Υ��饹�᥽�å� Net::HTTP.Proxy �ϡ���˥ץ�������ͳ��
-��³����褦��ư��򤹤롢���������饹����������֤��ޤ������Υ��饹��
-Net::HTTP ��Ѿ����Ƥ���Τ� Net::HTTP ������Ʊ���褦�˻Ȥ��ޤ���
-
- require 'net/http'
-
- $proxy_addr = 'your.proxy.addr'
- $proxy_port = 8080
- :
- Net::HTTP::Proxy($proxy_addr, $proxy_port).start( 'some.www.server' ) {|http|
- # always connect to your.proxy.addr:8080
- :
- }
-
-�ޤ� Net::HTTP.Proxy ���������� nil ���� Net::HTTP ���Ȥ��֤��Τ�
-��Υ����ɤΤ褦�˽񤤤Ƥ����Хץ������ʤ��ξ��ˤ��б��Ǥ��ޤ���
-
-=== ������쥯�Ȥ��б�����
-
- require 'net/http'
- Net::HTTP.version_1_1
-
- host = 'www.ruby-lang.org'
- path = '/'
- begin
- Net::HTTP.start( host, 80 ) {|http|
- response , = http.get(path)
- print response.body
- }
- rescue Net::ProtoRetriableError => err
- if m = %r<http://([^/]+)>.match( err.response['location'] ) then
- host = m[1].strip
- path = m.post_match
- retry
- end
- end
-
-������Ǥ� URL ����ۥ���̾������Τˤ������������ˡ��ȤäƤ��ޤ�����
-���� URI ���饹��ɸ��ź�դˤʤ�Ф�äȴ�ñ�ˤʤ�Ϥ��Ǥ���
-
-=== Basic ǧ��
-
- require 'net/http'
-
- Net::HTTP.start( 'auth.some.domain' ) {|http|
- response , = http.get( '/need-auth.cgi',
- 'Authorization' => 'Basic ' + ["#{account}:#{password}"].pack('m').strip )
- print response.body
- }
-
-�С������ 1.2 (Ruby 1.7 �ʹߤ�ź��) �Ǥϼ��Τ褦�˽񤱤ޤ���
-
- require 'net/http'
-
- req = Net::HTTP::Get.new('/need-auth.cgi')
- req.basic_auth 'account', 'password'
- Net::HTTP.start( 'auth.some.domain' ) {|http|
- response = http.request(req)
- print response.body
- }
-
-== ���������ͤؤ��ѹ��Ȱܹ����֤ˤĤ���
-
-Ruby 1.6 �����äƤ���Τ� http.rb 1.1 �� 1.7 �ʹߤ� 1.2 �Ǥ�����
-���δ֤ǤϤ��ʤ��礭�����ͤ��Ѥ��ޤ��������������˻��ͤ��ѹ�
-����ΤǤʤ���ξ���μ�������¸������������ߤ��뤳�Ȥˤ��ޤ�����
-
-�᥽�å� HTTP.version_1_2��HTTP.version_1_1 ��Ƥ֤�
-���Τ��Ȥ���������� Net::HTTP ���֥������ȤϤ��줾���
-�С������λ��ͤ�ư���褦�ˤʤ�ޤ����ʲ��ϻ�����Ǥ���
-
- # example
- Net::HTTP.start {|http1| ...(http1 has 1.2 features)... }
-
- Net::HTTP.version_1_1
- Net::HTTP.start {|http2| ...(http2 has 1.1 features)... }
-
- Net::HTTP.version_1_2
- Net::HTTP.start {|http3| ...(http3 has 1.2 features)... }
-
-���ε�ǽ�ϥ���åɥ����դǤϤ���ޤ���
-
-== class Net::HTTP
-
-=== ���饹�᥽�å�
-
-: new( address, port = 80, proxy_addr = nil, proxy_port = nil )
- ������ HTTP ���֥������Ȥ��������ޤ���address �� HTTP �����С��� FQDN �ǡ�
- port ����³����ݡ����ֹ�Ǥ������Υ᥽�åɤǤϤޤ���³�Ϥ��ޤ���
-
- proxy_addr ��Ϳ����ȥץ�������𤷤���³���륪�֥������Ȥ��������ޤ���
-
-: start( address, port = 80, proxy_addr = nil, proxy_port = nil )
-: start( address, port = 80, proxy_addr = nil, proxy_port = nil ) {|http| .... }
- �ʲ���Ʊ���Ǥ���
-
- Net::HTTP.new(address, port, proxy_addr, proxy_port).start(&block)
-
-: get( address, path, port = 80 )
- �ۥ��� address �� port �֥ݡ��Ȥ���³���� path ��ɽ������
- ����ƥ��ƥ��������ʸ������֤��ޤ���
-
-: get_print( address, path, port = 80 )
- �ۥ��� address �� port �֥ݡ��Ȥ���³���� path ��ɽ������
- ����ƥ��ƥ����������������$stdout �� << �ǽ��Ϥ��ޤ���
-
-: Proxy( address, port = 80 )
- ��˻��ꤵ�줿�ץ���������³���륯�饹��������֤��ޤ���
- ���Υ��饹�� Net::HTTP ��Ѿ����Ƥ���Τ� Net::HTTP ������
- Ʊ���褦�˻Ȥ��ޤ���
-
- address �� nil �ΤȤ��� Net::HTTP ���饹�򤽤Τޤ��֤��ޤ���
-
- # example
- proxy_class = Net::HTTP::Proxy( 'proxy.foo.org', 8080 )
- :
- proxy_class.start( 'www.ruby-lang.org' ) {|http|
- # connecting proxy.foo.org:8080
- :
- }
-
-: proxy_class?
- ���Ȥ� (Proxy �᥽�åɤˤ�äƺ������줿) �ץ������ѤΥ��饹�ʤ�п���
-
-: port
- HTTP �Υǥե���ȥݡ��� (80)��
-
-=== �᥽�å�
-
-: start
-: start {|http| .... }
- TCP ���ͥ�������ĥ�ꡢHTTP ���å����򳫻Ϥ��ޤ���
- ���Ǥ˥��å���󤬳��Ϥ��Ƥ������㳰 IOError ��ȯ�����ޤ���
-
- ���ƥ졼���Ȥ��ƸƤФ줿���ϥ֥��å��δ֤������å�������³����
- �֥��å���λ�ȤȤ�˼�ưŪ�˥��å������Ĥ��ޤ���
-
-: active?
- HTTP ���å���󤬳��Ϥ���Ƥ����鿿��
-
-: address
- ��³���륢�ɥ쥹
-
-: port
- ��³����ݡ����ֹ�
-
-: open_timeout
-: open_timeout=(n)
- ��³�����Ԥĺ����ÿ��������ÿ����äƤ⥳�ͥ������
- �����ʤ�����㳰 TimeoutError ��ȯ�����ޤ���
-
-: read_timeout
-: read_timeout=(n)
- �ɤߤ��� (read(1) ���) �ǥ֥��å����Ƥ褤�����ÿ���
- �����ÿ����äƤ��ɤߤ���ʤ�����㳰 TimeoutError ��ȯ�����ޤ���
-
-: finish
- HTTP ���å�����λ���ޤ������å���󳫻����ˤ��Υ᥽�åɤ�
- �ƤФ줿�����㳰 IOError ��ȯ�����ޤ���
-
-: proxy?
- �ץ�������𤷤���³����ʤ鿿��
-
-: proxy_address
- �ץ�������ͳ����³���� HTTP ���֥������Ȥʤ�ץ������Υ��ɥ쥹��
- �����Ǥʤ��ʤ� nil��
-
-: proxy_port
- �ץ�������ͳ����³���� HTTP ���֥������Ȥʤ�ץ������Υݡ��ȡ�
- �����Ǥʤ��ʤ� nil��
-
-: get( path, header = nil )
-: get( path, header = nil ) {|str| .... }
- �����о�� path �ˤ��륨��ƥ��ƥ���������ޤ����ޤ� header �� nil
- �Ǥʤ���С��ꥯ�����Ȥ�����Ȥ��ˤ������Ƥ� HTTP �إå��Ȥ��ƽ�
- ���ߤޤ���header �ϥϥå���ǡ��֥إå�̾ => ���ơפΤ褦�ʷ�����
- �ʤ���Ф����ޤ���
-
- �֤��ͤϡ��С������ 1.1 �Ǥ� HTTPResponse �ȥ���ƥ��ƥ��ܥǥ�ʸ�����
- �����Ǥ�����Ǥ���1.2 �Ǥ� HTTPResponse �����ҤȤĤΤߤǤ������ξ�硢
- ����ƥ��ƥ��ܥǥ��� response.body �������ޤ���
-
- �֥��å��ȤȤ�˸ƤФ줿���ϥ���ƥ��ƥ��ܥǥ��򾯤��Ťĥ֥��å���
- Ϳ���ޤ���
-
- 1.1 �Ǥ� 3xx (�ƻ�Բ�ǽ�ʥ��顼)���Ф��Ƥ��㳰��ȯ�����ޤ������ξ��
- HTTPResponse ���㳰���֥������Ȥ��� err.response �����뤳�Ȥ��Ǥ��ޤ���
- ���� 1.2 �Ǥ������㳰��ȯ�����ޤ���
-
- # version 1.1 (bundled with Ruby 1.6)
- response, body = http.get( '/index.html' )
-
- # version 1.2 (bundled with Ruby 1.7 or later)
- response = http.get( '/index.html' )
-
- # compatible in both version
- response , = http.get( '/index.html' )
- response.body
-
- # using block
- File.open( 'save.txt', 'w' ) {|f|
- http.get( '/~foo/', nil ) do |str|
- f.write str
- end
- }
-
-: head( path, header = nil )
- �����о�� path �ˤ��륨��ƥ��ƥ��Υإå��Τߤ�������ޤ���
- �ޤ� header �� nil �Ǥʤ���Хꥯ�����Ȥ�����Ȥ��ˤ������Ƥ�
- HTTP �إå��Ȥ��ƽ񤭤��ߤޤ���header �ϥϥå���ǡ�
- �֥إå�̾ => ���ơפΤ褦�ʷ����Ǥʤ���Ф����ޤ���
-
- HTTPResponse ���֥������Ȥ��֤��ޤ���
-
- 1.1 �Ǥ� 3xx (�ƻ�Բ�ǽ�ʥ��顼)���Ф��Ƥ��㳰��ȯ�����ޤ������ξ��
- HTTPResponse ���㳰���֥������Ȥ��� err.response �����뤳�Ȥ��Ǥ��ޤ���
- ���� 1.2 �Ǥ������㳰��ȯ�����ޤ���
-
- response = nil
- Net::HTTP.start( 'some.www.server', 80 ) {|http|
- response = http.head( '/index.html' )
- }
- p response['content-type']
-
-: post( path, data, header = nil )
-: post( path, data, header = nil ) {|str| .... }
- �����о�� path �ˤ��륨��ƥ��ƥ����Ф�ʸ���� data ��
- ����ޤ����쥹�ݥ󥹤� << �᥽�åɤ�Ȥä� dest �˽�
- ���ޤ�ޤ���header �� get �᥽�åɤ�Ʊ���Ǥ���
- HTTPResponse ���֥������Ȥ� dest ��������֤��ޤ���
-
- ���ƥ졼���Ȥ��ƸƤӤ����줿�Ȥ��ϥ���ƥ��ƥ��ܥǥ��򾯤��Ť�
- �֥��å���Ϳ���ޤ���
-
- 1.1 �Ǥ� 3xx (�ƻ�Բ�ǽ�ʥ��顼)���Ф��Ƥ��㳰��ȯ�����ޤ������ξ��
- HTTPResponse ���㳰���֥������Ȥ��� err.response �����뤳�Ȥ��Ǥ��ޤ���
- ���� 1.2 �Ǥ������㳰��ȯ�����ޤ���
-
- # version 1.1
- response, body = http.post( '/cgi-bin/search.rb', 'query=subject&target=ruby' )
-
- # version 1.2
- response = http.post( '/cgi-bin/search.rb', 'query=subject&target=ruby' )
-
- # compatible in both version
- response , = http.post( '/cgi-bin/search.rb', 'query=subject&target=ruby' )
-
- # using block
- File.open( 'save.html', 'w' ) {|f|
- http.post( '/cgi-bin/search.rb',
- 'query=subject&target=ruby' ) do |str|
- f.write str
- end
- }
-
-: request_get( path, header = nil )
-: request_get( path, header = nil ) {|response| .... }
- path �ˤ��륨��ƥ��ƥ���������ޤ���HTTPResponse
- ���֥������Ȥ��֤��ޤ���
-
- �֥��å��ȤȤ�˸ƤӽФ��줿�Ȥ��ϡ��֥��å��¹������³��
- �ݻ������ޤ� HTTPResponse ���֥������Ȥ�֥��å����Ϥ��ޤ���
-
- ���Υ᥽�åɤ� HTTP �ץ��ȥ���˴�Ϣ�����㳰��ȯ�������ޤ���
-
- # example
- response = http.request_get( '/index.html' )
- p response['content-type']
- puts response.body # body is already read
-
- # using block
- http.request_get( '/index.html' ) {|response|
- p response['content-type']
- response.read_body do |str| # read body now
- print str
- end
- }
-
-: request_post( path, data, header = nil )
-: request_post( path, data, header = nil ) {|response| .... }
- path �ˤ��륨��ƥ��ƥ���������ޤ���HTTPResponse
- ���֥������Ȥ��֤��ޤ���
-
- �֥��å��ȤȤ�˸ƤӽФ��줿�Ȥ��ϡ��ܥǥ����ɤߤ�������
- HTTPResponse ���֥������Ȥ�֥��å����Ϥ��ޤ���
-
- ���Υ᥽�åɤ� HTTP �ץ��ȥ���˴�Ϣ�����㳰��ȯ�������ޤ���
-
- # example
- response = http.post2( '/cgi-bin/nice.rb', 'datadatadata...' )
- p response.status
- puts response.body # body is already read
-
- # using block
- http.post2( '/cgi-bin/nice.rb', 'datadatadata...' ) {|response|
- p response.status
- p response['content-type']
- response.read_body do |str| # read body now
- print str
- end
- }
-
-: request( request [, data] )
-: request( request [, data] ) {|response| .... }
- HTTPResquest ���֥������� request ���������ޤ���POST/PUT �λ��� data ��
- Ϳ�����ޤ� (POST/PUT �ʳ��� data ��Ϳ����� ArgumentError ��ȯ�����ޤ�)��
-
- �֥��å��ȤȤ�˸ƤӤ����줿�Ȥ��ϥܥǥ����ɤߤ��ޤ��� HTTPResponse
- ���֥������Ȥ�֥��å���Ϳ���ޤ���
-
- ���Υ᥽�åɤ� HTTP �ץ��ȥ���˴�Ϣ�����㳰��ȯ�������ޤ���
-
-== class Net::HTTP::Get, Head, Post
-
-HTTP �ꥯ�����Ȥ���ݲ����륯�饹��key �Ϥ��٤���ʸ����ʸ����
-���̤��ޤ���
-
-=== ���饹�᥽�å�
-
-: new
- HTTP �ꥯ�����ȥ��֥������Ȥ��������ޤ���
-
-=== �᥽�å�
-
-: self[ key ]
- key �إå��ե�����ɤ�ʸ����
- key ����ʸ����ʸ������̤��ޤ���
-
-: self[ key ] = val
- key �إå��ե�����ɤ� val �򥻥åȤ��ޤ���
- key ����ʸ����ʸ������̤��ޤ���
-
-: each {|name, val| .... }
- �إå�̾�Ȥ����ͤ��Ф��뤯�꤫�������إå�̾�Ͼ�ʸ�������줵��ޤ���
-
-: basic_auth( account, password )
- Authrization: �إå��� basic auth �Ѥ˥��åȤ��ޤ���
-
-: range
- Range: �إå��μ����ϰϤ� Range ���֥������Ȥ��֤��ޤ���
-
-: range = r
-: set_range( i, len )
- �ϰϤ���ꤷ�ƥ���ƥ��ƥ���������뤿��Υإå� Range: �򥻥åȤ��ޤ���
- r �� Range ���֥������ȡ�i, len �ϻ�����Ĺ���Ǥ���
-
-: content_length
- Content-Length: �إå����� (����)��
-
-: content_range
- Content-Range: �إå����� (Range)��
-
-== class Net::HTTPResponse
-
-HTTP �쥹�ݥ󥹤Υ��饹�Ǥ���
-�������إå��ե������̾�Ǥ����硢��ʸ����ʸ������̤��ޤ���
-
-=== �᥽�å�
-
-: self[ key ]
- key �إå��ե������(ʸ����)�Ǥ������Ȥ��Х��� 'content-length'
- ���Ф��Ƥ� '2048' �Τ褦��ʸ���������ޤ���
- key ����ʸ����ʸ������̤��ޤ���
-
-: self[ key ] = val
- key �إå��ե�����ɤ� value �����ꤷ�ޤ���
- key ����ʸ����ʸ������̤��ޤ���
-
-: key?( key )
- key �Ȥ����إå��ե�����ɤ�����п���
- key ����ʸ����ʸ������̤��ޤ���
-
-: each {|name,value| .... }
- ���٤ƤΥإå��ե������̾�Ȥ����ͤΥڥ����Ф��뤯�꤫������
-
-: canonical_each {|name,value| .... }
- �إå��ե�����ɤ�����̾�Ȥ����ͤΥڥ����Ф��Ʒ����֤��ޤ���
-
-: code
- HTTP �Υꥶ��ȥ����ɤǤ����㤨�� '302' �ʤɤǤ���
-
-: message
- HTTP �����Ф��ꥶ��ȥ����ɤ��ղä����֤���å������Ǥ���
- �㤨�� 'Not Found' �ʤɤǤ���
-
-: read_body( dest = '' )
- ����ƥ��ƥ��ܥǥ�������� dest �� << �᥽�åɤ�Ȥäƽ񤭤��ߤޤ���
- Ʊ�� HTTPResponse ���֥������Ȥ��Ф������ʾ�ƤФ줿��硢
- ����ܤ���Ϥʤˤ⤻���˰���ܤ��֤��ͤ򤽤Τޤ��֤��ޤ���
-
-: read_body {|str| .... }
- ����ƥ��ƥ��ܥǥ��򾯤��Ťļ������ƽ缡�֥��å���Ϳ���ޤ���
-
-: body
- ����ƥ��ƥ��ܥǥ��Ǥ���read_body ��Ƥ�Ǥ���Ф��ΰ��� dest��
- �Ƥ�Ǥ��ʤ���Х���ƥ��ƥ��ܥǥ���ʸ����Ȥ����ɤߤ�����֤��ޤ���
-
-=end
diff --git a/doc/net/pop.rd.ja b/doc/net/pop.rd.ja
deleted file mode 100644
index 2c7e22f29f..0000000000
--- a/doc/net/pop.rd.ja
+++ /dev/null
@@ -1,326 +0,0 @@
-=begin
-
-= net/pop.rb
-
-== ���Υ饤�֥��ˤĤ���
-
-�᡼���������뤿��Υץ��ȥ��� POP3 (Post Office Protocol version 3) ��
-�򰷤��饤�֥��Ǥ���POP3 �μ����� [RFC1939]
-((<URL:http://www.ietf.org/rfc/rfc1939.txt>)) �˴𤤤Ƥ��ޤ���
-
-== ������
-
-=== �᡼��μ���
-
-�ʲ��Υ����ɤϡ��᡼���������ƥե����� 'inbox/1' 'inbox/2'... ��
-�񤭤��ߡ������о夫��᡼���ä��ޤ���pop3.server.address ��Ŭ��
-�ɤߤ����Ƥ���������
-
- require 'net/pop'
-
- pop = Net::POP3.new( 'pop3.server.address', 110 )
- pop.start( 'YourAccount', 'YourPassword' ) ###
- if pop.mails.empty? then
- puts 'no mail.'
- else
- i = 0
- pop.each_mail do |m| # or "pop.mails.each ..."
- File.open( 'inbox/' + i.to_s, 'w' ) {|f|
- f.write m.pop
- }
- m.delete
- i += 1
- end
- puts "#{pop.mails.size} mails popped."
- end
- pop.finish ###
-
-POP �����Фϥͥåȥ���Τळ����¸�ߤ���Τǡ��ʤˤ��Ż��򤵤���
-�ˤϤ������˳��ϼ�³���򡢽���ä��齪λ��³���򡢹Ԥ�ʤ���Ф���
-�ޤ��󡣤����Ԥ��Τ� Net::POP3#start �� #finish �ǡ�POP3 ���֥�������
-�Ϥ�����ĤΥ᥽�åɤδ֤Ǥ���ͭ���ˤʤ�ޤ���
-
-�����о�Υ᡼��� POPMail ���֥������ȤȤ���ɽ������Ƥ��ꡢ����
-���֥������ȤΥ᥽�åɤ�Ƥ֤��Ȥǥ᡼����äƤ�����ä����ꤹ��
-���Ȥ��Ǥ��ޤ���POP3#mails �Ϥ��� POPMail ���֥������Ȥ�����Ǥ��ꡢ
-POP3#each_mail �Ϥ���� mails.each �Υ��硼�ȥ��åȤǤ���
-
-=== û������
-
-�����Ϥ����ƾ�ά��û���ѥ᥽�åɤ��򤱤�����ˤ��ʤ��Ĺ�Ǥ���
-�ޤ����֥��å��դ��� Net::POP3.start ��Ȥ����Ȥ� POP3.new #start
-#finish ��ʻ��Ǥ��ޤ���
-
- require 'net/pop'
-
- Net::POP3.start( 'pop3.server.address', 110 )
- 'YourAccount', 'YourPassword' )
- if pop.mails.empty? then
- puts 'no mail.'
- else
- i = 0
- pop.each_mail do |m| # or "pop.mails.each ..."
- File.open( 'inbox/' + i.to_s, 'w' ) {|f|
- f.write m.pop
- }
- m.delete
- i += 1
- end
- puts "#{pop.mails.size} mails popped."
- end
- }
-
-POP3#delete_all ��Ȥ��Ȥ���� #each_mail �� m.delete ��
-ʻ��Ǥ��ޤ���
-
- require 'net/pop'
-
- Net::POP3.start( 'pop3.server.address', 110,
- 'YourAccount', 'YourPassword' ) {|pop|
- if pop.mails.empty? then
- puts 'no mail.'
- else
- i = 0
- pop.delete_all do |m|
- File.open( 'inbox/' + i.to_s, 'w' ) {|f|
- f.write m.pop
- }
- i += 1
- end
- end
- }
-
-���饹�᥽�åɤ� POP3.delete_all ��Ȥ��Ȥ����û���ʤ�ޤ���
-
- require 'net/pop'
-
- i = 0
- Net::POP3.delete_all( 'pop3.server.address', 110,
- 'YourAccount', 'YourPassword' ) do |m|
- File.open( 'inbox/' + i.to_s, 'w' ) {|f|
- f.write m.pop
- }
- i += 1
- end
-
-=== �ե������ľ�ܽ�
-
-����ޤǤ���Ǥ� m.pop ����ʬ�ǥ᡼���ҤȤĤ�ʸ����Ȥ���
-�����ȤäƤ��ޤ����������Ȥ��� 3MB ���餤�������ʥ᡼��ξ���
-����ǤϤޤ�����礬����ޤ������Τ褦�ʾ��ϰʲ��Τ褦�� m.pop
-�� File ���֥������Ȥ�Ϳ����꤬�Ȥ��ޤ���
-
- require 'net/pop'
- Net::POP3.delete_all( 'pop3.server.address', 110,
- 'YourAccount', 'YourPassword' ) do |m|
- File.open( 'inbox', 'w' ) {|f|
- m.pop f ####
- }
- end
-
-=== APOP
-
-Net::POP3 ���饹�Τ����� Net::APOP ���饹��Ȥ��ȡ�ǧ�ڻ��� APOP ��
-�Ȥ��褦�ˤʤ�ޤ����ޤ�ưŪ�˥Ρ��ޥ� POP �� APOP �����򤹤�ˤϡ�
-�ʲ��Τ褦�� Net::POP3.APOP() �᥽�åɤ�Ȥ��Τ������Ǥ���
-
- require 'net/pop'
-
- # use APOP authentication if $isapop == true
- pop = Net::POP3.APOP($isapop).new( 'apop.server.address', 110 )
- pop.start( YourAccount', 'YourPassword' ) {|pop|
- # Rest code is same.
- }
-
-������ˡ�ϥ��饹���Τ��Ѥ���Τǡ����饹�᥽�åɤ� start �� foreach��
-delete_all��auth_only �ʤɤ� APOP �ȤȤ�˻Ȥ��ޤ���
-
-== Net::POP3 class
-
-=== ���饹�᥽�å�
-
-: new( address, port = 110, apop = false )
- Net::POP3 ���֥������Ȥ��������ޤ����ޤ���³�Ϥ��ޤ���
- apop �����ΤȤ��� APOP ǧ�ڤ�Ԥ����֥������Ȥ��������ޤ���
-
-: start( address, port = 110, account, password )
-: start( address, port = 110, account, password ) {|pop| .... }
- address �� port �֥ݡ��Ȥ���³������������� account �ѥ����
- password �� POP �������󤷤ޤ���������� port �� nil ���Ϥ���
- POP3 �Υǥե���ȥݡ���(110)��Ȥ��ޤ���
-
- Net::POP3.start( addr, port, account, password ) {|pop|
- pop.each_mail do |m|
- file.write m.pop
- m.delete
- end
- }
-
-: APOP( is_apop )
- bool �����ʤ� Net::APOP ���饹�����ʤ� Net::POP3 ���饹���֤��ޤ���
- �ʲ�����Τ褦�˻ȤäƤ���������
-
- # example 1
- pop = Net::POP3::APOP($isapop).new( addr, port )
-
- # example 2
- Net::POP3::APOP($isapop).start( addr, port ) {|pop|
- ....
- }
-
-: foreach( address, port = 110, account, password ) {|mail| .... }
- POP ���å����򳫤��������о�Τ��٤ƤΥ᡼����Ф��Ʒ����֤��ޤ���
- �ʲ���Ʊ���Ǥ���
-
- Net::POP3.start( address, port, account, password ) {|pop|
- pop.each_mail do |m|
- yield m
- end
- }
-
- # example
- Net::POP3.foreach( 'your.pop.server', 110,
- 'YourAccount', 'YourPassword' ) do |m|
- file.write m.pop
- m.delete if $DELETE
- end
-
-: delete_all( address, port = 110, account, password )
-: delete_all( address, port = 110, account, password ) {|mail| .... }
- POP ���å����򳫤��������о�Υ᡼��򤹤٤ƺ�����ޤ���
- �֥��å���Ϳ����줿���Ϻ���������˥֥��å��ˤ��Υ᡼���
- �Ϥ��ޤ����ʲ���Ʊ���Ǥ���
-
- # example
- Net::POP3.delete_all( addr, nil, 'YourAccount', 'YourPassword' ) do |m|
- m.pop file
- end
-
-: auth_only( address, port = 110, account, password )
- POP ���å����򳫤�ǧ�ڤ�����Ԥä���³���ڤ�ޤ���
- POP before SMTP ���ѤǤ���
-
- # example
- Net::POP3.auth_only( 'your.pop3.server',
- nil, # using default (110)
- 'YourAccount',
- 'YourPassword' )
-
-=== �᥽�å�
-
-: start( account, password )
-: start( account, password ) {|pop| .... }
- ��⡼�ȥۥ��ȤȤ���³�򳫻Ϥ�����������Ȥ� account��
- �ѥ���ɤ� password ��Ȥä� POP �������󤷤ޤ���
-
-: active?
- POP3 ���å���󤬳��Ϥ���Ƥ����鿿��
-
-: address
- ��³���륢�ɥ쥹
-
-: port
- ��³����ݡ����ֹ�
-
-: open_timeout
-: open_timeout=(n)
- ��³�����Ԥĺ����ÿ��������ÿ����äƤ⥳�ͥ������
- �����ʤ�����㳰 TimeoutError ��ȯ�����ޤ���
-
-: read_timeout
-: read_timeout=(n)
- �ɤߤ��� (read(1) ���) �ǥ֥��å����Ƥ褤�����ÿ���
- �����ÿ����äƤ��ɤߤ���ʤ�����㳰 TimeoutError ��ȯ�����ޤ���
-
-: finish
- POP3 ���å�����λ���ޤ������å���󳫻����ˤ��Υ᥽�åɤ�
- �ƤФ줿�����㳰 IOError ��ȯ�����ޤ���
-
-: mails
- Net::POPMail ���֥������Ȥ�����򤫤����ޤ���
- ��������ϥ��å����򳫻Ϥ����Ȥ��˼�ưŪ�˹�������ޤ���
-
-: each_mail {|popmail| .... }
-: each {|popmail| .... }
- pop3.mails.each ��Ʊ���Ǥ���
-
-: delete_all
-: delete_all {|popmail| .... }
- �����о�Υ᡼������ƾõ�ޤ���
- �֥��å���Ϳ����줿�Ȥ��Ͼõ�����ˤ��� POPMail ���֥������Ȥ�
- �֥��å����Ϥ��ޤ���
-
- # example
- n = 1
- pop.delete_all do |m|
- File.open("inbox/#{n}") {|f| f.write m.pop }
- n += 1
- end
-
-: auth_only( account, password )
- POP ���å����򳫤�ǧ�ڤ�����Ԥä���³���ڤ�ޤ���
- POP before SMTP ���ѤǤ���
- # example
- pop = Net::POP3.new( 'your.pop3.server' )
- pop.auth_only 'YourAccount', 'YourPassword'
-
-: reset
- ���å�����ꥻ�åȤ��ޤ���
- ����Ū�ˤ� POPMail#delete �Ǿä����᡼�뤬�������褷�ޤ���
- (POP3 �Ǥϥ᡼���Ĥ��������褹����ˡ�Ϥ���ޤ���)
-
-== Net::APOP
-
-���Υ��饹�ǤϿ������᥽�åɤ�Ƴ�����Ƥ��ޤ���
-ǧ�������� APOP ���Ѥ������Ǥ���
-
-=== �����ѡ����饹
-Net::POP3
-
-== Net::POPMail
-
-POP �����С���Υ᡼����̤����Ū��ɽ�����륯�饹��
-�᡼��μ�����õ�Ȥ��ä����򥫥ץ��벽���ޤ���
-
-=== �᥽�å�
-
-: pop( dest = '' )
- �᡼���������� dest �� << �᥽�åɤ�Ȥäƽ񤭤��ߤޤ���
- dest ���֤��ޤ���
-
- # example
- allmails = nil
- POP3.start( 'your.pop3.server', 110,
- 'YourAccount, 'YourPassword' ) {|pop|
- allmails = pop.mails.collect {|popmail| popmail.pop }
- }
-
-: pop {|str| .... }
- �᡼���ʸ����򾯤��Ť��ɤߤ��ߡ��缡�֥��å���Ϳ���ޤ���
-
- # example
- POP3.start( 'localhost', 110 ) {|pop3|
- pop3.each_mail do |m|
- m.pop do |str|
- # do anything
- end
- end
- }
-
-: header
- �إå��������������ʸ������֤��ޤ���
-
-: top( lines )
- �᡼��إå��� lines �Ԥ֤����ʸ�������ʸ������֤��ޤ���
-
-: delete
- �����о夫��᡼��������ޤ���
-
-: size
- �᡼��Υ����� (ñ�̤ϥХ���) �򤫤����ޤ���
-
-: deleted?
- �᡼�뤬�����о�Ǿõ��Ƥ���Ȥ������õ�Ƥ��ޤä���
- POP3#reset ��Ȥ��ʳ������褹����ˡ�Ϥ���ޤ���
-
-=end
diff --git a/doc/net/smtp.rd.ja b/doc/net/smtp.rd.ja
deleted file mode 100644
index cc87865dc7..0000000000
--- a/doc/net/smtp.rd.ja
+++ /dev/null
@@ -1,194 +0,0 @@
-=begin
-
-= net/smtp.rb
-
-== ���Υ饤�֥��ˤĤ���
-
-�᡼����������뤿��Υץ��ȥ��� SMTP (Simple Mail Transfer Protocol)
-�򰷤��饤�֥��Ǥ����إå��ʤɥ᡼��Υǡ����򰷤����ȤϤǤ��ޤ���
-SMTP ����� [RFC2821] ((<URL:http://www.ietf.org/rfc/rfc2821.txt>))
-�˴𤤤Ƥ��ޤ���
-
-== ������
-
-=== �Ȥˤ����᡼�������
-
-SMTP ��Ȥäƥ᡼�������ˤϤޤ� SMTP.start �ǥ��å����򳫤��ޤ���
-�������������ФΥ��ɥ쥹������������ݡ����ֹ�Ǥ���
-�֥��å���Ȥ��� File.open ��Ʊ���褦�˽�ü������ưŪ�ˤ�äƤ����
-�ΤǤ�������Ǥ���
-
- require 'net/smtp'
- Net::SMTP.start( 'your.smtp.server', 25 ) {|smtp|
- # use smtp object only in this block
- }
-
-your.smtp.server ��Ŭ�ڤ� SMTP �����ФΥ��ɥ쥹���ɤߤ����Ƥ���������
-�̾�� LAN �δ����Ԥ�ץ��Х����� SMTP �����Ф��Ѱդ��Ƥ���Ƥ���Ϥ��Ǥ���
-
-���å���󤬳������餢�Ȥ� send_mail �ǥ᡼���ή����������Ǥ���
-
- require 'net/smtp'
-
- Net::SMTP.start( 'your.smtp.server', 25 ) {|smtp|
- smtp.send_mail <<EndOfMail, '[email protected]', '[email protected]'
- From: Your Name <[email protected]>
- To: Dest Address <[email protected]>
- Subject: test mail
- Date: Sat, 23 Jun 2001 16:26:43 +0900
- Message-Id: <[email protected]>
-
- This is test mail.
- EndOfMail
- }
-
-=== ���å�����λ����
-
-�᡼������ä��� SMTP#finish ��Ƥ�ǥ��å�����λ���ʤ���Ф���
-�ޤ���File �Τ褦�� GC ���˾���� close ����뤳�Ȥ⤢��ޤ���
-���������ʤȤ����� finish ���ʤ������������ɤ���򸫳ݤ��ޤ�����
-���٤Ƹ���Ǥ���finish ��ɬ���Ƥ�Ǥ���������
-
-�ޤ��֥��å��դ��� SMTP.start/SMTP#start ��Ȥ��Ⱦ���� finish ��
-�Ƥ�Ǥ����Τ������Ǥ�����ǽ�ʸ¤�֥��å��դ��� start ��Ȥ��Τ�
-�褤�Ǥ��礦��
-
- # using SMTP#finish
- smtp = Net::SMTP.start( 'your.smtp.server', 25 )
- smtp.send_mail mail_string, 'from@address', 'to@address'
- smtp.finish
-
- # using block form of SMTP.start
- Net::SMTP.start( 'your.smtp.server', 25 ) {|smtp|
- smtp.send_mail mail_string, 'from@address', 'to@address'
- }
-
-=== ʸ����ʳ����������
-
-�ҤȤľ����Ǥ�ʸ�����ƥ��(�ҥ��ɥ������)��Ȥä��������ޤ�������
-each �᥽�åɤ���ä����֥������Ȥ���ʤ�ʤ�Ǥ����뤳�Ȥ��Ǥ��ޤ���
-�ʲ��� File ���֥������Ȥ���ľ������������Ǥ���
-
- require 'net/smtp'
- Net::SMTP.start( 'your.smtp.server', 25 ) {|smtp|
- File.open( 'Mail/draft/1' ) {|f|
- smtp.send_mail f, '[email protected]', '[email protected]'
- }
- }
-
-=== HELO �ɥᥤ��
-
-SMTP �Ǥϥ᡼�������¦�Υۥ��Ȥ�̾�� (HELO �ɥᥤ��ȸƤ�) ���׵�
-�����ΤǤ�����Net::SMTP �ǤϤȤꤢ���� localhost.localdomain ��
-����̾�����������Ƥ��ޤ��������Ƥ��� SMTP �����ФϤ��� HELO �ɥᥤ��
-�ˤ��ǧ�ڤϤ��ޤ꿿���ܤ˹Ԥ�ʤ��Τ� (��ñ�˵�¤�Ǥ��뤫��Ǥ�)
-����ˤʤ�ʤ����Ȥ�¿���ΤǤ������ޤ�˥᡼�륻�å������ڤ���
-���Ȥ⤢��ޤ������������Ȥ��ϤȤꤢ���� HELO �ɥᥤ���Ϳ���Ƥߤ�
-����������������󤽤�ʳ��λ��� HELO �ɥᥤ��Ϥ������Ϥ��Τ�
-�٥��ȤǤ���
-
-HELO �ɥᥤ��� SMTP.start/SMTP#start ���軰���� helo_domain �˻���
-���ޤ���
-
- Net::SMTP.start( 'your.smtp.server', 25,
- 'mail.from.domain' ) {|smtp|
-
-�褯���������륢�åץۥ��Ȥξ�硢HELO �ɥᥤ��ˤ� ISP �Υ᡼��
-�����ФΥɥᥤ���ȤäƤ����Ф����Ƥ��̤�ޤ���
-
-== class Net::SMTP
-
-=== ���饹�᥽�å�
-
-: new( address, port = 25 )
- ������ SMTP ���֥������Ȥ��������ޤ���address ��SMTP�����С���FQDN�ǡ�
- port ����³����ݡ����ֹ�Ǥ��������������Υ᥽�åɤǤϤޤ���³�Ϥ��ޤ���
-
-: start( address, port = 25, helo_domain = 'localhost.localdomain', account = nil, password = nil, authtype = nil )
-: start( address, port = 25, helo_domain = 'localhost.localdomain', account = nil, password = nil, authtype = nil ) {|smtp| .... }
- �ʲ���Ʊ���Ǥ���
- Net::SMTP.new(address,port).start(helo_domain,account,password,authtype)
-
- # example
- Net::SMTP.start( 'your.smtp.server' ) {
- smtp.send_mail mail_string, '[email protected]', '[email protected]'
- }
-
-=== �᥽�å�
-
-: start( helo_domain = <local host name>, account = nil, password = nil, authtype = nil )
-: start( helo_domain = <local host name>, account = nil, password = nil, authtype = nil ) {|smtp| .... }
- TCP ���ͥ�������ĥ�ꡢƱ���� SMTP ���å����򳫻Ϥ��ޤ������ΤȤ���
- ������Υۥ��Ȥ� FQDN �� helo_domain �˻��ꤷ�ޤ���
- �⤷���Ǥ˥��å���󤬳��Ϥ��Ƥ����� IOError ��ȯ�����ޤ���
-
- account �� password ��ξ����Ϳ����줿��硢AUTH ���ޥ�ɤˤ�ä�
- ǧ�ڤ�Ԥ��ޤ���authtype �ϻ��Ѥ���ǧ�ڤΥ����פǡ�����ܥ�
- �� :plain �� :cram_md5 ����ꤷ�ޤ���
-
-: active?
- SMTP ���å���󤬳��Ϥ���Ƥ����鿿��
-
-: address
- ��³���륢�ɥ쥹
-
-: port
- ��³����ݡ����ֹ�
-
-: open_timeout
-: open_timeout=(n)
- ��³�����Ԥĺ����ÿ��������ÿ����äƤ⥳�ͥ������
- �����ʤ�����㳰 TimeoutError ��ȯ�����ޤ���
-
-: read_timeout
-: read_timeout=(n)
- �ɤߤ��� (read(1) ���) �ǥ֥��å����Ƥ褤�����ÿ���
- �����ÿ����äƤ��ɤߤ���ʤ�����㳰 TimeoutError ��ȯ�����ޤ���
-
-: finish
- SMTP ���å�����λ���ޤ������å���󳫻����ˤ��Υ᥽�åɤ�
- �ƤФ줿�����㳰 IOError ��ȯ�����ޤ���
-
-: send_mail( mailsrc, from_addr, *to_addrs )
- mailsrc ��᡼��Ȥ����������ޤ���mailsrc �� each ���ƥ졼�������
- ���֥������Ȥʤ�ʤ�Ǥ⹽���ޤ��� (���Ȥ��� String �� File)��
- from_domain �������Υ᡼�륢�ɥ쥹 ('...@...'�Τ������Τ��) �ǡ�
- to_addrs �ˤ�������᡼�륢�ɥ쥹���¤٤ޤ���
-
- # example
- Net::SMTP.start( 'your.smtp.server' ) {|smtp|
- smtp.send_mail mail_string,
- }
-
-: ready( from_addr, *to_addrs ) {|adapter| .... }
- �᡼��񤭤��ߤν����򤷤������ǡ�write �᥽�åɤ���ĥ��֥������Ȥ�
- �֥��å��ˤ������ޤ���from_addr ���������᡼�륢�ɥ쥹�� to_addrs ��
- ����Υ᡼��ܥå����Ǥ���
-
- # example
- Net::SMTP.start( 'your.smtp.server', 25 ) {|smtp|
- smtp.ready( '[email protected]', '[email protected]' ) {|f|
- f.puts 'From: [email protected]'
- f.puts 'To: [email protected]'
- f.puts 'Subject: test mail'
- f.puts
- f.puts 'This is test mail.'
- }
- }
-
-== ȯ�������㳰
-
-���å������� (SMTP ��٥��) ���顼�������ä���硢
-�ʲ����㳰��ȯ�����ޤ���
-: Net::ProtoSyntaxError
- SMTP ���ޥ�ɤι�ʸ�ߥ�(500����)
-: Net::ProtoFatalError
- ����Ū�ʥ��顼(550����)
-: Net::ProtoUnknownError
- ͽ�����ʤ����顼�������餯�Х�
-: Net::ProtoServerBusy
- ���Ū�ʥ��顼(420/450����)
-
-=end