[Commits] python.it commit r185 - python/python/Doc/branches/2.4.3/lib

[commit a svn.python.it]

Author: manlio
Date: Sat Jun 17 17:33:09 2006
New Revision: 185

Modified:
   python/python/Doc/branches/2.4.3/lib/email.tex
Log:
aggiornamento traduzione di Antonio Vitale

Modified: python/python/Doc/branches/2.4.3/lib/email.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/lib/email.tex	(original)
+++ python/python/Doc/branches/2.4.3/lib/email.tex	Sat Jun 17 17:33:09 2006
@@ -21,8 +21,8 @@
 %[- MARK -]  The \module{email} package is a library for managing email messages,
 %[- MARK -]  including MIME and other \rfc{2822}-based message documents.  It
 %[- MARK -] END DIFF
-% Copyright (C) 2001,2002 Python Software Foundation
-% Author: barry a zope.com (Barry Warsaw)
+% Copyright (C) 2001-2004 Python Software Foundation
+% Author: barry a python.org (Barry Warsaw)
 
 \section{\module{email} ---
 	 Un package per gestire email e MIME}
@@ -30,8 +30,8 @@
 \declaremodule{standard}{email}
 \modulesynopsis{Il package supporta l'analisi, la manipolazione e la
   generazione di messaggi email, inclusi i documenti MIME.}
-\moduleauthor{Barry A. Warsaw}{barry a zope.com}
-\sectionauthor{Barry A. Warsaw}{barry a zope.com}
+\moduleauthor{Barry A. Warsaw}{barry a python.org}
+\sectionauthor{Barry A. Warsaw}{barry a python.org}
 
 %[- MARK -] BEGIN DIFF 002 of 4
 %[- MARK -] @@ 20
@@ -60,7 +60,7 @@
 (\rfc{2821}); questa è la funzione del modulo \refmodule{smtplib}.  Il
 package \module{email} prova ad essere il più possibile compatibile
 con le RFC, supportando oltre alla \rfc{2822}, alcune RFC collegata a
-MIME, come \rfc{2045}-\rfc{2047} e \rfc{2231}.
+MIME, come \rfc{2045}, \rfc{2046}, \rfc{2047}, e \rfc{2231}.
 
 La caratteristica primaria che distingue il package \module{email}
 dagli altri è che divide l'analisi e la generazione del messaggio di
@@ -182,7 +182,7 @@
 %[- MARK -] END DIFF
 \input{emailencoders}
 
-\subsection{Classi per le eccezioni}
+\subsection{Classi Exception e Defect}
 \input{emailexc}
 
 \subsection{Utilità varie}
@@ -191,14 +191,42 @@
 \subsection{Iteratori}
 \input{emailiter}
 
-\subsection{Differenze tra il modulo \module{email} v1 (fino a Python 2.2.1)}
+\subsection{Cronologia del Package}
 
 La versione 1 del package \module{email} era parte integrante delle
 distribuzioni Python fino a Python 2.2.1.  La versione 2 fu sviluppata
 per la distribuzione Python 2.3 e resa compatibile per Python 2.2.2.
-Era disponibile anche come package separato, basato su distutils.  La
-versione 2 di \module{email} è quasi per intero compatibile con la
-precedente versione 1, con le seguenti differenze: 
+Era disponibile anche come package separato, basato su distutils, che
+manteneva la compatibilità con Python 2.1.
+
+La versione 3.0 di \module{email} è stata distribuita con Python 2.4 e come
+package separato basato su distutils: è ancora compatibile con Python 2.3.
+
+Seguono le differenze esistenti tra le versioni 3 e 2 del modulo \module{email}:
+
+\begin{itemize}
+\item E' stata introdotta la classe \class{FeedParser}, mentre \class{Parser} è
+      implementata secondo le specifiche della classe \class{FeedParser}. Tutta
+      l'attività di analisi derivante non è precisa: l'analizzatore farà del suo
+      meglio per non sollevare eccezioni. I problemi individuati durante l'analisi
+      dei messaggi sono memorizzati nell'attributo di messaggio \var{defect}.
+
+\item Tutte le caratteristiche delle API che nella versione 2 provocavano
+      l'eccezione \exception{DeprecationWarning} sono stati rimossi. Compresi
+      l'argomento \var{_encoder} del costruttore \class{MIMEText}, il metodo
+      \method{Message.add_payload()}, la funzione \function{Utils.dump_address_pair()}
+      e le funzioni \function{Utils.decode()} e \function{Utils.encode()}.
+
+\item E' stata aggiunta una nuova eccezione \exception{DeprecationWarning}s a:
+      \method{Generator.__call__()}, \method{Message.get_type()},
+      \method{Message.get_main_type()}, \method{Message.get_subtype()}, e
+      all'argomento \var{strict} della classe \class{Parser}. Ci si aspetta che
+      siano eliminati nella versione 3.1 di email.
+
+\item E' stato eliminato il supporto per versioni di Python precedenti la 2.3.
+\end{itemize}
+
+Differenze esistenti tra le versioni 2 e 1 del modulo \module{email}:
 
 \begin{itemize}
 \item Sono stati aggiunti i moduli \module{email.Header} e