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

[commit a svn.python.it]

Author: manlio
Date: Sun Jul  2 20:54:32 2006
New Revision: 188

Modified:
   python/python/Doc/branches/2.4.3/lib/emailencoders.tex
   python/python/Doc/branches/2.4.3/lib/emailexc.tex
Log:
aggiornamenti di Antonio Vitale

Modified: python/python/Doc/branches/2.4.3/lib/emailencoders.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/lib/emailencoders.tex	(original)
+++ python/python/Doc/branches/2.4.3/lib/emailencoders.tex	Sun Jul  2 20:54:32 2006
@@ -32,8 +32,8 @@
 
 Il package \module{email} fornisce alcuni codificatori pratici nel
 suo modulo \module{Encoders}.  Questi codificatori sono realmente
-utilizzati dai costruttori delle classi \class{MIMEImage} e
-\class{MIMEText} per fornire le codifiche predefinite.  Tutte le
+utilizzati dai costruttori delle classi \class{MIMEAudio} e
+\class{MIMEImage} per fornire le codifiche predefinite.  Tutte le
 funzioni di codifica ricevono esattamente un argomento, l'oggetto di
 tipo messaggio da codificare.  Generalmente estraggono il carico
 utile, lo codificano e reimpostano il carico utile a questo nuovo

Modified: python/python/Doc/branches/2.4.3/lib/emailexc.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/lib/emailexc.tex	(original)
+++ python/python/Doc/branches/2.4.3/lib/emailexc.tex	Sun Jul  2 20:54:32 2006
@@ -89,9 +89,41 @@
 %[- MARK -] END DIFF
 \exception{MessageError} e dal built-in \exception{TypeError}. 
 
-Poiché \method{Message.add_payload()} è deprecato, questa eccezione
-viene raramente sollevata in pratica.  Comunque l'eccezione può anche
-essere sollevata se il metodo \method{attach()} viene chiamato su
-un'istanza di una classe derivata da \class{MIMENonMultipart} (per
-esempio \class{MIMEImage}). 
+Poiché \method{Message.add_payload()} è deprecato, praticamente questa eccezione
+viene raramente sollevata.  Comunque l'eccezione può anche venire sollevata se
+il metodo \method{attach()} viene chiamato su un'istanza di una classe derivata
+da \class{MIMENonMultipart} (per esempio \class{MIMEImage}).
 \end{excclassdesc}
+
+Ecco una lista degli errori che \class{FeedParser} può riscontrare durante l'analisi dei messaggi.
+Si noti che tali errori vengono aggiunti al messaggio in cui è stato individuato il problema;
+così per esempio, se un messaggio nidificato all'interno di un \mimetype{multipart/alternative}
+possiede un header "malformed" (NdT non riconoscibile), tale messaggio incorporato
+nell'oggetto conterrà un errore, ma non i messaggi che vi sono contenuti all'interno.
+
+Tutte le classi "defect" vengono sottoclassate a partire dalla classe
+\class{email.Errors.MessageDefect}, eccetto quando questa classe sia un'eccezione \emph{not}!
+
+\versionadded[Sono state aggiunte tutte le classi "defect"]{2.4}
+
+\begin{itemize}
+\item \class{NoBoundaryInMultipartDefect} -- Un messaggio afferma di essere
+      multipart ma non possiede il parametro \mimetype{boundary}.
+
+\item \class{StartBoundaryNotFoundDefect} -- Non è stato mai trovato l'inizio
+      boundary richiesto dall'header \mailheader{Content-Type}.
+
+\item \class{FirstHeaderLineIsContinuationDefect} -- Il messaggio ha come prima
+      linea dell'header una riga di continuazione.
+
+\item \class{MisplacedEnvelopeHeaderDefect} - E' stato riscontrato un header
+      ``Unix From'' in mezzo al blocco dell'intestazione.
+
+\item \class{MalformedHeaderDefect} -- E' stato riscontrata un'intestazione priva
+      dei due punti o comunque "malformed".
+
+\item \class{MultipartInvariantViolationDefect} -- Un messaggio sostiene di essere
+      \mimetype{multipart}, ma non sono state trovate sottoparti.  Si noti che quando
+      un messaggio ha tale difetto, il suo metodo \method{is_multipart()} potrebbe
+      restituire false anche se il suo content type richiede di essere \mimetype{multipart}.
+\end{itemize}