[Python-checkins] CVS: python/dist/src/Doc/lib email.tex,1.8,1.9

[Barry Warsaw]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv25533

Modified Files:
	email.tex 
Log Message:
Add a clarification that the email package always deals in native line
endings, and that it is smtplib's job to convert those to RFC 2821
line endings when sending the message.


Index: email.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/email.tex,v
retrieving revision 1.8
retrieving revision 1.9
diff -C2 -d -r1.8 -r1.9
*** email.tex	2001/11/05 17:50:53	1.8
--- email.tex	2001/11/16 22:16:04	1.9
***************
*** 18,22 ****
  such as \refmodule{rfc822}, \refmodule{mimetools},
  \refmodule{multifile}, and other non-standard packages such as
! \module{mimecntl}.
  
  The primary distinguishing feature of the \module{email} package is
--- 18,30 ----
  such as \refmodule{rfc822}, \refmodule{mimetools},
  \refmodule{multifile}, and other non-standard packages such as
! \module{mimecntl}.  It is specifically \emph{not} designed to do any
! sending of email messages to SMTP (\rfc{2821}) servers; that is the
! function of the \refmodule{smtplib} module\footnote{For this reason,
! line endings in the \module{email} package are always native line
! endings.  The \module{smtplib} module is responsible for converting
! from native line endings to \rfc{2821} line endings, just as your mail
! server would be responsible for converting from \rfc{2821} line
! endings to native line endings when it stores messages in a local
! mailbox.}.
  
  The primary distinguishing feature of the \module{email} package is
***************
*** 50,53 ****
--- 58,65 ----
  \module{mimelib} package, from which the \module{email} package is
  descended, a section on differences and porting is provided.
+ 
+ \begin{seealso}
+     \seemodule{smtplib}{SMTP protocol client}
+ \end{seealso}
  
  \subsection{Representing an email message}