--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml/en/docs/mail/ngx_mail_smtp_module.xml	Wed Sep 05 14:07:43 2012 +0000
@@ -0,0 +1,83 @@
+<?xml version="1.0"?>
+
+<!--
+  Copyright (C) 2006, 2007 Anton Yuzhaninov
+  Copyright (C) Nginx, Inc.
+  -->
+
+<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
+
+<module name="Module ngx_mail_smtp_module"
+        link="/en/docs/mail/ngx_mail_smtp_module.html"
+        lang="en"
+        rev="1">
+
+<section id="directives" name="Directives">
+
+<directive name="smtp_auth">
+<syntax><value>method</value> ...</syntax>
+<default>login plain</default>
+<context>mail</context>
+<context>server</context>
+
+<para>
+Sets permitted methods of
+<link url="http://tools.ietf.org/html/rfc2554">SASL authentication</link>
+for SMTP clients.
+Supported methods are:
+<list type="tag">
+
+<tag-name><literal>login</literal></tag-name>
+<tag-desc>
+<link url="http://tools.ietf.org/html/draft-murchison-sasl-login-00">AUTH LOGIN</link>
+</tag-desc>
+
+<tag-name><literal>plain</literal></tag-name>
+<tag-desc>
+<link url="http://tools.ietf.org/html/rfc4616">AUTH PLAIN</link>
+</tag-desc>
+
+<tag-name><literal>cram-md5</literal></tag-name>
+<tag-desc>
+<link url="http://tools.ietf.org/html/rfc2195">AUTH CRAM-MD5</link>.
+In order for this method to work, the password must be stored unencrypted.
+</tag-desc>
+
+</list>
+</para>
+
+</directive>
+
+
+<directive name="smtp_capabilities">
+<syntax><value>extension</value> ...</syntax>
+<default/>
+<context>mail</context>
+<context>server</context>
+
+<para>
+Allows to specify the SMTP protocol extensions list
+to be passed to the client in the response to the
+<literal>EHLO</literal> command.
+Authentication methods specified in the <link id="smtp_auth"/> directive
+are automatically added to this list.
+</para>
+
+<para>
+It makes sense to specify extensions
+supported by MTA
+to which clients are proxied (if this extensions are related to commands
+used after the authentication, when nginx transparently proxies the client
+connection to the backend).
+</para>
+
+<para>
+The current list of standardized extensions is published at the
+<link url="http://www.iana.org/assignments/mail-parameters">www.iana.org</link>.
+</para>
+
+</directive>
+
+</section>
+
+</module>