U:RDoc::AnyMethod[iI"
starttls:ETI"Net::IMAP#starttls;TF:publico:RDoc::Markup::Document:@parts[o:RDoc::Markup::Paragraph;	[I"jSends a {STARTTLS command [IMAP4rev1 §6.2.1]}[https://www.rfc-editor.org/rfc/rfc3501#section-6.2.1] ;TI"to start a TLS session.;To:RDoc::Markup::BlankLineo;
;	[I"HAny +options+ are forwarded to OpenSSL::SSL::SSLContext#set_params.;T@o;
;	[I"MThis method returns after TLS negotiation and hostname verification are ;TI"Lboth successful.  Any error indicates that the connection has not been ;TI"
secured.;T@o;
;	[I"*Note:*;To:RDoc::Markup::BlockQuote;	[o;
;	[I"KAny #response_handlers added before STARTTLS should be aware that the ;TI"NTaggedResponse to STARTTLS is sent clear-text, _before_ TLS negotiation. ;TI"<TLS negotiation starts immediately after that response.;T@o;
;	[I"2Related: Net::IMAP.new, #login, #authenticate;T@S:RDoc::Markup::Heading:
leveli
:	textI"Capability;T@o;
;	[I"7The server's capabilities must include +STARTTLS+.;T@o;
;	[I"PServer capabilities may change after #starttls, #login, and #authenticate. ;TI"KCached capabilities _must_ be invalidated after this method completes.;T@o;
;	[	I"PThe TaggedResponse to #starttls is sent clear-text, so the server <em>must ;TI"Q*not*</em> send capabilities in the #starttls response and clients <em>must ;TI"Inot</em> use them if they are sent.  Servers will generally send an ;TI"Junsolicited untagged response immeditely _after_ #starttls completes.;T:
@fileI"lib/net/imap.rb;T:0@omit_headings_from_table_of_contents_below000[I""(options = {}, verify = true);T@4FI"	IMAP;TcRDoc::NormalClass00