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

[commit a svn.python.it]

Author: manlio
Date: Sat Jul 29 11:21:34 2006
New Revision: 200

Modified:
   python/python/Doc/branches/2.4.3/lib/emailutil.tex
Log:
aggiornamento di Antonio Vitale (con piccola correzione di Manlio)

Modified: python/python/Doc/branches/2.4.3/lib/emailutil.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/lib/emailutil.tex	(original)
+++ python/python/Doc/branches/2.4.3/lib/emailutil.tex	Sat Jul 29 11:21:34 2006
@@ -16,8 +16,8 @@
 %[- MARK -] END DIFF
 \modulesynopsis{Varie utilità del package email.}
 
-Ci sono varie utilità molto comode fornite con il package
-\module{email}. 
+Ci sono varie utilità molto comode fornite con il modulo
+\module{email.Utils}:
 
 \begin{funcdesc}{quote}{str}
 Restituisce una nuova stringa con i caratteri di backslashes ed i
@@ -118,7 +118,7 @@
 %[- MARK -] END DIFF
 \end{funcdesc}
 
-\begin{funcdesc}{formatdate}{\optional{timeval\optional{, localtime}}}
+\begin{funcdesc}{formatdate}{\optional{timeval\optional{, localtime}\optional{, usegmt}}}
 Restituisce una data come stringa come indicato dalla \rfc{2822}, per
 esempio: 
 
@@ -154,7 +154,13 @@
 \code{True}, interpreta \var{timeval} e restituisce una data relativa
 al tempo locale invece di UTC, tenendo in debita considerazione l'ora
 legale.  Il valore predefinito è \code{False}, a significare che viene
-utilizzato UTC. 
+utilizzato UTC.
+
+Il parametro facoltativo \var{usegmt} è un'opzione che, quando \code{True},
+produce una stringa contenente la data con il fuso orario espresso come una
+stringa ascii \code{GMT}, piuttosto che come numero \code{-0000}.
+Questo è richiesto per diversi protocolli (come l'HTTP). Tutto ciò si usa
+solo quando \var{localtime} corrisponde a \code{False}.\versionadded{2.4}
 \end{funcdesc}
 
 \begin{funcdesc}{make_msgid}{\optional{idstring}}
@@ -228,25 +234,34 @@
 %[- MARK -] END DIFF
 \end{funcdesc}
 
+\begin{funcdesc}{collapse_rfc2231_value}{value\optional{, errors\optional{,
+    fallback_charset}}}
+Quando un parametro dell'header viene codificato nel formato \rfc{2231},
+\method{Message.get_param()} potrebbe restituire una tupla ternaria contenente il
+set di caratteri, la lingua ed il valore. \\function{collapse_rfc2231_value()}
+converte il tutto in una stringa unicode. Il parametro opzionale \var{errors},
+predefinito come \code{replace}, viene passato all'argomento \var{errors} della
+funzione incorporata \function{unicode()}. Il facoltativo \var{fallback_charset},
+predefinito come \code{us-ascii}, definisce il set di caratteri da usare nel caso
+in cui quello dell'header in formato \rfc{2231} non venga riconosciuto da Python.
+
+Per convenienza, se il parametro \var{value} passato a \function{collapse_rfc2231_value()}
+non è una tupla, deve essere una stringa che viene restituita senza virgolette.
+\end{funcdesc}
+
 \begin{funcdesc}{decode_params}{params}
 Decodifica la lista di parametri in accordo con la \rfc{2231}.
 \var{params} è una sequenza di tuple di 2 elementi contenenti gli
 elementi nella forma \code{(content-type, string-value)}. 
 \end{funcdesc}
 
-Le seguenti funzioni sono considerate deprecate:
-
+\versionchanged[La funzione \function{dump_address_pair()} è stata eliminata;
+si usi al suo posto la funzione \function{formataddr()}]{2.4}
 
-\begin{funcdesc}{dump_address_pair}{pair}
-\deprecated{2.2.2}{Usare invece \function{formataddr()}.}
-\end{funcdesc}
-
-\begin{funcdesc}{decode}{s}
-\deprecated{2.2.2}{Usare invece \method{Header.decode_header()}.}
-\end{funcdesc}
-
-
-\begin{funcdesc}{encode}{s\optional{, charset\optional{, encoding}}}
-\deprecated{2.2.2}{Usare invece \method{Header.encode()}.}
-\end{funcdesc}
+\versionchanged[La funzione \function{decode()} è stata rimossa; si utilizzi
+invece il metodo \method{Header.decode_header()}]{2.4}
+ 
+\versionchanged[La funzione \function{encode()} è stata eliminata; si uti al
+suo posto il metodo \method{Header.encode()}]{2.4}
+